⚡ Superpower 安装指南
一句话总结：Superpowers（
obra/superpowers）是一套给编码 agent 的技能 + 软件开发方法论框架，不是 MCP server。它是通过 agent 自己的插件系统安装的，官方支持 OpenCode 等多个 harness，但当前不支持 Harness（DSH）。
是什么
Superpowers 是一套完整的软件开发方法论，构建在可组合的 skills 和一份引导 agent 用它们的初始指令之上。
核心理念：你启动编码 agent 时，它不会直接动手写代码，而是先退回来问你要解决什么；把需求拆成可读的规格片段给你确认；设计敲定后再给出实现计划，用 TDD / YAGNI / DRY 约束；最后进入 subagent 驱动开发，让 agent 自动并行推进并复查每个任务。
⚠️ 它和 MCP server 是两回事：MCP 是给 agent 挂外部工具；Superpowers 是给 agent 换一套「怎么干活」的思考与流程。所以安装方式不同——走 agent 自己的插件/技能目录，而不是
mcp配置块。
支持的各 agent harness：Claude Code、Antigravity、Codex App/CLI、Cursor、Devin CLI、Factory Droid、Gemini CLI、GitHub Copilot CLI、Grok Build CLI、Kimi Code、OpenCode、Pi、Qwen Code、Hermes Agent、Muse。
不支持：Harness（DeepSeek DSH）不在官方支持列表内。
安装（OpenCode）
OpenCode 用自己的插件安装方式，即使你在别的 harness 里已经装了，也要为 OpenCode 单独装一份。
方式一：让它读官方指令（最简单）
在 OpenCode 对话里告诉它：
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
方式二：手写配置
OpenCode V2 要求 2.0.4 或更高。
V1（plugin 单数键）：
{
"plugin": ["superpowers@git+https://github.com/obra/superpowers.git"]
}V2（plugins 复数键，2.0.4+）：
{
"plugins": ["superpowers@git+https://github.com/obra/superpowers.git"]
}本地 V2 安装：配置 index.js 所在的仓库目录即可。注意 OpenCode 2.0.4 和 2.0.7 会拒绝直接指向 JavaScript 文件的路径；发现到的插件符号链接仍然支持。
改完重启 OpenCode。V2 用 opencode 命令（opencode2 可能是别名）。插件通过 OpenCode 的插件管理器安装并注册全部 skills。
验证：问一句 “Tell me about your superpowers”。
使用
用 OpenCode 原生的 skill 工具：
use skill tool to list skills
use skill tool to load brainstorming
更新
OpenCode 走 git-backed 包规范安装，某些 OpenCode / Bun 版本会把解析出的 git 依赖固定到 lockfile 或缓存，重启可能不会拿到最新 commit。若更新不出现，清掉 OpenCode 的包缓存或重装插件。
要固定版本，在 spec 里加 tag 或 commit（V1 plugin 和 V2 plugins 键同形）。
从旧的 symlink 安装迁移
若之前是用 git clone + 符号链接装的，先清理旧的：
# 移除旧 symlink
rm -f ~/.config/opencode/plugins/superpowers.js
rm -rf ~/.config/opencode/skills/superpowers
# 可选：移除克隆的仓库
rm -rf ~/.config/opencode/superpowers
# 若为 superpowers 在 opencode.json 里加过 skills.paths，一并移除然后按上面的步骤重装。
接入 Harness（不支持）
❌ 当前 Harness（DeepSeek DSH）不在 Superpowers 官方支持列表内，不能像 OpenCode 那样直接安装。
可选替代路径（都未经验证，属判断）：
- 把它当 MCP 用：Superpowers 本身不是 MCP server，但仓库的
skills/是纯 markdown 指令文件，理论上可以塞进 agent 的系统提示词或用file://等工具让 agent 读取。这与官方「按 harness 装插件」的设计不符，效果不保证。 - 在 DSH 里装一个 MCP：如果只是想要「带步骤的编码方法」，不如直接在 Harness 里接
comet-mcp/playwright/codegraph这类 MCP 工具，见各篇安装指南。
建议：OpenCode 上跑 Superpowers，DSH 上跑 MCP 工具，各取所长。
状态记录
- 2026-10-03：初版。整理 OpenCode 接入（V1/V2 配置、指令安装、迁移、更新）。未验证——仅按官方 README 与
.opencode/INSTALL.md整理，未实际在 OpenCode 里跑过；Harness 侧不支持是官方支持列表结论。
🔗 相关
- OpenCode Zen免费模型 — OpenCode 接入
- Playwright MCP 安装指南 · Comet 安装指南 · CodeGraph MCP 安装指南 — 三个 MCP server 的安装
- 官方仓库：obra/superpowers
- 中文增强版：jnMetaCode/superpowers-zh（完整汉化 + 中国原创 skills）