用途:spec 是项目规格文件 SPEC.md 的唯一变更者,负责创建、修订规格,以及把缺陷回填进规格。其他技能只产出素材,由 spec 写入。
主要能力与分派:根据用户请求和项目状态选择模式。仓库根目录无 SPEC.md 且参数描述想法时进入 NEW;无 SPEC.md 且参数含 from-code 时进入 DISTILL;SPEC.md 存在且参数以 bug: 开头时进入 BACKPROP;以 amend 开头时进入 AMEND;SPEC.md 存在但无参数时询问用户选择模式。
输入整合:接收其他技能的交接块并写入对应章节,写入前展示 diff,用户确认后才落盘。grill 产出 §G 与 §C;research 产出 §R 行(无该章节则新增);review 产出 §V 草稿与风险结论;deepen 产出 §I/§V/§T 修订。不得重写交接块未指定的章节,章节归属见 FORMAT.md。
各模式要点:NEW 从想法提取目标写入 §G、约束写入 §C、外部接口写入 §I,仅在运行过 research 时写 §R,提出编号不变量写入 §V,把目标拆成有序任务写入 §T 表格(状态均为 .,编号 T1 起),§B 仅保留表头。DISTILL 遍历仓库,从 README/package.json/主入口推断 §G,从技术栈推断 §C,枚举公开 API/CLI/配置写入 §I,从测试与断言推导 §V,为已知 TODO 或缺失测试各建一条 §T,§B 留空,不确定项以 ? 标注。BACKPROP 解析缺陷描述、定位根因,判断新不变量能否防止复发,追加 §B 行(B<next>|<date>|<cause>|V<N>)并追加不变量,若修复改变行为则增改 §T 行,展示 diff 后经用户确认才应用;每个缺陷都要有 §B 条目,不变量可选但优先。AMEND 读取指定章节、展示现状、询问改动、写入并展示 diff,绝不静默重写未指定章节。
输出规则:按 FORMAT.md 的 caveman 格式;标识符、路径、代码原样保留;编号单调递增,§V.N 与 §B.N 不得复用;§T 行用 ! 列引用 §V/§I 依赖,如 T5|.|impl auth mw|V2,I.api。
限制:不使用子代理,由主线程写入;除 SPEC.md 外不产生仪表盘、日志或状态文件;规格完成后不自动构建,需用户显式调用 build。首次使用需读取仓库根目录的 FORMAT.md。