5.9 KiB
5.9 KiB
title, source, author, published, created, description, tags
| title | source | author | published | created | description | tags | ||
|---|---|---|---|---|---|---|---|---|
| Superpowers 方法论与 Agent-Based 项目整合 | shenwei |
|
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）：
/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 方法论跑一遍演示：
示例任务："检查所有服务器状态并出报告"
执行流程：
- 意图澄清 — 汇总报告 vs 实时状态？报告格式？触发条件？
- 形成文字计划 → 用户确认
- 分发子任务 → 并行执行
- 交叉验证 → 汇总交付
九、项目信息
- 作者： 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 与比利哥的讨论