重构计划

要解决的问题

当工程师说“我想重构这块”，往往只有模糊直觉：代码又长又难测、职责混杂、改动风险高。真正困难的是把这个念头变成一份可安全落地的计划，而非直接冲进去改代码。

重构计划技能（RefactorPlan）填补的就是这个 gap。它通过深度访谈与仓库探索，把模糊诉求转成结构化工件，明确每一步提交都必须让代码保持可工作状态（Martin Fowler 原则：让每一步都小到能始终看到程序在运行）。

核心能力与工作流

该技能扮演重构规划师，按以下步骤推进：

1. 深度访谈：先听用户描述问题与初步思路，不急着给方案。
2. 仓库探索：核实用户断言，确认现状（含测试覆盖）。
3. 方案比较：主动补充用户未考虑到的替代方案。
4. 范围锁定：明确改什么、明确不改什么（out_of_scope 字段）。
5. 小步拆解：把实现拆成尽可能小的提交，每步留测试绿灯。
6. 登记 Issue：按固定模板输出 RefactorPlan 工件。

输出工件结构：

• problem_statement：问题陈述
• solution：技术方案
• commits[]：每条含 summary 与 leaves_working: true
• decisions[] 与 testing_decisions[]：关键决策记录
• out_of_scope[]：明确排除范围

适用边界

• ✅ 适用：制定重构方案、写 RFC、拆分安全的小步。
• ❌ 不适用：本技能不直接改代码，也不写具体文件路径或代码片段（易过时）；落地交给 implement 或 TDD 流程。

该技能强调只测外部行为，不测内部实现；输出可直接交给 triage（分诊为可代理 issue）或 implement（逐提交落地），形成清晰的上下游协作链路。