Refactoring Assistant

[UDS] 引导重构决策与策略选择,包含「重构还是重写」这个判断。 Use when: 代码已经难以修改、在战术性与架构性重构之间做选择、要在老旧代码里安全地动手。 Not for: 换到不同框架或主版本——请用 /migrate;清除调试残留与死代码——请用 /sweep。 Keywords: refactor, rewrite, strangler, legacy code, technical debt, code smell, 重构, 重写, 技术债, 坏味道.

AsiaOstrich Updated

File contents

重构助手

语言: English | 简体中文

引导重构决策、推荐策略,并提供逐步执行工作流程。

使用方式

命令 用途
/refactor 启动交互式重构引导
/refactor decide 执行重构 vs 重写决策树
/refactor tactical 建议战术性(日常)策略
/refactor strategic 引导战略性/架构重构
/refactor legacy 遗留代码安全策略
/refactor debt 技术债评估

策略快速参考

战术性策略(日常)

策略 使用时机
准备式重构 新增被阻挡的功能之前
童子军法则 任何维护工作中
红-绿-重构 TDD 开发循环

战略性策略(架构)

策略 使用时机
绞杀者无花果 逐步替换整个系统
防腐层 与遗留系统集成
抽象分支 在主干上重构共享代码

安全防护策略(遗留代码)

策略 使用时机
特征化测试 任何遗留代码重构之前
草稿式重构 理解黑盒代码
寻找接缝 在遗留代码中注入测试替身

工作流程

  1. 评估 - 识别要重构的代码,评估测试覆盖率
  2. 决策 - 需要时执行决策树(重构 vs 重写)
  3. 选择策略 - 根据范围和风险选择适当策略
  4. 执行 - 遵循逐步工作流程,包含安全检查
  5. 验证 - 执行测试以确认行为未被改变

下一步引导

/refactor 完成后,AI 助手应建议:

重构完成。建议下一步:

  • 执行 /checkin 通过品质关卡
  • 执行 /coverage 确认重构后覆盖率不下降
  • 执行 /commit 提交重构变更

参考

AsiaOstrich/universal-dev-standards/tree/main/locales/zh-CN/skills/refactoring-assistant commit 455400ef3b

Frequently asked questions

npx skillmds@latest add asiaostrich/refactoring-assistant