重构专家（refactoring-expert）：不改变外部行为，系统性消除代码异味
- 定位清晰：这是一个专注「代码重构」的 AI 技能，核心承诺是只改结构、不改行为，用经验证的重构手法消除代码异味。
- 六类异味全覆盖：长方法、重复代码、特性嫉妒、魔法数字、复杂条件、长参数列表等常见问题，都有对应的检测命令与重构技术。
- 安全流程内置：强制「先有测试 → 小步修改 → 跑测试 → 通过再提交 → 循环」的节奏，避免大爆炸式重构。
- 可验证的指标：圈复杂度 < 10、方法行数 < 20、参数 ≤ 3、类 < 200 行、嵌套 ≤ 2 层，重构效果能被量化检查。
- 懂边界：遇到性能、类型系统、测试、数据库、构建配置等超纲问题，会主动建议转交对应领域专家，而不是硬撑。
1. 该技能叫什么？如何一键安装 AI 技能提升开发效率？
技能基本信息
| 项目 | 内容 |
|---|---|
| 中文名 | 重构专家（重构专家Skill） |
| 英文名 | refactoring-expert |
| 技能 ID | 11746 |
| 技能类别 | general（通用类） |
| 声明工具 | Read、Grep、Glob、Edit、MultiEdit、Bash |
它解决什么问题？
真实项目里最耗时间的往往不是「写新功能」，而是「改不动旧代码」：一个方法两百行、条件判断嵌套五层、同一个校验逻辑复制了七八处、满屏魔法数字。人工梳理这类问题既慢又容易改出 Bug。重构专家Skill把「识别代码异味 → 选择重构手法 → 小步改造 → 验证行为未变」这套资深工程师的肌肉记忆固化成一个可随时调用的技能，让 AI 按标准流程而不是凭感觉改代码。
「一键安装」的思路与步骤
这个技能的安装形态属于「技能包 / 子代理」类，把一份技能说明文件放到 AI 编程环境可识别的技能目录即可被调用。具体步骤如下（安装源、命令与目录以官方说明为准）：
- 确认前提：你的 AI 编程环境需要支持技能（Skill）或子代理（Agent）机制，并且已经为该技能开放文件读写与命令执行权限——本技能声明使用 Read、Grep、Glob、Edit、MultiEdit、Bash 六个工具，缺一不可，否则无法读取代码、无法跑测试。
- 获取技能包：从官方技能市场或官方仓库获取 refactoring-expert（技能 ID 11746）的技能文件，具体获取入口与安装命令以官方说明为准。
- 放入技能目录并启用：将技能文件安装到环境的技能目录，然后在会话中启用该技能（不同客户端的启用方式不同，以官方说明为准）。
- 验证是否生效：在项目里随便挑一个「看着别扭」的文件，让它分析，例如输入「请按重构专家流程扫描 src 目录，列出代码异味清单，先不要改代码」。如果它能先检测项目结构（如是否存在 package.json、tsconfig.json、.eslintrc.json、jest.config.js、vitest.config.js），再输出分类的异味清单，就说明安装成功。
- 小范围试跑：第一次真正动手时，只让它重构一个方法，并先确认测试能跑通，再逐步扩大范围。
2. 该技能的主要功能和特点
- 系统化异味检测：把代码异味归纳为六大类——组合方法、在对象间移动特性、组织数据、简化条件表达式、简化方法调用、处理泛化，每类都给出典型症状与对应重构手法，避免「凭直觉改」。
- 自带检测思路：技能内置了大量基于 grep 的检索方式，例如查找超过 20 行的长方法、查找类似
a.getB().getC().doD()的消息链、查找多位魔法数字、查找 4 个以上参数的函数、统计 switch 语句分布等，能在读代码之前先做一轮客观扫描。 - 重构手法成体系：提取方法、内联方法、提取变量、以查询替换临时变量、以对象替换数据值、以常量替换魔法数字、用守卫子句替换嵌套条件、用多态替换条件、引入参数对象、上拉/下拉方法、用委托替换继承等，都是业界有名字、可复用的标准动作。
- 安全重构五步法：确保测试存在 → 一次只做一个重构 → 运行测试 → 通过则提交 → 重复。把「保证行为不变」写进流程，而不是当作口号。
- 重构优先级矩阵：先判断「代码是否损坏」（先修 Bug 再重构）、「是否难以更改」、「是否难以理解」、「是否有重复」，以此决定高/中/低优先级，避免在无关紧要的地方过度打磨。
- 代码审查清单：方法质量、对象设计、数据结构、控制流、常见反模式五组勾选项，可直接当作 Code Review 的检查表使用。
- 专业领域路由：当任务涉及性能瓶颈、类型系统、测试重构、数据库模式、构建配置时，会明确建议转交对应领域专家并使其中断，避免越界给出不可靠方案。
- 可量化的质量标准：圈复杂度 < 10、每方法行数 < 20、每方法参数 ≤ 3、类 < 200 行、条件嵌套 ≤ 2 层、高内聚低耦合。
和普通工具相比强在哪？ESLint 这类工具能告诉你哪里超标，但不会帮你怎么改；IDE 重构菜单能执行一次重命名或提取，但不会规划重构顺序并验证行为。重构专家Skill补的正是「判断 + 手法 + 验证节奏」这一段。
3. 如何使用该技能？
第一步：唤起技能并说明意图
用自然语言描述目标即可，例如：「使用重构专家，重构 src/order.js，目标是让它更好维护，行为不能变。先只做分析，别改代码。」
第二步：让它先摸清项目约定
技能会先检查项目类型与工程化配置，例如是否为 Node.js 项目、是否 TypeScript、是否配置了 ESLint、测试框架是 Jest 还是 Vitest。这一步决定后面用什么命令验证。
第三步：输出异味清单，人工确认优先级
它会按类别列出问题，例如「processOrder 超过 40 行且承担校验、计算、折扣三件事」「getSpeed 使用 switch 按类型分支，适合多态化」「createAddress 有 5 个参数，建议引入参数对象」。此时你应当确认：哪些是高优先级（难以更改的），哪些先放着。
第四步：逐个重构，一次只改一处
典型对话：「先做第一个重构：把 processOrder 里的校验逻辑提取成独立方法，改完立刻跑测试。」
以技能中的示例为例，改造前是一个「校验 + 累加 + 打折」混在一起的方法，改造后变成三段清晰的调用：
// 改造后：单一职责，一眼看懂
function processOrder(order) {
validateOrder(order);
const subtotal = calculateSubtotal(order.items);
return applyDiscount(subtotal, order.coupon);
}
第五步：验证
每次改动后按顺序执行：运行测试（如 npm test）、检查代码规范（如 npm run lint）、验证类型（如 npm run typecheck 或 tsc --noEmit），必要时再看测试覆盖率是否回退、关键路径性能是否退化。
第六步：通过即提交，然后进入下一个
一个小重构 + 一次提交，历史清晰、可回滚。如果测试挂了，直接回退这一步，不允许「边修测试边改结构」。
输出说明：合格的一次调用应当包含「异味清单 + 每个问题对应的重构手法 + 改动说明 + 验证结果」四部分，而不是直接甩一堆改完的代码。
4. 同类型竞品对比分析
| 方案名称 | 定位 | 核心功能 | 安装/使用门槛 | 适用场景 | 优势与不足 |
|---|---|---|---|---|---|
| 重构专家Skill（refactoring-expert） | AI 驱动的系统化重构助手 | 六类异味检测、标准重构手法库、安全重构流程、审查清单、专业领域路由 | 需支持技能机制的环境，并开放 Read/Grep/Glob/Edit/MultiEdit/Bash 权限 | 遗留代码清理、方法拆解、条件简化、评审前置 | 优势：能判断「怎么改」并自带验证节奏；不足：强依赖测试基础，无测试时需先补测试 |
| ESLint + SonarJS 等静态规则 | 静态代码质量扫描 | 复杂度规则、坏味道规则、规范检查 | 配置成本中等，需接入工程流水线 | CI 卡口、团队统一规范 | 优势：客观、可自动化、零误改风险；不足：只提示不改造，不提供重构方案与顺序 |
| IDE 内置重构（VSCode / WebStorm） | 编辑器级重构动作 | 重命名、提取方法/变量、内联、移动 | 门槛最低，快捷键即用 | 单点、明确的小重构 | 优势：安全、即时、编译器级保障；不足：无全局异味识别，不会规划「先改哪个」 |
| 通用 AI 编程助手（无专用重构技能） | 通用代码生成与问答 | 写代码、解释代码、按需修改 | 低 | 日常编码、快速原型 | 优势：通用性强；不足：重构容易「一把梭」，缺少异味分类体系与行为不变的强制约束 |
选择建议：如果只是改个变量名，用 IDE 快捷键最快；如果是团队流水线卡口，用 ESLint 类规则；如果是「这个模块我不敢动，需要有人帮我规划怎么拆」，重构专家Skill更合适。
5. 该技能的典型应用场景与实际体验情况
场景一：接手遗留项目，先做一次「体检」
角色：刚接手老系统的后端工程师。痛点：模块几千行，不知道从哪下手，怕改了出事。使用方式：先让它只做扫描不改代码，输出六大类异味清单和优先级矩阵判断。实际体验：上手几乎零成本，第一轮就能拿到一份「哪里最该动」的排序表；注意事项是不要一上来就让它改，先看清全貌再动手。
场景二：超长方法与重复代码的拆解
角色：业务迭代频繁的前端开发者。痛点：一个下单方法里塞了校验、计算、优惠、日志，每次加需求都像走钢丝。使用方式：让它按「提取方法」手法拆成若干个意图明确的小方法，每拆一步跑一次测试。实际体验：改造后的代码可读性提升明显，后续加需求改动点集中；注意如果原本没有测试，必须让它先补测试再重构。
场景三：复杂条件与 switch 的多态化改造
角色：负责 SDK 或核心域模型的中高级工程师。痛点：按类型分支的 switch 越加越长，每加一种类型要改七八处。使用方式：让它识别 switch/if-else 分支，评估是否适合用多态或策略替代，并保留原行为。实际体验：这类改造收益最大，但对设计判断要求高，建议人工确认抽象是否过度——技能本身也标注了「投机泛化」属于要避免的反模式。
场景四：Code Review 前置守门
角色：技术负责人。痛点：评审时反复指出同样的结构问题，沟通成本高。使用方式：把技能的代码审查清单（方法质量、对象设计、数据结构、控制流、反模式）当作评审模板，提交前先自查一遍。实际体验：评审焦点从「格式和命名」上移到「设计与分层」，效率提升；注意事项是清单是检查项而非硬性指标，边界情况仍需人来判断。
6. 该技能能为用户带来的价值
- 效率提升：异味识别从「靠人肉翻代码」变成「命令扫描 + 分类清单」，重构顺序由优先级矩阵给出，省掉大量犹豫时间；小步提交的节奏也让返工率显著下降。
- 门槛降低：重构手法本身有学习曲线（提取方法、以多态替换条件、引入参数对象等），技能把「什么时候用哪一招」直接对应到具体异味上，初中级工程师也能做出接近资深水平的结构决策。
- 风险可控：「先有测试 → 小改 → 跑测试 → 通过再提交」的流程，加上
npm test、npm run lint、tsc --noEmit三重验证，把「重构改出 Bug」的概率压到最低。 - 可量化收益：可以拿圈复杂度（目标 < 10）、每方法行数（< 20）、参数个数（≤ 3）、类行数（< 200）作为重构前后的对比指标，让「代码变好了」这件事有数据支撑。
- 长期价值：结构清晰的代码意味着更低的交接成本和更快的需求响应速度；同时把团队的重构习惯沉淀成一份可复用的审查清单与流程规范。
7. 常见问题 FAQ
Q1：这个技能怎么安装？需要什么前提？ A：它属于技能/子代理形态，需要你的 AI 编程环境支持技能机制，并开放 Read、Grep、Glob、Edit、MultiEdit、Bash 六个工具权限。把技能文件安装到技能目录并启用即可，具体的获取入口、安装命令与目录规范以官方说明为准。验证方式：让它分析一个文件，能先检测项目配置再输出异味清单即表示生效。
Q2：使用这个技能收费吗？ A：技能本身的价格、是否免费以及获取渠道由官方技能市场或官方文档规定，以官方说明为准。需要注意的是，运行过程中如果涉及调用 AI 模型，费用通常由你所使用的模型服务计费，这部分与技能本身是分开的。
Q3：它会不会把我的代码改坏？ A：技能的强制流程就是防这件事——先确认测试存在（没有就先补测试），然后一次只做一个重构，改完立刻跑测试、跑 lint、跑类型检查，通过才提交，不通过就回退。理论上仍然建议在独立分支上操作，并保持小步提交以便随时回滚。
Q4：它和 ESLint 这类工具是替代关系吗？ A：不是。ESLint 负责「发现问题并卡住流水线」，重构专家Skill负责「判断怎么改、按什么顺序改、改完怎么验证」。实践中两者配合最好：先用静态规则做客观扫描，再用技能规划和执行重构。
Q5：适合谁用？支持哪些语言？ A：适合需要长期维护代码的开发者、接手遗留系统的工程师、做 Code Review 的技术负责人。从技能内置的检测命令与示例看，它主要面向 JavaScript / TypeScript 生态；重构手法（提取方法、引入参数对象、以多态替换条件等）本身是语言无关的通用方法论，其他语言可用其思路，但具体扫描命令需要按语言调整。