双工程能力矩阵
这一页是理解支点。左侧是常规研发已经在做的事，右侧是同一件事在制品链范式下的做法。学习重点落在差异：右侧多出来的约束，用来处理「助手宣称完成、链路其实断着」的问题。
两个工程分别管什么 #
| 维度 | 常规做法 | 制品链做法 | 归属 |
|---|---|---|---|
| 图能力 | 文档之间靠人记关系，没有工具校验 | 配置读取、制品扫描、索引、边关系、查询、校验、版本锁 | artifact-graph（底层运行时 / CLI） |
| 助手能力 | 编辑器补全、零散脚本 | profile、模板、bootstrap、maintainer、where-am-i、宿主适配器、hook 指导 | artifact-chain-assistant（上层插件） |
| 事实来源 | 散在 wiki、脑图或口头约定 | 单一 Git 仓库，Git 原生即事实来源 | 两者共用 |
| 结果可信度 | 「改完了」靠人判断 | 评审结果协议：默认失败关闭、身份稳定、禁止自我接受 | 两者共用 |
安装与运行对照 #
| 环节 | 常规 | 制品链 |
|---|---|---|
| 安装 | 未锁定范围的工具依赖 | 按 INSTALL.md 与 compatibility.json 安装已验证的精确 artifact-graph，禁止未锁定范围 |
| 构建 | 各自 CI 脚本 | pnpm 10 会拦下原生构建，必须显式允许 better-sqlite3 |
| 校验 | 单测 / lint | artifact-graph validate 与 version-lock audit |
| 初始化 | 手写配置 | artifact-chain-bootstrap 引导；context.universal_baseline 默认开启，未设好时第一次取上下文会非零退出 |
| 安全第一步 | 常被跳过 | artifact-chain-setup 与 artifact-graph doctor 只读体检 |
先看清当前项目位置 #
不必读完整站。下面两条只读请求用于查看 Family API 与环境位置。
操作提示词
请使用 artifact-chain-help 展示可用的 Family API 和采用步骤，不要修改项目。操作提示词
请使用 artifact-chain-setup 检查制品链环境是否就绪，不要修改项目。拿不准下一步时走 artifact-chain-quickstart。正式把目标项目接进来，再授权 artifact-chain-bootstrap。
边界对照 #
| 常见误解 | 实际边界 |
|---|---|
| 替业务写实现代码 | 不管。它管产出是否可追溯、可验证 |
| 当成普通依赖 lockfile | 不是。version-lock 锁的是追溯关系，同时也是一次提交的事务边界 |
| 当成又一个文档站生成器 | 不是。知识站只是发布阅读面；工具本身产出图与锁 |
| 重组制品靠助手直接改文件 | 不是。语义决定留在技能层，文件集合写入由 restructure 确定性执行，且需操作者确认 |
重组能力写在哪一层 #
| 维度 | 制品链做法 | 归属 |
|---|---|---|
| 语义决定 | 功能边界、共同约束、验收项去向、关系迁移 | 技能层（artifact-chain-restructure） |
| 确定性执行 | 检查、候选计划编译、文件集合应用与恢复 | artifact-graph restructure |
| 独立复审 | 只读核对候选与映射，结论绑定被复审的候选 | 技能层 |
| 写入前提 | 操作者显式确认合作式写者；恢复需显式双维护确认 | 操作者，机制不自证 |
采用边界要一并说清，否则容易把候选能力当成已发布保证：
- 写入能力成熟度为
candidate，资格环境仅为 Darwin / arm64 / APFS；其他平台返回不可用， 不降级到无事务写入，也不承诺全平台事务保证。 - 前提是合作式写者。
apply与prune-recovery缺少--confirm-cooperative-writers即拒绝；recover缺少停止与独占维护两个确认即返回MAINTENANCE_CONFIRMATION_REQUIRED。 - 恢复材料默认保留，只有显式
prune-recovery才清理。 - 孤儿锁默认保留；清理要么整体
--remove-orphans，要么按边精确--remove-orphan-edge <edgeId>，两者互斥。
把下面三条同时成立，才值得引入制品链：助手参与写研发产物；「做完」需要被机器验证；接受 Git 作为唯一事实来源。任一条件不成立，继续用现有文档与 CI 即可。