obra/superpowers

# Superpowers Superpowers 是一个为您的编码智能体构建的完整软件开发工作流，建立在一组可组合的“技能”和一些初始指令之上，确保您的智能体会使用它们。 ## 运作方式 从您启动编码智能体的那一刻开始。一旦它发现您正在构建某些东西，它*不会*直接跳进去尝试编写代码。相反，它会退后一步，询问您真正想做的是什么。 一旦它从对话中梳理出了规范，它会将其分成足够短的块展示给您，以便您能够真正阅读和消化。 在您确认设计后，您的智能体会制定一个实施计划，该计划清晰到足以让一名充满热情但品味不佳、没有判断力、没有项目背景且厌恶测试的初级工程师遵循。它强调真正的红/绿 TDD、YAGNI（You Aren't Gonna Need It，你不会需要它）和 DRY（Don't Repeat Yourself，不要重复自己）。 接下来，一旦您说“开始”，它就会启动一个*子智能体驱动开发*流程，让智能体完成每项工程任务，检查和审查它们的工作，然后继续推进。Claude 通常能够自主工作数小时而不偏离您制定的计划，这很常见。 还有更多内容，但这只是系统的核心。而且由于技能会自动触发，您不需要做任何特别的事情。您的编码智能体只是拥有了 Superpowers。 ## 安装 **注意：** 安装方式因平台而异。Claude Code 或 Cursor 具有内置的插件市场。Codex 和 OpenCode 需要手动设置。 ### Claude Code（通过插件市场） 在 Claude Code 中，首先注册市场： ``` /plugin marketplace add obra/superpowers-marketplace ``` 然后从这个市场安装插件： ``` /plugin install superpowers@superpowers-marketplace ``` ### Cursor（通过插件市场） 在 Cursor Agent 聊天中，从市场安装： ``` /plugin-add superpowers ``` ### Codex 告诉 Codex： ``` Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md ``` **详细文档：** [docs/README.codex.md](docs/README.codex.md) ### OpenCode 告诉 OpenCode： ``` Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md ``` **详细文档：** [docs/README.opencode.md](docs/README.opencode.md) ### 验证安装 在您选择的平台中启动一个新会话，并请求一些应该触发技能的内容（例如，“帮我规划这个功能”或“让我们调试这个问题”）。智能体应该会自动调用相关的 superpowers 技能。 ## 基本工作流 1. **brainstorming（头脑风暴）** - 在编写代码前激活。通过提问完善粗略的想法，探索替代方案，分段展示设计以供验证。保存设计文档。 2. **using-git-worktrees（使用 Git 工作树）** - 在设计批准后激活。在新分支上创建隔离的工作区，运行项目设置，验证干净的测试基线。 3. **writing-plans（编写计划）** - 在设计批准后激活。将工作分解为小任务（每个 2-5 分钟）。每个任务都有确切的文件路径、完整的代码、验证步骤。 4. **subagent-driven-development（子智能体驱动开发）** 或 **executing-plans（执行计划）** - 在有计划时激活。为每个任务分派一个新的子智能体，进行两阶段审查（规范符合性，然后是代码质量），或者在有人工检查点的情况下分批执行。 5. **test-driven-development（测试驱动开发）** - 在实施期间激活。强制执行 RED-GREEN-REFACTOR：编写失败的测试，观察其失败，编写最少的代码，观察其通过，提交。删除在测试之前编写的代码。 6. **requesting-code-review（请求代码审查）** - 在任务之间激活。根据计划进行审查，按严重程度报告问题。严重问题会阻碍进度。 7. **finishing-a-development-branch（完成开发分支）** - 在任务完成时激活。验证测试，展示选项（合并/PR/保留/丢弃），清理工作树。 **智能体会在任何任务之前检查相关技能。** 这是强制性的工作流，而非建议。 ## 包含内容 ### 技能库 **测试** - **test-driven-development（测试驱动开发）** - RED-GREEN-REFACTOR 循环（包含测试反模式参考） **调试** - **systematic-debugging（系统化调试）** - 4 阶段根本原因过程（包含根本原因追踪、深度防御、基于条件的等待技术） - **verification-before-completion（完成前验证）** - 确保确实已修复 **协作** - **brainstorming（头脑风暴）** - 苏格拉底式设计细化 - **writing-plans（编写计划）** - 详细的实施计划 - **executing-plans（执行计划）** - 带有检查点的批量执行 - **dispatching-parallel-agents（调度并行智能体）** - 并发子智能体工作流 - **requesting-code-review（请求代码审查）** - 预审查检查清单 - **receiving-code-review（接收代码审查）** - 回应反馈 - **using-git-worktrees（使用 Git 工作树）** - 并行开发分支 - **finishing-a-development-branch（完成开发分支）** - 合并/PR 决策工作流 - **subagent-driven-development（子智能体驱动开发）** - 通过两阶段审查快速迭代（规范符合性，然后是代码质量） **元** - **writing-skills（编写技能）** - 遵循最佳实践创建新技能（包含测试方法） - **using-superpowers（使用 Superpowers）** - 技能系统介绍 ## 理念 - **测试驱动开发** - 始终先写测试 - **系统化优于临时** - 流程优于猜测 - **降低复杂度** - 简单性作为首要目标 - **证据优于声明** - 在宣布成功之前进行验证 阅读更多：[Superpowers for Claude Code](https://blog.fsck.com/2025/10/09/superpowers/) ## 贡献 技能直接位于此仓库中。贡献方式： 1. Fork 该仓库 2. 为您的技能创建一个分支 3. 遵循 `writing-skills` 技能来创建和测试新技能 4. 提交 PR 完整指南请参阅 `skills/writing-skills/SKILL.md`。 ## 更新 当您更新插件时，技能会自动更新： ``` /plugin update superpowers ``` ## 许可证 MIT 许可证 - 详情请参阅 LICENSE 文件 ## 支持 - **Issues**: https://github.com/obra/superpowers/issues - **Marketplace**: https://github.com/obra/superpowers-marketplace

标签：Agentic Workflow, AI编程助手, Claude, Codex, Cursor, CVE检测, DRY, TDD, YAGNI, 代码审查, 代码生成, 低代码, 大模型编程, 子智能体开发, 工作流自动化, 开发方法论, 技能组合, 数据管道, 智能体框架, 测试驱动开发, 渗透测试工具, 生产力工具, 系统设计, 自动化开发, 软件工程, 防御加固, 需求分析, 项目规划