用途:为仓库安装一套项目“表面”,使后续每次会话、每位协作者(无论是否使用 manifest-dev)都基于同一套词汇与决策记录工作。安装分两部分,只有第一部分是必需的。
接线(必需):安装项目自有的 ADR 约定文件、术语表,以及在项目上下文文件中加入一节,使会话读取并维护这两者。任何项目都适用,包括完全没有历史的项目。
种子(可选):从项目自身历史中重建词汇与决策记录。仅在存在可读历史时运行,属于接线的增强而非替代。目标是好的起点而非完整记录;对无法恢复的内容如实说明,比看似完整实则虚构更有价值。
标志:--no-mine 跳过种子,只安装接线。仅顶层选项按标志解析,被引用或代码格式化的提及视为正文。
已存在者优先:写入前先读取,绝不覆盖项目已维护的表面。docs/adr/CONVENTIONS.md 已存在则遵循它并跳过约定步骤;CONTEXT.md(或根 CONTEXT-MAP.md 指定的上下文)已存在则加载,挖掘出的词汇作为补充而非替换;docs/adr/ 有记录但无 CONVENTIONS.md 时,从记录推断既有约定并据此撰写,而非直接套用默认;上下文文件已含部分接线则只补缺失部分。
运行流程:解析项目上下文文件名(CLAUDE.md、AGENTS.md 或其他,需检测而非假定,检测表见 ../review-code/references/context-file-adherence.md);安装 ADR 约定(将 ../figure-out/references/ADR_FORMAT.md 复制为 docs/adr/CONVENTIONS.md,仅改标题为 # ADR Conventions、保留 ADR 说明句、用一段话替换自包含说明与整个 ## Precedence 节,其余从 ## When a decision deserves a record 起原样保留);除非 --no-mine,按 references/MINING.md 播种;在上下文文件中加入仅含三件事的一节(术语表常驻并指示会话开始时读取、何时打开决策记录、写记录是一个动作);按 MINING.md 的 Reporting 节报告结果。
空输入:对无提交、无文档、无代码的仓库,只安装接线并停止,说明因无内容可播种而未播种;缺少项目名或用途时需询问。
限制与注意:代码库名词无限,术语表每次会话都被读取,应刻意少产;丰富历史并非常态,勿以个别文档完善的提交校准目标;重建的推理是失败模式,丢失理由时只记录决策而不编造理由;不要在上下文文件中复述约定细节,以免每次会话付出成本并产生漂移。