整洁代码重构助手
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,将 @org-02qudk26/code-refactoring-refactor-clean 安装到 AI 助手中。
技能介绍
问题
当代码出现重复、嵌套、职责混杂、依赖不清或测试薄弱时,继续叠加功能往往会放大坏味。它更适合作为模块级重构助手,而不是处理单行小修、文档整理或变更冻结期的临时改动。对跨模块耦合较重、边界模糊的代码,尤其需要先梳理风险,再决定拆分顺序。
工作方式
该技能按“诊断—计划—小步落地—验证”的思路工作:
- 评估代码坏味:找出重复、高复杂度、风险热点、依赖倒置问题和不易测试的边界。
- 生成增量计划:给出目标区域、有序步骤、预期影响,避免一次性大改。
- 保持行为稳定:以小批量、可审查的差异推进,必要时结合
resources/implementation-playbook.md获取更细的模式。 - 验证回归:更新测试并确认原有行为不变,外部行为未经明确批准不改变。
- 输出可执行结果:通常包括问题摘要、目标区域、重构步骤、建议变更、预期影响与验证说明。
适用边界:若需求只是解释代码、修 bug 或补文档,不必启动完整重构;若项目禁止结构变更,应先确认范围再使用。
使用场景
- 接手一段嵌套很深、重复逻辑多的业务模块,需要给出可审查的增量重构计划。
- 模块即将接入新支付流程,需要降低循环依赖并补齐关键路径的测试覆盖。
- 代码评审发现函数过长且职责混杂,需要按 SOLID 拆分职责并说明影响面。
- 上线前冻结变更,不能做大改,需要只输出问题摘要、风险点和最小安全改动。
适合人员
- 维护遗留业务代码的后端工程师,希望先识别坏味再小步拆分服务边界。
- 负责重构排期的技术负责人,需要把代码问题转成可评审、可验收的增量计划。
- 准备给老模块加新功能的平台工程师,想先降低耦合并补齐测试。
- 做 Code Review 的高级工程师,要求重构建议保持行为稳定且差异可审查。