用途:对照计划文件审计实现进度,验证已完成工作的质量,找出剩余任务,并生成可执行的待办清单。适用于用户要求检查计划状态、确认实现是否完成或评估质量的场景。
主要能力:分阶段执行审计。先定位 .plans/ 下的计划文件,结合 git status、git diff、git log --oneline -20 了解改动范围,列出所有受影响文件。随后逐文件阅读,将文件映射到计划步骤,标记为 DONE、PARTIAL、NOT DONE 或 NEEDS REVIEW,并检查正确性、类型(避免 any)、命名、架构与完整性。
关键环节:验证 REMOVAL SPEC,用 grep 确认旧代码、旧文件、废弃引用是否真正移除,未移除项列为高优先级。强制核对原始 issue/任务需求覆盖率,覆盖率不足 100% 即视为计划未完成。之后做差距分析,识别范围蔓延与遗漏工作,计算完成百分比,在 .plans/[plan-name].progress.md 生成结构化报告。
验证与输出:运行 npm run typecheck 或 tsc --noEmit、npm run lint 或 eslint .、npm run build,记录结果并生成按优先级排列的剩余任务清单,最后向用户汇报状态。
限制:这是只读审计,不编辑文件;不跳过任何文件;计划只有在原始需求 100% 实现、所有计划步骤完成、REMOVAL SPEC 全部移除、类型检查与 lint 通过、构建成功、无新增 any 类型且符合 CLAUDE.md 时,才可从 .todo.md 改为 .done.md。具体命令与工具依赖项目配置,资料未提供其他平台或收费信息。