用途:在不改变代码外部行为的前提下改进代码结构与可读性,属于渐进式演进而非重写,适用于改善既有代码。
主要能力:识别并处理常见代码坏味道,如长方法、重复代码、过大类、过长参数列表、特性依恋、基本类型偏执、魔法数字/字符串、嵌套条件、死代码、不当亲密关系,以及策略、职责链等设计模式示例。提供按坏味道分类的 BAD/GOOD 目录、提取方法、类型安全与重构操作速查表,位于 references/catalog.md。
使用方式:当代码难以理解维护、函数或类过大、需要处理代码坏味道、因结构问题难以加功能,或用户要求清理/重构/改进代码时使用。安全流程为:准备(确保有测试、提交当前状态、建分支)、识别(定位坏味道、理解代码、制定计划)、重构(每次小改动后跑测试,通过则提交,重复)、验证(测试全过、必要时手动测试、性能不降)、清理(更新注释与文档、最终提交)。
原则:保持行为不变;小步前进;善用版本控制;测试必不可少,无测试则只是编辑而非重构;一次只做一件事,不混入功能变更。
限制:不适用于不会再改的可用代码、无测试的关键生产代码(应先补测试)、紧迫截止期,以及没有明确目的的重构。具体命令与完整代码示例资料未提供。