星枢：新增Superpowers方法论与Agent整合方案

openclaw/xingshu/Superpowers方法论与Agent整合方案.md

@@ -0,0 +1,170 @@
+# Superpowers 方法论与 Agent-Based 项目整合
+
+> **创建时间：** 2026-04-05
+> **来源：** 与比利哥的讨论
+> **标签：** #方法论 #multi-agent #superpowers
+
+---
+
+## 一、Superpowers 是什么
+
+Superpowers 是由 Jesse Vincent（Best Practical）构建的 **软件编码工作流框架**，专为 AI 编码代理（Claude Code、Cursor、Codex、OpenCode）设计。
+
+**核心理念：**"Don't just jump in — step back, question, plan, then execute."
+
+---
+
+## 二、核心工作流（Basic Workflow）
+
+| 阶段 | 触发时机 | 关键产出 |
+|---|---|---|
+| `brainstorming` | 写代码前 | 澄清意图、设计文档 |
+| `using-git-worktrees` | 设计确认后 | 隔离工作分支 |
+| `writing-plans` | 设计定稿后 | 可执行的小任务清单（2-5分钟/项） |
+| `subagent-driven-development` / `executing-plans` | 计划就绪 | 并行分发子任务、两阶段审查 |
+| `test-driven-development` | 实现过程中 | RED-GREEN-REFACTOR 循环 |
+| `requesting-code-review` | 任务间 | 按严重级别报告问题 |
+| `finishing-a-development-branch` | 任务完成 | 测试验证 + PR/合并选项 |
+
+---
+
+## 三、核心技能清单
+
+### Testing
+- `test-driven-development` — RED-GREEN-REFACTOR 循环
+
+### Debugging
+- `systematic-debugging` — 4步根因分析
+- `verification-before-completion` — 确保真正修复
+
+### Collaboration
+- `brainstorming` — 苏格拉底式设计精炼
+- `writing-plans` — 详细实现计划
+- `executing-plans` — 分批执行 + 检查点
+- `dispatching-parallel-agents` — 并发子任务工作流
+- `requesting-code-review` — 审查前检查清单
+- `receiving-code-review` — 响应反馈
+- `using-git-worktrees` — 并行开发分支
+- `finishing-a-development-branch` — 合并/PR决策
+- `subagent-driven-development` — 两阶段审查（规格合规 → 代码质量）
+
+### Meta
+- `writing-skills` — 创建新技能
+- `using-superpowers` — 技能系统入门
+
+---
+
+## 四、哲学原则
+
+- **Test-Driven Development** — 先写测试，永远
+- **Systematic over ad-hoc** — 流程优于猜测
+- **Complexity reduction** — 简洁是首要目标
+- **Evidence over claims** — 验证后才算成功
+
+---
+
+## 五、对 OpenClaw Agent 矩阵的映射
+
+### 5.1 Agent 类型与适用度
+
+| Agent 类型 | 示例 | Superpowers 适用度 |
+|---|---|---|
+| **编码型** | xingjiang (星匠) | ✅ 高 — 直接可用 |
+| **运维型** | xingyao (星曜)、yunhan | ✅ 中 — 部分技能适用 |
+| **协调型** | xingshu (星枢/我) | ❌ 低 — 方法论而非执行框架 |
+
+### 5.2 技能映射对照
+
+| Superpowers 通用环节 | 映射到多Agent协作 |
+|---|---|
+| `brainstorming` → 意图澄清 | 收到指令先反问确认，避免直接执行 |
+| `writing-plans` → 任务分解 | 拆解后分发云系/风系执行 |
+| `verification-before-completion` → 交付检查 | 执行结果先验证再上报 |
+| `finishing-a-branch` → 收尾归档 | 结果写入 Obsidian + 通知用户 |
+
+---
+
+## 六、整合路径
+
+### 路径 A：直接移植（适合编码子任务）
+
+Superpowers 可安装为 Claude Code 的插件（Skill 格式），但：
+- **只有 Claude Code 会话可用**
+- 不会自动扩散到其他 OpenClaw Agent
+
+**安装命令（Claude Code）：**
+```bash
+/plugin marketplace add obra/superpowers-marketplace
+/plugin install superpowers@superpowers-marketplace
+```
+
+**触发示例：**
+| 对 Claude Code 说 | 激活技能 |
+|---|---|
+| "帮我规划这个功能" | `brainstorming` |
+| "写个实现方案" | `writing-plans` |
+| "开始执行" | `executing-plans` |
+| "帮我 review 代码" | `requesting-code-review` |
+| "修复这个 bug" | `systematic-debugging` |
+| "功能写完了，帮我收尾" | `finishing-a-branch` |
+
+### 路径 B：为团队定制「轻量版」方法论（推荐）
+
+从 Superpowers 提取通用部分，转化为协作规范，应用于所有 Agent。
+
+---
+
+## 七、Superpowers 的安装与使用
+
+### 7.1 支持平台
+
+| 平台 | 安装方式 |
+|---|---|
+| Claude Code（官方市场） | `/plugin install superpowers@claude-plugins-official` |
+| Claude Code（插件市场） | `/plugin marketplace add obra/superpowers-marketplace` |
+| Cursor | `/add-plugin superpowers` |
+| Codex | Fetch `https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md` |
+| OpenCode | Fetch `https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md` |
+| Gemini CLI | `gemini extensions install https://github.com/obra/superpowers` |
+
+### 7.2 验证安装
+
+启动新会话，问「帮我规划这个功能」或「帮我 debug」，Agent 应自动触发相关技能。
+
+---
+
+## 八、建议的第一步
+
+**先选一个具体任务，用 Superpowers 方法论跑一遍演示：**
+
+示例任务："检查所有服务器状态并出报告"
+
+执行流程：
+1. **意图澄清** — 汇总报告 vs 实时状态？报告格式？触发条件？
+2. **形成文字计划** → 用户确认
+3. **分发子任务** → 并行执行
+4. **交叉验证** → 汇总交付
+
+---
+
+## 九、项目信息
+
+- **作者：** Jesse Vincent (Best Practical)
+- **许可证：** MIT
+- **仓库：** https://github.com/obra/superpowers
+- **市场：** https://github.com/obra/superpowers-marketplace
+- **Discord：** https://discord.gg/Jd8Vphy9jq
+- **博客：** https://blog.fsck.com/2025/10/09/superpowers/
+
+---
+
+## 十、待办事项
+
+- [ ] 在 Claude Code 中安装 Superpowers（本次暂不执行）
+- [ ] 选一个具体任务跑一遍演示
+- [ ] 制定团队轻量版方法论文档
+- [ ] 将方法论同步到 MEMORY.md
+
+---
+
+*本文档由星枢整理，基于 2026-04-05 与比利哥的讨论*