Superpowers – 智能体技能框架和软件开发方法论

Superpowers封面图

Superpowers – 智能体技能框架和软件开发方法论

什么是 Superpowers?

Superpowers 是一个完整的软件开发工作流,专为您的编程智能体设计。它建立在一组可组合的"技能"和一些初始指令之上,确保您的智能体正确使用这些技能。

工作原理

从您启动编程智能体的那一刻开始。一旦它看到您正在构建什么,它不会直接跳到编写代码。相反,它会退后一步,询问您真正想做什么。

一旦它从对话中梳理出规范,它会以足够短的块向您展示,让您能够实际阅读和消化。

在您签署设计后,您的智能体会把一个实施计划组合在一起,这个计划足够清晰,即使是一个热情但品味差、没有判断力、没有项目背景、厌恶测试的初级工程师也能遵循。它强调真正的红/绿 TDD、YAGNI(你不会需要它)和 DRY(不要重复自己)。

接下来,一旦您说"开始",它会启动一个子智能体驱动的开发过程,让智能体完成每个工程任务,检查和审查他们的工作,然后继续前进。Claude 通常能够自主工作几个小时而不偏离您制定的计划,这并不罕见。

还有更多内容,但这是系统的核心。而且因为技能会自动触发,您不需要做任何特殊的事情。您的编程智能体就拥有了 Superpowers。

如果 Superpowers 帮助您赚钱了

如果 Superpowers 帮助您做了赚钱的事情,并且您愿意的话,如果您考虑赞助我的开源工作,我将非常感激。

谢谢!

  • Jesse

安装说明

注意:安装因平台而异。Claude Code 或 Cursor 有内置的插件市场。Codex 和 OpenCode 需要手动设置。

Claude Code 安装

Superpowers 可通过官方 Claude 插件市场获得。

从 Claude 市场安装插件:

/plugin install superpowers@claude-plugins-official

在 Claude Code 中,先注册市场:

/plugin marketplace add obra/superpowers-marketplace

然后从这个市场安装插件:

/plugin install superpowers@superpowers-marketplace

Cursor Agent Chat 安装

在 Cursor Agent 聊天中,从市场安装:

/add-plugin superpowers

或在插件市场中搜索"superpowers"。

Codex 安装

告诉 Codex:

Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.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

Gemini 扩展安装

gemini extensions install https://github.com/obra/superpowers

更新

gemini extensions update superpowers

开始使用

在您选择的平台中启动新会话,并要求一些应该触发技能的内容(例如,"帮我规划这个功能"或"让我们调试这个问题")。智能体应该自动调用相关的 superpowers 技能。

技能列表

开发工作流技能

  • brainstorming – 在编写代码之前激活。通过问题完善粗略的想法,探索替代方案,分部分展示设计以供验证。保存设计文档。

  • using-git-worktrees – 在设计批准后激活。在新分支上创建隔离的工作区,运行项目设置,验证干净的测试基线。

  • writing-plans – 与批准的设计一起激活。将工作分解为一口大小的任务(每个 2-5 分钟)。每个任务都有确切的文件路径、完整的代码、验证步骤。

  • subagent-driven-development 或 executing-plans – 与计划一起激活。为每个任务派遣新的子智能体,进行两阶段审查(规范合规性,然后是代码质量),或通过人工检查点批量执行。

  • test-driven-development – 在实施期间激活。强制执行红-绿-重构:编写失败的测试,看着它失败,编写最少的代码,看着它通过,提交。删除在测试之前编写的代码。

  • requesting-code-review – 在任务之间激活。根据计划进行审查,按严重性报告问题。关键问题阻止进度。

  • finishing-a-development-branch – 在任务完成时激活。验证测试,呈现选项(合并/PR/保留/丢弃),清理工作树。

智能体在任何任务之前检查相关技能。强制性工作流,不是建议。

测试技能

  • test-driven-development – 红-绿-重构循环(包括测试反模式参考)

调试技能

  • systematic-debugging – 4 阶段根本原因过程(包括根本原因追踪、深度防御、基于条件的等待技术)

  • verification-before-completion – 确保它实际上已修复

协作技能

  • brainstorming – 苏格拉底式设计完善

  • writing-plans – 详细的实施计划

  • executing-plans – 带检查点的批量执行

  • dispatching-parallel-agents – 并发子智能体工作流

  • requesting-code-review – 预审查检查清单

  • receiving-code-review – 响应反馈

  • using-git-worktrees – 并行开发分支

  • finishing-a-development-branch – 合并/PR 决策工作流

  • subagent-driven-development – 两阶段审查的快速迭代(规范合规性,然后是代码质量)

元技能

  • writing-skills – 遵循最佳实践创建新技能(包括测试方法论)

  • using-superpowers – 技能系统介绍

核心原则

  • Test-Driven Development – 始终先编写测试

  • Systematic over ad-hoc – 过程胜过猜测

  • Complexity reduction – 简单性作为主要目标

  • Evidence over claims – 在宣布成功之前验证

阅读更多:Superpowers for Claude Code

贡献

技能直接存在于此存储库中。要贡献:

  • Fork 存储库

  • 为您的技能创建分支

  • 遵循 writing-skills 技能创建和测试新技能

  • 提交 PR

请参阅 skills/writing-skills/SKILL.md 获取完整指南。

更新技能

当您更新插件时,技能会自动更新:

/plugin update superpowers

许可证

MIT 许可证 – 有关详细信息,请参阅 LICENSE 文件。

关于

Superpowers 由 Jesse VincentPrime Radiant 的其他人员构建。

社区支持

如需社区支持、问题和分享您使用 Superpowers 构建的内容,请加入我们的 Discord

© 版权声明
THE END
喜欢就支持一下吧
点赞6 分享
评论 抢沙发

请登录后发表评论

    暂无评论内容