用途:在任务评审通过后执行收尾性代码清理,让代码达到可交付状态。该流程已集成到 /developer-kit-specs:specs.task-implementation 的 Phase T-7,也可通过 --action=cleanup 手动调用。输入为 docs/specs/[id]/tasks/TASK-XXX.md(状态为 reviewed),输出为清理后的代码并将任务标记为 completed。
主要能力:移除调试日志(如 console.log、System.out.println、print()、临时注释(// DEBUG:、// temp、// hack)以及已解决的 TODO/FIXME;优化导入;运行语言相关格式化工具;改善可读性;仅在明显安全时删除死代码;校验文档与注释;运行 linter 与测试;最后在任务文件中追加 Cleanup Summary 并更新状态。
使用方式:参数包括 --lang(可选,支持 java、spring、typescript、nestjs、react、python、general)、--task(必填,任务 ID 或文件路径)、--action(手动调用时设为 cleanup)。任务路径支持直接路径,或 --spec 加 --task 组合。示例:/developer-kit-specs:specs.task-implementation --lang=spring --task="docs/specs/001-user-auth/tasks/TASK-001.md" --action=cleanup。
适用场景:评审通过后准备交付、清理技术债、作为规范驱动开发流程的最终质量关卡。
限制:不用于重构逻辑或修复缺陷,仅做外观与卫生清理;清理过程中不得改变功能或签名;若测试失败须立即停止并报告;优先使用项目自带工具,如 ./mvnw spotless:apply、npm run lint:fix、black 等。具体语言格式化命令与导入排序规则见 references/language-patterns.md。