用途:在不改变外部行为的前提下重构既有代码,提升可读性、可维护性与性能。适用于单模块或单文件重构、模式应用(如提取方法、引入接口)、测试重构、数据管道重构,以及有测试覆盖保障的安全重构。
主要能力:识别代码坏味道,包括超过50行的方法、超过300行的类、重复代码块、高圈复杂度、魔法数字与字符串字面量、超过3层的深层嵌套、特性依恋、霰弹式修改、数据泥团和基本类型偏执。可套用代码组织模式(提取方法/类、移动方法/字段、内联、重命名)、结构模式(以多态替换条件、引入参数对象、以常量替换魔法数字、分解条件)、测试重构模式(提取测试夹具、测试数据构建器、替换断言轮盘、提取测试辅助)和数据管道模式(提取转换、引入管道接口、以阶段替换内联处理)。
使用方式:先用 Grep/Glob 搜索模式,例如 rg "^(\s*)(def|function|fn|func)\s+\w+" --after-context=60 查找长函数,rg --multiline "pattern.*\n.*pattern" 查找重复代码,rg "\b\d{2,}\b" --type=py --type=js --type=rs 查找魔法数字。随后规划重构:验证测试覆盖、列出变更顺序、识别依赖、规划回滚点、检查影响范围。执行时每次只做一处重构,运行测试,提交检查点,再继续。若测试失败立即用 git checkout 回退。提交信息格式如 refactor: extract calculate_discount from process_order。最后验证所有测试通过、无功能回归、性能未退化、覆盖率保持或提升、lint 与构建通过。
限制与注意:无测试覆盖、影响有外部消费者的公共 API、所有权不清或多团队参与、性能关键热路径属于需升级处理的红旗。测试意外失败、范围超出计划、架构影响不明、出现性能或安全顾虑时应停止重构,提交当前进度并记录剩余工作。代理选择上,所有重构工作使用 senior-software-engineer(Opus),仅机械重命名或按既定模式的样板代码使用 software-engineer(Sonnet)。