12
Mega Refactor · workflow

mega-refactor

12-mega-refactor.md
🏗️
P2 source: claude-sessions created: 2026-06-13
◉

WHAT IS THIS

定位

跨多文件大型重构 workflow。适合需要多个 agent 并行改不同子目录，但必须保持行为和接口稳定的重构。

⚡

TRIGGERS

触发场景
▸重复逻辑散在多个 domain。
▸需要统一 runner、registry、formatter、resolver、adapter。
▸单个 agent 串行改会太慢或容易漏。
▸文件多，但可以按目录或职责切分。
↹

INPUT & OUTPUT

输入 / 产出
↘ INPUT
  • 重构目标。
  • 不允许改变的行为。
  • 受影响模块。
  • 测试命令。
  • 写入范围划分。
↗ OUTPUT
  • 重构方案。
  • 分片任务。
  • 共享接口。
  • 分批 patch。
  • 全量验证报告。
🪜

STEPS

编排步骤
  1. 1
    先定边界
    写清楚 public API、CLI output、数据格式、错误语义是否允许改变。
  2. 2
    找重复模式
    用 rg 和结构搜索找重复逻辑，不凭直觉。
  3. 3
    设计共享接口
    只抽真实重复的稳定逻辑，避免为未来可能性抽象。
  4. 4
    切分写入范围
    每个 worker 负责互斥目录或模块。
  5. 5
    先做核心层
    主线程或一个 worker 先落共享 types、runner、registry。
  6. 6
    分片接入
    各 worker 把原模块切到共享层，不改其它模块。
  7. 7
    收敛和删除旧路径
    主线程合并结果，删除旧兼容层，跑旧 API 残留搜索。
  8. 8
    全量验证
    定向测试、全量测试、lint、build、smoke。
⚙

AGENT ROLES

Agent 分工
⚙
Architect
设计共享接口和分片边界。
⚙
Workers
按目录执行接入。
⚙
Compatibility Reviewer
检查行为是否变了。
⚙
Cleanup Agent
删旧路径和重复代码。
⚙
Test Agent
验证。
✓

ACCEPTANCE GATE

验收 gate
⊘

FAILURE HANDLING

失败处理
⊘
如果共享接口开始膨胀，回退到更小抽象。
⊘
如果两个 worker 需要改同一文件，暂停并重新切分。
⊘
如果行为变化不可避免，拆成 migration workflow。
⌘

TEMPLATE

分片模板
TEMPLATE
| Slice | Owner | Files | Allowed changes | Tests |
| --- | --- | --- | --- | --- |