Obra Superpowers Mac mini 安装：编程智能体技能框架指南（2026）
跳过设计与测试的编程智能体会快速产出「看起来对」的 Bug。Obra Superpowers（Jesse Vincent，MIT，GitHub）是一套可组合的 技能（Skills）框架，强制走：头脑风暴 → 规格确认 → TDD → 代码评审。在租用 Mac mini M4 上，Superpowers 可与 24/7 SSH、launchd 及 OpenClaw 配合，避免笔记本合盖后代理中断。
为什么在云 Mac mini 上装 Superpowers
日常 MacBook 安装很常见，但睡眠、VPN 波动或公司 MDM 会阻断插件市场。独立 Mac mini（港/日/韩/新/美节点）提供稳定 SSH、隔离的 API Key，以及可预期的约 ¥730/月硬件成本（见 ProxyMac 定价）。国内团队还可缓解出口带宽、npm 镜像等痛点。模型按量费用请对照 Codex CLI 计费。
Superpowers 不替代大模型，而是用 SKILL.md 把流程变成硬性步骤。需要常驻网关时可参考 OpenClaw launchd 网关。
Superpowers 架构
| 层级 | 典型位置 | 作用 |
|---|---|---|
| 插件 | Cursor / Claude Code 缓存 | 向运行时注册技能 |
| 技能文件 | skills/*/SKILL.md | 不可违背的规则与工作流 |
| 引导 | 插件钩子 | 任务前自动匹配技能 |
| 产物 | 设计文档、git worktree | 人工可读的规格 |
可引用定义：Superpowers 是 MIT 技能框架，把设计评审、实施计划与测试驱动开发设为编码智能体的强制步骤。
官方库含 14+ 技能；2026 年 1 月进入 Claude 官方插件市场；公开仓库星标 17 万+。选型可参考 Apple Mac mini 规格。
九步安装手册
- 选型 — 并发 OpenClaw + MCP 建议 24GB 内存。
- 基础工具 —
xcode-select、git、Node 22+。 - 工作区 —
~/agents/superpowers-workspace，勿放 iCloud 同步目录。 - Cursor — Agent 对话执行
/add-plugin superpowers。 - Claude Code —
/plugin install superpowers@claude-plugins-official - Codex CLI —
/plugins搜索安装（注意 API 费用）。 - launchd 环境 — 按 MCP 环境变量 写入 plist。
- 冒烟测试 — 应先提问再写代码。
- 可选 OpenClaw — 见 安装指南。
故障排查
技能未触发、直接改代码
新建会话、确认插件启用，并明确要求「先 brainstorming」。手动拷贝的技能需与上游同步。
插件市场被墙/代理拦截
配置 HTTPS_PROXY 后重试；无头网关参考 HTTP 代理 egress。
常见问题
先装哪个工具？
Superpowers 按工具分别安装，Cursor 里的插件不会同步到 Codex。建议矩阵：
| 工具 | 命令 | 适用 | 纯 SSH |
|---|---|---|---|
| Cursor | /add-plugin superpowers | IDE 多文件重构 | 可远程 |
| Claude Code | 官方 marketplace 安装 | 长时会话、子代理 | 是 |
| Codex CLI | /plugins | OpenAI 按量计费 | 是 |
| Copilot CLI | marketplace 安装 | 企业 Copilot | 是 |
安全与运维
代理机上的 API Key 与 git 凭证应隔离：独立 macOS 用户、Keychain 注入、关闭 iCloud 同步桌面。Superpowers 会拉长会话，单个 feature 的 worktree 与测试产物可能占 5–15 GB 磁盘，需定期清理。
工作流变化：先澄清需求 → 设计确认 → 计划 → 先写失败测试再实现。大功能通常多花 5–15 分钟 前置时间，减少返工。
