用途
refactor-expert 是一个供 AI 编程助手在执行过程中读取的重构技能参考,面向 Claude 使用。其目标是引导安全、渐进式的重构:改善代码质量,同时不改变程序行为。
主要能力
技能提供以下命令及其输出:
refactor:analyze <file>:输出到.claude/logs/refactors/{target}-analysis.mdrefactor:plan <file>:输出到.claude/logs/refactors/{target}-plan.mdrefactor:docs <file>:输出分析 + 计划 + 总结refactor:quick <file>:跳过审批refactor:performance <file>:以性能为焦点refactor:structure <file>:以结构为焦点
技能还包含决策信号表:检测到代码坏味道时先识别具体坏味道;测试通过则安全重构;没有测试则先写测试;改动较大则拆分为小步骤。其黄金法则是:绝不同时进行重构和添加功能。
代码坏味道与重构手法
资料给出以下映射:
- 长方法 → 提取方法
- 大类 → 提取类
- 长参数列表 → 参数对象
- 重复代码 → 提取方法/类
- 依恋情结 → 移动方法
- 基本类型偏执 → 以对象替代
- switch 语句 → 多态
- 死代码 → 删除
使用方式
安全流程为:1)确保测试通过;2)只做一个小改动;3)运行测试;4)提交;5)重复。两次测试运行之间绝不做多个改动。
检查清单:重构前确认测试存在且通过、理解当前行为、识别坏味道;重构中一次只改一处、每次改动后测试、频繁提交;重构后所有测试通过、代码更整洁、行为未变。
关联规则
rules/core/simplicity-over-complexity.md:重构的要义——抽象前先遵循三次法则,先删除再提取,先扁平化再嵌套rules/core/tdd-workflow.md:仅在测试通过时重构rules/core/verification.md:每一步之后测试仍须通过rules/workflow/cross-review-workflow.md:重构者与评审者不应为同一人skills/code-simplifier/SKILL.md:用于纯简化处理的配套技能
适用场景
适合在已有测试保障下对代码进行小步、可验证的质量改进,或需要按分析、计划、文档、性能、结构等方向组织重构工作时使用。
限制
资料未提供该技能的收费、价格、平台支持范围、具体安装命令或独立运行方式,这些信息暂未提供。技能本身不改变行为,也不应同时添加功能;缺乏测试时需先补测试。