Agent Skills
返回列表
💻

整洁代码重构助手

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,将 @org-02qudk26/code-refactoring-refactor-clean 安装到 AI 助手中。

技能介绍

问题

当代码出现重复、嵌套、职责混杂、依赖不清或测试薄弱时,继续叠加功能往往会放大坏味。它更适合作为模块级重构助手,而不是处理单行小修、文档整理或变更冻结期的临时改动。对跨模块耦合较重、边界模糊的代码,尤其需要先梳理风险,再决定拆分顺序。

工作方式

该技能按“诊断—计划—小步落地—验证”的思路工作:

  • 评估代码坏味:找出重复、高复杂度、风险热点、依赖倒置问题和不易测试的边界。
  • 生成增量计划:给出目标区域、有序步骤、预期影响,避免一次性大改。
  • 保持行为稳定:以小批量、可审查的差异推进,必要时结合 resources/implementation-playbook.md 获取更细的模式。
  • 验证回归:更新测试并确认原有行为不变,外部行为未经明确批准不改变。
  • 输出可执行结果:通常包括问题摘要、目标区域、重构步骤、建议变更、预期影响与验证说明。

适用边界:若需求只是解释代码、修 bug 或补文档,不必启动完整重构;若项目禁止结构变更,应先确认范围再使用。

使用场景

  • 接手一段嵌套很深、重复逻辑多的业务模块,需要给出可审查的增量重构计划。
  • 模块即将接入新支付流程,需要降低循环依赖并补齐关键路径的测试覆盖。
  • 代码评审发现函数过长且职责混杂,需要按 SOLID 拆分职责并说明影响面。
  • 上线前冻结变更,不能做大改,需要只输出问题摘要、风险点和最小安全改动。

适合人员

  • 维护遗留业务代码的后端工程师,希望先识别坏味再小步拆分服务边界。
  • 负责重构排期的技术负责人,需要把代码问题转成可评审、可验收的增量计划。
  • 准备给老模块加新功能的平台工程师,想先降低耦合并补齐测试。
  • 做 Code Review 的高级工程师,要求重构建议保持行为稳定且差异可审查。