该工具是 Elixir/Phoenix 重写工作流中的第 3 阶段,位于 /rewrite:architect 之后,负责把已接受的架构切分为垂直切片,并逐片移交给 /phx:plan 工作流。
用途:将架构文档转化为可执行的重写路线图,按能力和依赖顺序组织切片,确保每个切片端到端交付用户、操作员或机器目标。
主要能力:
- 构建或更新 roadmap.md,按基础切片、预言机夹具、首个垂直切片、剩余能力、内部替换、发布演练等类别组织。
- 每个切片包含能力、账本 ID、契约、过渡契约、验收标准、退出闸门和阻塞项。
- 提供切片尺寸检查,超过约 12 条账本行或 8 个任务时拆分为子切片。
- 识别并处理切片相关的未决决策,支持交互式询问或 --auto 模式。
- 生成 interview.md 和 scratchpad.md 种子文件,包含绑定决策、机制表、契约、预言机、验收标准、死胡同和开放问题。
- 交接给 /phx:plan 后检查保留性和覆盖性,确保每个决策和验收标准映射到计划任务或约束。
使用方式:
- 前置条件:需要 ADR-000 状态为 accepted 或 ASSUMED、architecture.md 和干净的账本。通过 ledger.py check 验证。
- 构建路线图:读取 references/slicing.md 并写入 .claude/rewrite/roadmap.md。
- 选择切片:使用 --next(默认)、--slice NN 或 --all 参数。刷新阻塞项,列出未解决决策。
- 写入种子文件:位于 .claude/plans/{slug}/ 下,slug 格式为 rewrite-{NN}-{kebab-name}。检查是否已存在计划,避免覆盖用户工作。
- 交接:调用 Skill(skill: "phx:plan", args: ".claude/plans/{slug}/interview.md")。交接后检查保留性和覆盖性。
- 告知用户下一步命令:/phx:work、/rewrite:verify、/rewrite:roadmap --next。
适用场景:Elixir/Phoenix 项目重写规划阶段,需要将架构切分为可管理、可验证的垂直切片,并有序移交给后续计划与工作流程。
限制:
- 依赖前置架构阶段产物(ADR-000、architecture.md、账本)。
- 不修改 phx 流程;审批由 /phx:plan 负责,不会自动启动 /phx:work。
- 种子文件不得伪造访谈记录,必须保留 ASSUMED 和 UNDECIDED 可见。
- 有未决决策时不得交接。
- 覆盖评分需诚实,仅当满足铁律 4 时标记 COMPLETE。
- 不覆盖用户已编辑的文件;冲突时需询问或写替代文件并停止。