项目简介
Superpowers 提供可组合的技能模块和初始指令，为编程智能体提供结构化开发流程。通过插件系统支持多种编码助手，强制执行测试驱动开发、系统化调试和协作规划。
README 预览
# Superpowers\n\nSuperpowers is a complete software development methodology for your coding agents, built on top of a set of composable skills and some initial instructions that make sure your agent uses them.\n\n## Quickstart\n\nGive your agent Superpowers: [Claude Code](#claude-code), [Codex CLI](#codex-cli), [Codex App](#codex-app), [Factory Droid](#factory-droid), [Gemini CLI](#gemini-cli), [OpenCode](#opencode), [Cursor](#cursor), [GitHub Copilot CLI](#github-copilot-cli).\n\n## How it works\n\nIt starts from the moment you fire up your coding agent. As soon as it sees that you're building something, it *doesn't* just jump into trying to write code. Instead, it steps back and asks you what you're really trying to do. \n\nOnce it's teased a spec out of the conversation, it shows it to you in chunks short enough to actually read and digest. \n\nAfter you've signed off on the design, your agent puts together an implementation plan that's clear enough for an enthusiastic junior engineer with poor taste, no judgement, no project context, and an aversion to testing to follow. It emphasizes true red/green TDD, YAGNI (You Aren't Gonna Need It), and DRY. \n\nNext up, once you say "go", it launches a *subagent-driven-development* process, having agents work through each engineering task, inspecting and reviewing their work, and continuing forward. It's not uncommon for Claude to be able to work autonomously for a couple hours at a time without deviating from the plan you put together.\n\nThere's a bunch more to it, but that's the core of the system. And because the skills trigger automatically, you don't need to do anything special. Your coding agent just has Superpowers.\n\n\n## Sponsorship\n\nIf Superpowers has helped you do stuff that makes money and you are so inclined, I'd greatly appreciate it if you'd consider [sponsoring my opensource work](https://github.com/sponsors/obra).\n\nThanks! \n\n- Jesse\n\n\n## Installation\n\nInstallation differs by harness. If you us
常见问题 (5)
故障排除为什么Superpowers brainstorm服务器在接收大型WebSocket消息时会崩溃？
在 skills/brainstorming/scripts/server.cjs 中缺少对负载大小的检查，导致客户端可以触发巨大的 Buffer.alloc，从而使进程崩溃。PR #1555（已合并到 dev 分支）修复了此问题，增加了最大帧大小限制（例如 10 MB）。请升级至包含此修复的最新版本，或手动修补：在 WebSocket 处理器中拒绝大于 MAX_FRAME_BYTES 的帧。
故障排除为什么agents在生成多个计划时会达到output token limit?
升级到 Superpowers v5.1.0+ 版本，其中计划编写不再派发子代理，避免了 Token 限制。在旧版本中，作为替代方案，可以手动使用紧凑格式编写计划，或将计划拆分为多个部分。对于 CLI Opus 模型，请减少计划细节以保持在输出限制内。
故障排除如何修复 Claude Code Superpowers 找不到可视化伴侣 start-server.sh 脚本的问题？
可视化伴侣启动脚本不在插件的顶层 scripts/ 目录中。请从 brainstorming 技能目录运行它：
~/.claude/plugins/cache/claude-plugins-official/superpowers/5.0.7/skills/brainstorming/scripts/start-server.sh --project-dir /path/to/your/project将 5.0.7 替换为你已安装的 Superpowers 版本。如果不确定，可以使用以下命令查找：
find ~/.claude/plugins/cache/claude-plugins-official/superpowers -path '*brainstorming/scripts/start-server.sh'然后将返回的完整路径传递给 Claude Code，或手动运行该命令。
故障排除为什么升级OpenCode到1.4.0后oh-my-opencode消失了？
将OpenCode升级至1.15.10或更高版本，此漏洞已在该版本中修复。如果必须停留在1.4.0版本，请关注issue #1492以获取与原生技能工具相关的永久修复。
故障排除为什么在OpenCode中skill(name="...")会失败，尽管在'opencode debug skill'中列出了技能？
代理的工具列表中缺少技能函数工具。解决方法：(1) 从插件的技能目录创建符号链接到 ~/.config/opencode/skills/superpowers/（选项A）。(2) 更新引导文本，指示代理在 skill() 失败时回退到使用 glob 查找 SKILL.md 并 read 它（选项C）。或者，如果工具缺失，通过 messages.transform 钩子注入技能内容（选项B）。