从一件具体的事开始
artifact-graph 是底层运行时、CLI 与 Node 库，负责扫描制品、建图与校验。artifact-chain-assistant 是上层插件，把这套工作法接到 Codex、Claude Code 与 Kimi Code 的日常会话；Qoder 以技能兼容宿主复用同一套共享技能。第一次接触时，先完成下面的只读入口，再按角色选页。
当前插件源版本是 0.13.0。本地源版本不等于已发布或已安装版本；安装与配对以 INSTALL.md 和 compatibility.json 为准。
先跑起来 #
装好插件后，第一件事是只读查看 Family API（标准族接口）和采用步骤；拿不准该用哪个技能时，交给 artifact-chain-quickstart 分流。这两条都不会改项目文件。
操作提示词
请使用 artifact-chain-help 展示可用的 Family API 和采用步骤，不要修改项目。操作提示词
请使用 artifact-chain-quickstart，根据当前问题推荐正确入口，不要修改项目。环境不明时用 artifact-chain-setup 做只读体检。要把一个目标项目接进制品链，再经明确授权走 artifact-chain-bootstrap。
按角色选路径 #
- 新使用者：先读它是什么，再按场景剧本抄一条能完成的路径；卡住时查排错与兼容。
- 已在使用、要看原理：读架构原理、核心概念和方法注册表。
- 发版维护者：重点看维护者视角与路线图。路线图用状态区分已落地能力与未授权方向。
能力一览 #
| 页面 | 读完能做什么 |
|---|---|
| 双工程能力矩阵 | 对照常规研发做法与制品链做法 |
| 它是什么 | 判断这套工具解决谁的问题、两工程如何配合 |
| 架构原理 | 核对三层边界、Git 原生、关系锁与契约内核 |
| 核心概念 | 辨认制品类型、追溯边、上下文包与评审协议 |
| 命令参考 | 按 artifact-graph --help 查命令，不另造一份会过期的表 |
| 场景剧本 | 按六条常见任务完成第一次接入 |
| 方法注册表 | 理解 Family API 与 Registry 如何把能力落到实现 |
| 术语库 | 查阅本站反复使用的术语 |
| 维护者视角 | 把泄漏扫描、摘要锁和链接边界接进发布门禁 |
| 排错与兼容 | 先体检再按症状恢复 |
| 路线图 | 区分已实现、规划中与未授权方向 |
怎么读 #
不必按目录从头读到尾。先完成「先跑起来」，再从当前最痛的场景翻对应页：接项目看场景页，排错看排错页，原理看架构与概念页。各页自包含，跳读不会丢掉入口。
能力第一次出现会标明状态。已实现表示已有决策与代码；方向、未授权表示长期记录，不能当成现状；规划中表示增强路径已写下、方案仍待决策。