用途:当重构涉及 10 个以上文件、工作量会超出上下文限制、需要跨会话恢复、存在多个相互依赖的阶段,或需要团队协作时使用;1-5 个文件的小改动或单会话任务建议直接重构。
主要能力:以 REFACTOR_PLAN.md 作为持久状态包,记录基础提交、退出条件、各阶段状态、涉及文件、描述、验收标准、验证结果、上次运行后的变更与结果。支持 --init 交互式创建计划、--continue 从上次完成阶段恢复、--status 查看进度、--phase=N 执行指定阶段。阶段按共享工具/类型优先、叶子组件最后、测试与实现同步的顺序排列,每阶段限定 3-7 个文件并可独立提交。
使用方式:执行 /workflow:checkpoint-refactor --init 创建计划,--status 查看进度,--continue 恢复,--phase=3 运行指定阶段。每阶段用 tsc、ty check、cargo check 或 npm/pytest 验证;通过后更新计划文件并提交 git add -u && git commit -m "refactor phase N: {description}"。判断类验收标准需由独立 Task 子代理或 execution-grounded-review 验证,行为类标准应基于执行证据。7 个以上文件的阶段可委派给子代理。
限制与恢复:上下文中断可新开会话运行 --continue;阶段标记 needs-review 时读计划修复后重跑;测试损坏可回滚该阶段提交;基础分支变动需 rebase 并重新验证已完成阶段。计划文件可手动编辑调整。相关技能包括 code-review-checklist、refactoring-patterns、adversarial-review、execution-grounded-review。