项目简介
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 模型，请减少计划细节以保持在输出限制内。
故障排除为什么升级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）。
故障排除在编写实施计划之前，如何在 Aider 中确认架构假设？
经过头脑风暴和规范自我审查后，进行一次轻量级的交接准备检查。确保范围、非目标、输出和验证期望对规划者而言足够明确。如果任何未解决的问题会实质性地改变架构、数据流、面向用户的行为或测试，则提出唯一最简明的澄清问题，更新规范，并重新运行自我审查。这可以防止过早的架构决策潜藏到代码详细计划中。