用途:对照计划工单审计实现进度,验证已完成工作的质量,识别剩余任务,并生成可执行的待办清单。适用于用户要求检查计划执行情况时。
主要能力:分阶段执行审计。先定位计划(用 tk show <ticket-id> 读取,tk list --tag plan 搜索),结合 git status、git diff、git log --oneline -20 了解改动范围,列出所有受影响文件并建立待办。随后逐文件审计:读取文件、映射到计划条目、判定 DONE/PARTIAL/NOT DONE/NEEDS REVIEW,并检查正确性、类型(避免 any)、命名、架构与完整性。
关键环节:验证 REMOVAL SPEC,确认旧代码、旧文件、废弃引用确实被删除(用 grep、ls、grep -r 检查);强制核对原始 issue/任务需求覆盖率,覆盖率不足 100% 即视为计划未完成。之后做差距分析(范围蔓延、缺失工作、需求覆盖缺口),计算完成百分比,生成结构化进度报告,并可用 tk add-note <ticket-id> "<progress>" 写入工单。
验证与收尾:运行 npm run typecheck 或 tsc --noEmit、npm run lint 或 eslint .、npm run build,记录结果并生成分级任务清单;全部完成后用 tk close <ticket-id> 关闭工单。
限制与原则:这是只读审计,不编辑文件;必须检查每个文件,如实标记未完成项,并始终运行类型检查与 lint。计划只有在原始需求 100% 实现、所有计划步骤完成、REMOVAL SPEC 全部移除、类型检查与 lint 通过、构建成功、未新增 any 类型且符合 AGENTS.md 时,才可标记为 .done.md。资料未提供具体收费、平台支持范围等信息。