| name | superclaw-plan |
| description | SuperClaw Phase 2: 技术对齐。OpenClaw 与 Claude Code 协商，把 spec 变成可执行的 plan。
使用场景：align 阶段完成、spec 已 approve。
终态：plan approved → invoke execute。
|
SuperClaw: Plan
Phase 2 — OpenClaw ↔ Claude Code 技术对齐
把 approved spec 交给 Claude Code，让它探索代码库后出 plan，OpenClaw 做 review 和人类沟通的桥。
宣告： "我在用 superclaw:plan 来规划实现方案。我会把 spec 交给 Claude Code，让它基于代码库给出 plan。"
Plan 阶段不写实现代码。
Plan 必须经过 review 才能执行。
前置条件
spec.md 已存在且状态为 APPROVED- 项目代码库可访问
Board Integration
以下 board 操作仅在 .superclaw/board/ 存在时执行。没有 board 时 skill 正常运行。
| 时机 | Board 操作 | 命令 |
|---|
| 开始 | 读 planned 列中的任务 | 读任务文件 + spec_path |
| CC 出 plan | 更新任务文件 plan_path | set_frontmatter plan_path <path> |
| plan 确认 | 更新 history | 追加 history 行 |
如何找到当前任务
- 如果从 align invoke 过来 → 从调用上下文获取任务文件
- 否则 → 在
board/planned/ 中找到匹配 spec 的任务
Checklist
- 准备上下文 — 收集 spec + 项目结构 + 关键文件
- 发起 Claude Code session — 通过 superclaw 启动，传入 spec
- Claude Code 探索代码库 — 读代码、理解现有架构
- Claude Code 出 plan 草案 — 使用 Superpowers writing-plans skill
- OpenClaw review plan — 检查 spec 覆盖、任务粒度、风险点
- 人类 review（可选） — 三种方式供用户选择
- 确定执行方式 — 进入 execute
流程
收到 approved spec
→ 准备上下文（spec + 代码结构 + 关键文件）
→ superclaw start（传入 spec + writing-plans 指令）
→ Claude Code 探索代码库 + 出 plan 草案
→ OpenClaw review plan
├─ 有问题 → 发修改意见给 CC → CC 修改 → 重新 review（循环）
└─ 通过 → 人类 review gate
→ 人类 review？
├─ "看摘要" → OpenClaw 总结 plan 要点 → 人 approve？
│ ├─ no → 人给反馈 → 传给 CC 修改（循环）
│ └─ yes → 选执行方式
├─ "看完整 plan" → 发 plan.md 给人 → 人 approve？
│ ├─ no → 人给反馈 → 传给 CC 修改（循环）
│ └─ yes → 选执行方式
└─ "跳过，我信你" → 直接选执行方式
→ 选执行方式？
├─ "subagent"（推荐）→ invoke execute（mode=subagent）
├─ "inline" → invoke execute（mode=inline）
└─ "重新规划" → 回到 CC 修改 plan（循环）
发起 Claude Code Session
通过 superclaw 启动 Claude Code：
superclaw start \
--name "superclaw-<feature>" \
--cwd <project-dir> \
--prompt "
你现在是 SuperClaw plan 阶段的技术规划者。
## 你的任务
1. 阅读下面的 spec
2. 探索项目代码库，理解现有架构
3. 使用 superpowers:writing-plans skill 编写实现 plan
4. plan 写好后报告给我
## Spec
<spec.md 内容>
## 约束
- 使用 superpowers:writing-plans skill 的标准格式
- 每个 task 必须有完整代码、精确路径、测试命令
- 不要有 placeholder
- TDD, DRY, YAGNI
- plan 保存到 docs/superclaw/plans/YYYY-MM-DD-<feature>.md
"
OpenClaw Review Plan
Claude Code 出 plan 后，OpenClaw 独立检查：
Review Checklist
- Spec 覆盖度 — plan 里的 task 是否覆盖了 spec 的所有 acceptance criteria？
- 任务粒度 — 每个 task 是否 2-5 分钟可完成？太大要拆
- 占位符扫描 — 有没有 TBD/TODO/模糊步骤？
- 依赖顺序 — task 之间的依赖是否合理？
- 测试覆盖 — 每个 task 都有测试吗？
- 风险识别 — 哪些 task 可能踩坑？标注出来
Review 结果
- 通过 → 进入人类 review gate
- 有问题 →
superclaw send "superclaw-<feature>" 发修改意见 → CC 修改 → 重新 review
人类 Review Gate
给用户三个选择：
"Plan 已经准备好了，你想怎么 review？"
- 看摘要 — 我给你总结 plan 要点（推荐，省时间）
- 看完整 plan — 我把 plan 文件发给你
- 跳过 — 你信任 OpenClaw 和 Claude Code 的 review
摘要格式
## Plan 摘要
**目标：** [一句话]
**Task 数量：** N 个
**预估复杂度：** 简单/中等/复杂
**关键技术决策：**
- ...
**Task 列表：**
1. [Task 名] — [一句话描述]
2. ...
**风险点：**
- ...
**需要你决定的：**
- ...（如果有）
执行方式选择
Plan approved 后，给用户选执行方式：
"Plan 确认 ✅，怎么执行？"
- Subagent 驱动（⭐ 推荐）— 每个 task 派独立 subagent，task 之间有 review
- Inline 执行 — 单 session 顺序执行，有 checkpoint
- 重新规划 — 对 plan 不满意，回去改
终态
"Plan 已确认，执行方式：[subagent/inline]。开始执行阶段。"
invoke superclaw:execute（传入 plan 路径 + 执行方式 + session 名称 superclaw-<feature>）
重要：session 命名用 superclaw-<feature>（不带阶段前缀）。execute 阶段会 send 同一个 session，复用 plan 阶段 CC 对代码库的理解，避免重复探索。
Anti-Pattern
❌ OpenClaw 自己写 plan — plan 必须由 Claude Code 出（它懂代码库）
❌ 跳过 OpenClaw review 直接给人看 — OpenClaw 先过滤一轮
❌ 给用户看函数签名级别的细节 — 人看摘要就够了
❌ Plan 阶段就开始执行代码 — HARD GATE
