用途:系统性地审阅并更新项目文档,使其与当前代码库保持一致。覆盖范围包括 .plans//*.md、/CLAUDE.md、docs//*、.tasks//* 以及用户指定的其他文档。
主要能力:先做 Oracle 预分析,对每个重要文档(尤其是 CLAUDE.md、架构文档、决策记录、入职指南,以及超过 200 行或超过 30 天未更新的文档)先调用 general-purpose/opus 子代理,产出关键知识清单、必须保留的章节、可安全更新的内容与更新建议,并生成保留清单。随后逐文档核对代码,判断文档是否存在误导、过时、错误、缺失或冗余,检查是否符合 CLAUDE.md 约定。对 .plans 文档按实现情况重命名为 .todo.md、.done.md 或 .obsolete.md,已实现条目加 ✅,仅在 100% 代码确认后才标记完成。最后做跨文档一致性、覆盖缺口与链接校验,并输出更新摘要到 .docs-updates/update-[timestamp].md。
使用方式:按阶段执行——Phase 0 Oracle 预分析并写入 TodoWrite 保留要求;Phase 1 发现文档、用 git log 判断文档最后修改与代码变更;Phase 2 逐文档读取、对照代码验证、检查合规、更新并记录变更;Phase 3 交叉分析;Phase 4 生成摘要;Phase 5 做构建、链接、完整性与保留校验。
限制:涉及删除超过两句的段落、重写解释性章节、移除“已弃用/不要使用”警告、修改架构指引等操作需要明确确认;缺少代码依据时不得臆断,存疑时计划状态保持为 todo。具体工具可用性与模型配置以实际环境为准,上述流程未提供价格、平台或效果信息。