SuperAPI AI 工具集

refactor-expert

编程与开发

查看项目

更新于 10-31 14:14

技能介绍

用途

refactor-expert 是一个供 AI 编程助手在执行过程中读取的重构技能参考,面向 Claude 使用。其目标是引导安全、渐进式的重构:改善代码质量,同时不改变程序行为。

主要能力

技能提供以下命令及其输出:

  • refactor:analyze <file>:输出到 .claude/logs/refactors/{target}-analysis.md
  • refactor:plan <file>:输出到 .claude/logs/refactors/{target}-plan.md
  • refactor: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:用于纯简化处理的配套技能

适用场景

适合在已有测试保障下对代码进行小步、可验证的质量改进,或需要按分析、计划、文档、性能、结构等方向组织重构工作时使用。

限制

资料未提供该技能的收费、价格、平台支持范围、具体安装命令或独立运行方式,这些信息暂未提供。技能本身不改变行为,也不应同时添加功能;缺乏测试时需先补测试。