用途:request-refactor-plan 用于规划重构,把大型重构拆成一组尽可能小的提交,且每个提交都让代码库保持“绿色”(测试通过)。它只做结构性调整:重命名、抽取、移动、拆分、合并、去重、收紧类型、依赖倒置;不改变行为、不新增功能、不夹带缺陷修复。若涉及功能开发或行为变更,应改用通用实现规划;若要有意破坏兼容性,应改用 break-compat 重构流程。
使用方式:先由用户描述感知到的问题及初步方案;随后对实际问题与代码进行核对,梳理受影响结构;给出 2-3 个备选方案及权衡与推荐;明确锁定范围(哪些会变、哪些不动);审计受影响区域的测试覆盖;再按“每一步尽量小、每步后代码仍可用”的原则拆解提交。默认把计划写入 <project-root>/docs/refactor-plans/<kebab-name>.md;可选 --emit-issue 会在写文件后用 gh issue create --body-file <path> 创建 GitHub issue。
模板字段:问题、方案、提交列表、决策、测试、范围外。计划中建议避免写文件路径和代码片段,因为容易过时。示例:TypeScript 拆分模块可拆为移动 provider、重新导出公共类型、分批更新导入点、删除废弃再导出;Rust 拆 crate 可拆为新增骨架、用 pub use 过渡、移动实现、翻新下游引用、删除过渡层,每步都运行相应检查与测试。限制:只适用于结构性重构,不处理行为变更;其他细节暂未提供。