用途:提供系统化、安全的代码重构指导,改善既有代码内部结构而不改变外部行为,适用于代码质量提升、技术债清理、可维护性改进与代码优化。当用户请求重构代码、优化质量、修复代码问题或清理技术债时触发。
主要能力:识别代码坏味道(如重复代码、过长函数、过大类、过长参数列表、数据泥团、特性依恋、复杂Switch语句等)并标注位置、类型与优先级;为坏味道匹配重构手法(提取方法、提取超类、提取类、引入参数对象、移动方法、以多态取代条件表达式等);输出重构计划,包含位置、问题、方案、重构前后代码片段与参考规则;按六步流程执行:确保测试覆盖、识别坏味道、选择手法、小步执行、审视优化、验证行为一致性;最后输出重构报告,含摘要、详情、验证结果、效果对比与后续建议。
使用方式:先输出重构计划再执行;遵循先测试后重构、小步前进、保持行为不变、持续验证、风格符合项目规范等原则。无测试环境时可跳过测试执行,但须告知回归风险,改用静态检查(linter、类型检查器如 mypy、eslint、staticcheck)、代码审查、编译验证,并在报告中标注未执行测试验证,列出待验证用例,建议后续补测,提供回滚方案(如 git revert)。
参考资源:项目代码风格规范含 C++、Python、Go 编程规范;重构知识参考含 22 种坏味道详解与 25 种重构手法。
限制:资料未提供具体安装命令、平台支持、收费方式与效果数据;测试覆盖率建议大于70%,坏味道与手法清单以资料所列内容为准。