它是什么
一句话：这是一套让助手写出来的研发产物能追溯、并让机器判断链路是否首尾相接的工具与方法。它处理一个很具体的缺口——助手说「做完了」，与链路真正接上之间，常常隔着一层无法自动验证的空隙。
查看操作提示词先看它能做什么 #
不必先读完原理。插件装好后，第一件事是跑 artifact-chain-help。它只读列出当前可见的 Family API 和采用步骤，也就是接下来能用的能力清单。
操作提示词
请使用 artifact-chain-help 展示可用的 Family API 和采用步骤，不要修改项目。拿不准从哪下手时，改用 artifact-chain-quickstart。要把目标项目接进来，再经授权走 artifact-chain-bootstrap。
解决谁的问题 #
- 使用者：要把「需求 → 场景 → 设计 → 实现 → 评审」串成可验证图，不愿只靠人记关系。
- 维护者：对外发开源时，要守住许可证、NOTICE 与私有边界。
- 助手：需要以稳定、机器能消费的方式拿到上下文和评审结果协议。
两个工程是什么关系 #
artifact-graph 是底层：Git 原生的 Markdown 制品图扫描与校验器（命令行 / Node 库）。artifact-chain-assistant 是上层：Codex、Claude Code 与 Kimi Code 插件，把底层能力接到日常会话；Qoder 复用共享技能，不承诺命令包装或 Stop hook 等价。
| 层 | 角色 | 状态 |
|---|---|---|
| 通用图内核多领域拆分 | 不加载领域默认值的长期方向 | 方向，未授权 |
artifact-graph | 确定性图能力：配置、扫描、索引、边、查询、校验、版本锁 | 已实现 |
artifact-chain-assistant | 通用助手：profile、模板、bootstrap、maintainer、适配器、hook | 已实现 |
和「只写文档 / 只跑 CI」差在哪 #
| 做法 | 它做到什么程度 |
|---|---|
| 只写文档 | 关系靠人记，机器验不了；制品链把关系变成图与边 |
| 只跑 CI | 校验代码对不对，不校验「为什么做」这条链有没有接上 |
| 制品链 | 文档即图、图即约束、锁即提交边界；助手产出要经过失败关闭的评审协议 |
已经落地的能力 #
- 契约内核：运行时侧一组稳定契约接口，上层统一调用图能力。
- 标准 Family API：一类制品的通用操作抽象成标准族，新类型靠配置接入。
- Registry（方法注册表）公共接口：身份、清单、绑定、投影与方法选择；助手按已锁定版本接线，不复制实现身份。
doctor/artifact-chain-setup：接入之后的环境自检第一步。
判断是否需要它，看三条是否同时成立：助手参与写研发产物；要求「做完」能被机器验证；接受 Git 作为唯一事实来源。