From 59a93cf9eb8b2b5b85adf09410e82af84aba9637 Mon Sep 17 00:00:00 2001 From: weishen Date: Sun, 5 Apr 2026 08:23:04 +0800 Subject: [PATCH] =?UTF-8?q?=E6=98=9F=E6=9E=A2=EF=BC=9A=E6=96=B0=E5=A2=9ESu?= =?UTF-8?q?perpowers=E6=96=B9=E6=B3=95=E8=AE=BA=E4=B8=8EAgent=E6=95=B4?= =?UTF-8?q?=E5=90=88=E6=96=B9=E6=A1=88?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../Superpowers方法论与Agent整合方案.md | 170 ++++++++++++++++++ 1 file changed, 170 insertions(+) create mode 100644 openclaw/xingshu/Superpowers方法论与Agent整合方案.md diff --git a/openclaw/xingshu/Superpowers方法论与Agent整合方案.md b/openclaw/xingshu/Superpowers方法论与Agent整合方案.md new file mode 100644 index 00000000..b7070465 --- /dev/null +++ b/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 与比利哥的讨论*