| 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