重构专家
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/zhaono1-agent-playbook-refactoring-specialist。
技能介绍
要解决什么问题
重构请求往往夹在「功能要上线」和「这坨代码不敢碰」之间:你知道有 technical debt 和 code smell,但一旦大改就容易悄悄改了行为、或没有测试兜底就全线返工。这个技能面向的是:在对外行为不变的前提下,把结构、可读性和可维护性拉上去,而不是写新功能或做架构宣讲。
技能如何工作
激活场景很具体:你明确要求 refactor、做 cleanup、提到坏味道或代码质量,技能会按一套工程化流程推进:
- Identify the smell — 先判断难维护的根因(长方法、重复代码、大类、长参数表等)。
- Determine the refactoring — 从目录里对号入座,例如长方法走 Extract Method,重复逻辑走 Extract Method / Template Method,大类走 Extract Class。
- Ensure tests pass → Apply → Run tests → Commit — 强调绿测再动刀、小步增量、每步可提交的 atomic commit。
技能内嵌了常见坏味道清单(如 Feature Envy 对应 Move Method,Primitive Obsession 对应 Replace Primitive with Object,大块 switch 对应 Replace Conditional with Polymorphism),并附带 Before/After Refactoring 检查项:是否理解代码、是否选好技法、是否有回滚计划、改完后是否引入新 smell。
实践建议也写进了 playbook:优先用 IDE 自带的 Rename / Extract / Move,频繁跑测,复杂重构考虑 code review;更深目录在 references/smells.md、techniques.md、checklist.md。
适用边界
这是 重构技法与流程 向导,不替代你编写或补齐测试套件;若当前模块几乎没有测试,技能会反复提醒先保行为,但无法替你造覆盖。它也不会自动做跨仓库的大规模迁移或性能调优——那些需要单独的设计决策。涉及业务语义变化时,应走需求变更而不是「重构」名义改逻辑。
使用场景
- 老接口里出现一个 80 行的处理函数,你要在不改 API 契约的前提下拆成可读的私有方法
- 两个模块复制粘贴了同一套校验逻辑,你想用 Extract Method 或模板方法收敛重复并保持行为一致
- 类里塞了订单、支付、通知三套职责,准备 Extract Class 前需要对照坏味道选型并确认测试全绿
- 重构前心里没底:需要按清单核对是否理解代码、是否选好技法以及每步改完如何提交
适合人员
- 维护单体后端、经常在 PR 里被要求「先 refactor 再加功能」的资深后端工程师
- 接手他人模块、需要先识别 Long Method / Duplicate Code 再动刀的应用开发
- 带团队的 Tech Lead,希望在 code review 里用统一坏味道与技法词汇约束重构范围
- 测试先行团队中负责 legacy 清理、强调小步提交与可回滚的工程师