用途
Refactoring Assistant 是一个应用于 Claude Code Skills 的技能,用于指导重构决策和大规模代码改进。它适用于重构代码、遗留系统现代化、技术债治理以及决定重写还是重构等场景。技能以决策框架的形式组织内容,而非特定语言的实现细节。
主要能力
决策框架
- 重构与重写的决策树,依次询问:代码是否在生产环境、是否理解代码行为、测试覆盖率是否超过 60%、核心架构是否可挽救,并据此给出建议。
- 对比矩阵:倾向重构的情形包括大型代码库、测试良好、业务关键、团队熟悉代码、架构健全、时间紧张、风险低;倾向重写的情形包括小型隔离模块、无测试、可容忍停机、无人了解、架构有缺陷、时间灵活、风险较高。
- 重写反模式警告“第二系统效应”,列出添加原系统没有的功能、为未来灵活性过度抽象、忽视既有系统教训等问题。
战术层(日常重构)
- 预备性重构:先让变更变容易,再做容易的变更;步骤为确定想要的变更、确定障碍、重构消除障碍、实施变更。强调预备性重构与功能提交分离、每步保持测试通过、不把重构与功能开发混在一起。
- 童子军规则:机会式重构,只做分钟级的小改进,不改变行为、不破坏测试、保持范围在当前任务内;示例包括重命名易混淆变量、提取方法、删除死代码、添加澄清注释;反模式包括把缺陷修复变成大重构、重构无关代码、无测试覆盖的改动、超出原任务范围。
- 红-绿-重构:TDD 的重构阶段,每轮 5–15 分钟,范围限于单个方法或类,技术包括提取方法、重命名、内联变量、替换魔法数字。
战略层(架构级重构)
- 绞杀者模式:通过路由逐步以新系统替换遗留系统,分为拦截、迁移、完成三个阶段,并附带检查清单。
- 防腐层:防止遗留模型污染新系统的翻译层,包含门面、适配器、翻译器组件,附检查清单,并区分其与绞杀者模式的目标(共存 vs 替换)。
- 按抽象分支:客户端 → 抽象接口 → 旧实现,再过渡到新旧实现并存,最后切换到新实现并移除旧实现;原则包括主干开发、特性开关、过渡期共存。
- 平行变更(扩展-迁移-收缩):扩展阶段新旧并存,迁移阶段更新所有调用方,收缩阶段移除旧实现。
安全层(遗留代码)
- 遗留代码定义:没有测试的代码(不论新旧)。
- 特征测试:记录代码实际行为而非正确行为,流程为调用理解、写预期失败的断言、运行观察实际结果、更新断言、重复直至覆盖。
- 草稿重构:在草稿分支激进重构以理解代码,记录心得后丢弃改动,再据此编写特征测试。
- 接缝:对象接缝(多态注入测试替身)、预处理接缝(宏替换)、链接接缝(依赖注入、模块替换)。
- 萌芽与包装:萌芽方法、萌芽类、包装方法、包装类,原则是新代码用 TDD,遗留代码在测试覆盖前不改动。
数据库重构
- 扩展-收缩流程:扩展阶段添加新列/表并双写、可安全回滚;迁移阶段复制数据、校验一致性、应用改读新结构;收缩阶段确认旧结构未使用后移除。
- 场景与风险:重命名列(中风险)、拆分表(高风险)、合并表(高风险)、更改数据类型(中风险)、添加非空约束(低风险)。
工作流、指标与技术债
- 安全重构工作流:重构前定义成功标准、覆盖率>80%、干净工作区、创建分支、沟通;重构中一次一个小改动、每次改动后测试、失败即回退、频繁提交、不新增功能;重构后所有测试通过、可衡量地更好、文档更新、团队评审、不新增功能。
- 代码质量指标:圈复杂度<10/函数、认知复杂度越低越好、降低耦合、提高内聚、重复率<3%。测试质量指标:覆盖率≥80%且不下降、重构后更快、不稳定测试数量减少。
- 技术债四象限(Martin Fowler):审慎-有意、鲁莽-有意、审慎-无意、鲁莽-无意。优先级:高(阻碍开发、频繁缺陷,立即处理)、中(拖慢开发、增加复杂度,下个 sprint 处理)、低(轻微困扰、孤立,机会式处理)。跟踪字段包括描述、影响、预估工作量、忽略风险、相关代码。
策略选择指南
- 功能被混乱代码阻塞 → 预备性重构
- 修缺陷时顺手清理 → 童子军规则
- 用 TDD 写新代码 → 红-绿-重构
- 替换整个遗留系统 → 绞杀者模式
- 集成而不污染 → 防腐层
- 在主干重构共享代码 → 按抽象分支
- 变更广泛使用的接口 → 平行变更
- 处理无测试遗留代码 → 先做特征测试 + 草稿重构
使用方式
该技能以 Claude Code Skills 形式提供,语言为英文和繁体中文,版本 2.0.0,最后更新于 2026-01-21。配置检测顺序为:先检查 CONTRIBUTING.md 中的“Disabled Skills”章节,再检查“Refactoring Standards”章节,若未找到则默认采用标准重构实践。资料未提供具体安装命令或平台运行要求。
适用场景
适合需要在重构与重写之间做判断、规划大规模架构迁移、处理无测试遗留代码、管理技术债与数据库结构变更的团队与开发者。
限制
资料仅提供该技能的策略框架与配置检测方式;具体安装命令、价格、计费方式、平台支持范围以及其他未在资料中出现的信息暂未提供。相关标准文档(Refactoring Standards、Test-Driven Development、Code Review Checklist、Checkin Standards、TDD Assistant)以引用形式提及,内容未在此展开。