用途:该技能用于强制安全的重构纪律,流程为“测试通过→最小差异重构→测试再次通过→更新文档”,避免因未逐步运行测试而引入细微回归。适用场景:用户希望重构、重命名或重组代码时;diff 评审建议重构时;处理技术债务时;跨文件的提取、内联或重命名操作时。不适用于新功能开发,新功能应使用 implement-phase 或 scaffold。执行模型:由主智能体直接运行,因为重构需要文件编辑、测试运行和迭代验证;token 预算随范围变化,简单重命名约 3k,模块提取约 10-15k。工作流:第一步用 question 工具明确重构对象、目标与约束(行为不得改变);第二步运行相关测试建立基线,如 npm test(或 pytest、go test 等)并记录结果,若测试已失败须先停止修复测试;第三步识别依赖,用 grep 等查找所有导入或引用目标的文件,评估影响范围;第四步增量应用变更,每次做一个原子改动后运行测试验证,循环直至完成,不可在运行测试前做多个无关改动;第五步重构后验证,运行完整测试套件并与基线对比,检查新警告或弃用提示,运行 linter/类型检查;第六步更新文档,如模块结构、公共 API、文件位置(AGENTS.md 模块规则)或架构(考虑 ADR);第七步创建最小差异,用 git diff --stat 审查,确保无无关改动、无格式改动混入逻辑改动,提交信息清楚描述重构。规则:测试前后都必须通过;重构只改结构不改行为,行为变化属于新功能;增量修改;保持最小差异;记录重构动机;不使用内置 explore 子代理。资料未提供具体安装命令或价格信息。
refactor
编程与开发
更新于 10-15 21:42