用途:在合并后或一次构建结束时,把项目文档与代码现状对齐。close-session 对账的是会话与记忆,code-sync 对账的是项目文档与代码:规格中仍存在的每条声明,都要对照当前代码树核实。
主要能力:
- 定位项目:Glob projects/*/README.md;若文档在别处,读根目录 CLAUDE.md / README.md 指定的文档位置。找不到就说明并停止,本技能不搭建脚手架。
- 从每个项目 README 读取文档映射表与 Workflow tier 行,tier 决定 done 所需证据:prototype 需你亲自运行的 gate 输出;alpha 另需 Verified 单元格中命名的集成验收走查;beta 另需 qa/qa-run-*.md 记录与命名各 AC-n 的测试;ga 另需评审通过和变更的文档条目。
- 盘点规格:读取 plans/*.md 头部(Created、Status),状态为 draft、decided、building、done、superseded、assumed、stale;无状态行按无状态计数,不猜测。
- 对 building 规格逐条 AC 找证据,顺序为:已填的 Verified 单元格、命名该 id 的 QA 记录、命名该 id 的测试、亲自运行规格 ## Gates 块中的命令。全部有证据才置为 done 并填写你挣得的 Verified 单元格;代码与规格矛盾则置为 stale 并追加一行 Stale since;否则保持 building 并说明缺什么。
- 列出 assumed 规格的待批准议程,不自行翻转或编辑。
- BACKLOG.md 仅在 Spec 指向本次翻为 done 的规格且验收框全部勾选时,才把任务移入 Done。
- 为磁盘上已有文件但映射表缺行的文档类补行,并更新 Last verified。
- 输出四行报告:Headline、Next、Heads up、Pointer。
使用方式:以 --dry-run 运行,或用户说“just show me”“покажи, не трогай”时,走完全流程并运行 gate(读取不算写入),但以表格(file · line · from → to)打印编辑计划而不应用,连 Last verified 也不写,最后给出正式运行命令。
限制:只允许写六类内容——状态值、Verified 单元格、一行 Stale since、映射行、Last verified、BACKLOG Done 行;不重写正文或整节,不凭声明标记 done,不翻转或编辑 assumed 规格,不触碰 .claude/memory/MEMORY.md、context/handoffs/、knowledge/、.claude/rules/,不创建文件,不删除文档,不碰 draft、decided、done、superseded 规格。