wehub/obra--superpowers
1
0
Fork 0
Code Issues Pull Requests Actions Deployments Models Agent Notes Packages Projects Releases Wiki Activity

docs: make Chinese README the default

Browse Source
This commit is contained in:
wehub-resource-sync
2026-07-13 06:23:32 +00:00
parent e22c1a8e25
commit 4bd8303be8
1 changed files with 115 additions and 109 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+115 -109
View File
@@ -1,61 +1,66 @@
<!-- WEHUB_ZH_README -->
> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/obra/superpowers) · [上游 README](https://github.com/obra/superpowers/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
# Superpowers
Superpowers 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.
Superpowers 是一套完整的软件开发生成方法论，专为你的编码智能体打造，构建在一组可组合的技能之上，并配有一些初始指令，确保你的智能体能善用这些技能。
## 我们正在招聘！
## We're Hiring!
我们正在招聘一名全职人员，协助 Superpowers 社区和代码方面的工作。
你可以在 https://primeradiant.com/jobs/superpowers-community-engineer/ 了解岗位详情。
如果这听起来像你认识的某个人，欢迎推荐给我们。
We're hiring someone to help out full time with Superpowers community and code work.
You can read about the job at https://primeradiant.com/jobs/superpowers-community-engineer/
If this sounds like someone you know, definitely send them our way.
## 快速开始
## Quickstart
给你的智能体赋予 Superpowers：[Claude Code](#claude-code)、[Antigravity](#antigravity)、[Codex App](#codex-app)、[Codex CLI](#codex-cli)、[Cursor](#cursor)、[Factory Droid](#factory-droid)、[GitHub Copilot CLI](#github-copilot-cli)、[Kimi Code](#kimi-code)、[OpenCode](#opencode)、[Pi](#pi)。
Give your agent Superpowers: [Claude Code](#claude-code), [Antigravity](#antigravity), [Codex App](#codex-app), [Codex CLI](#codex-cli), [Cursor](#cursor), [Factory Droid](#factory-droid), [GitHub Copilot CLI](#github-copilot-cli), [Kimi Code](#kimi-code), [OpenCode](#opencode), [Pi](#pi).
## 工作原理
## How it works
从你启动编码智能体的那一刻开始。一旦它发现你正在构建某个东西，它*不会*直接跳入写代码。相反，它会退一步，问你真正想做什么。
It 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.
当它从对话中梳理出一份规格说明后，会以足够短、让你真正能阅读和消化的片段展示给你。
Once it's teased a spec out of the conversation, it shows it to you in chunks short enough to actually read and digest.
在你确认设计方案后，智能体会制定一份实现计划——这份计划清晰到即使是一位热情但品味不佳、缺乏判断力、没有项目背景、且讨厌测试的初级工程师也能照着执行。它强调真正的红/绿 TDD、YAGNI（You Aren't Gonna Need It，你不需要它）和 DRY。
After 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.
接下来，一旦你说"开始"，它会启动一个*子智能体驱动开发*流程，让智能体逐一处理每个工程任务，检查并审查它们的工作，然后继续推进。你的智能体自主工作两三个小时而不偏离你共同制定的计划，这并不罕见。
Next 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 your agent to work autonomously for a couple hours at a time without deviating from the plan you put together.
还有很多其他内容，但以上是这套系统的核心。而且由于技能是自动触发的，你不需要做任何特殊操作。你的编码智能体就这样拥有了 Superpowers。
There'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.
## 商业服务
## Commercial Services
如果你在企业中使用 Superpowers，并希望获得商业支持、额外工具或托管预算方面的帮助，请随时联系我们：sales@primeradiant.com。
If you're using Superpowers in enterprise and could benefit from commercial support, additional tooling, or managed spending, please don't hesitate to drop us a line at sales@primeradiant.com.
## 安装
## Installation
Installation differs by harness. If you use more than one, install Superpowers separately for each one.
不同平台的安装方式有所不同。如果你使用多个平台，请为每个平台分别安装 Superpowers。
### Claude Code
Superpowers is available via the [official Claude plugin marketplace](https://claude.com/plugins/superpowers)
Superpowers 可通过[官方 Claude 插件市场](https://claude.com/plugins/superpowers)获取
#### Official Marketplace
#### 官方市场
- Install the plugin from Anthropic's official marketplace:
- 从 Anthropic 官方市场安装插件：
```bash
/plugin install superpowers@claude-plugins-official
```
#### Superpowers Marketplace
#### Superpowers 市场
The Superpowers marketplace provides Superpowers and some other related plugins for Claude Code.
Superpowers 市场提供 Superpowers 及其他一些相关插件，适用于 Claude Code。
- Register the marketplace:
- 注册市场：
```bash
/plugin marketplace add obra/superpowers-marketplace
```
- Install the plugin from this marketplace:
- 从该市场安装插件：
```bash
/plugin install superpowers@superpowers-marketplace
@@ -63,60 +68,60 @@ The Superpowers marketplace provides Superpowers and some other related plugins
### Antigravity
Install Superpowers as a plugin from this repository:
以插件形式从此仓库安装 Superpowers：
```bash
agy plugin install https://github.com/obra/superpowers
```
Antigravity runs the plugin's session-start hook, so Superpowers is active from
the first message. Reinstall with the same command to update.
Antigravity 会运行插件的会话启动钩子，因此 Superpowers 从第一条消息起就处于激活状态。
使用同样的命令重新安装即可更新。
### Codex App
Superpowers is available via the [official Codex plugin marketplace](https://github.com/openai/plugins).
Superpowers 可通过[官方 Codex 插件市场](https://github.com/openai/plugins)获取。
- In the Codex app, click on Plugins in the sidebar.
- You should see `Superpowers` in the Coding section.
- Click the `+` next to Superpowers and follow the prompts.
- 在 Codex 应用中，点击侧边栏的 Plugins。
- 你应该会在 Coding 部分看到 `Superpowers`。
- 点击 Superpowers 旁边的 `+`，按提示操作即可。
### Codex CLI
Superpowers is available via the [official Codex plugin marketplace](https://github.com/openai/plugins).
Superpowers 可通过[官方 Codex 插件市场](https://github.com/openai/plugins)获取。
- Open the plugin search interface:
- 打开插件搜索界面：
```bash
/plugins
```
- Search for Superpowers:
- 搜索 Superpowers：
```bash
superpowers
```
- Select `Install Plugin`.
- 选择 `Install Plugin`。
### Cursor
- In Cursor Agent chat, install from marketplace:
- 在 Cursor Agent 聊天中，从市场安装：
```text
/add-plugin superpowers
```
- Or search for "superpowers" in the plugin marketplace.
- 或者在插件市场中搜索 "superpowers"。
### Factory Droid
- Register the marketplace:
- 注册市场：
```bash
droid plugin marketplace add https://github.com/obra/superpowers
```
- Install the plugin:
- 安装插件：
```bash
droid plugin install superpowers@superpowers
@@ -124,13 +129,13 @@ Superpowers is available via the [official Codex plugin marketplace](https://git
### GitHub Copilot CLI
- Register the marketplace:
- 注册市场：
```bash
copilot plugin marketplace add obra/superpowers-marketplace
```
- Install the plugin:
- 安装插件：
```bash
copilot plugin install superpowers@superpowers-marketplace
@@ -138,136 +143,137 @@ Superpowers is available via the [official Codex plugin marketplace](https://git
### Kimi Code
Superpowers is available in Kimi Code's plugin marketplace.
Superpowers 可在 Kimi Code 的插件市场中获取。
- Open Kimi Code's plugin manager:
- 打开 Kimi Code 的插件管理器：
```text
/plugins
```
- Go to `Marketplace` > `Superpowers` and install it.
- 进入 `Marketplace` > `Superpowers` 并安装。
- Or install directly from this repository:
- 或者直接从本仓库安装：
```text
/plugins install https://github.com/obra/superpowers
```
- Detailed docs: [docs/README.kimi.md](docs/README.kimi.md)
- 详细文档：[docs/README.kimi.md](docs/README.kimi.md)
### OpenCode
OpenCode uses its own plugin install; install Superpowers separately even if you
already use it in another harness.
OpenCode 使用自己的插件安装方式；即使你在其他平台已经使用 Superpowers，也需要单独安装。
- Tell OpenCode:
- 告诉 OpenCode：
```
Fetch and follow instructions from https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md
```
- Detailed docs: [docs/README.opencode.md](docs/README.opencode.md)
- 详细文档：[docs/README.opencode.md](docs/README.opencode.md)
### Pi
Install Superpowers as a Pi package from this repository:
以 Pi 包的形式从此仓库安装 Superpowers：
```bash
pi install git:github.com/obra/superpowers
```
For local development, run Pi with this checkout loaded as a temporary package:
用于本地开发时，使用此签出版本作为临时包运行 Pi：
```bash
pi -e /path/to/superpowers
```
The Pi package loads the Superpowers skills and a small extension that injects the `using-superpowers` bootstrap at session startup and again after compaction. Pi has native skills, so no compatibility `Skill` tool is required. Subagent and task-list tools remain optional Pi companion packages.
Pi 包加载 Superpowers 技能以及一个小型扩展，该扩展会在会话启动时和压缩后注入 `using-superpowers` 引导程序。Pi 拥有原生技能，因此不需要兼容性的 `Skill` 工具。子智能体和任务列表工具仍然是可选的 Pi 配套包。
## The Basic Workflow
## 基本工作流
1. **brainstorming** - Activates before writing code. Refines rough ideas through questions, explores alternatives, presents design in sections for validation. Saves design document.
1. **brainstorming（头脑风暴）** - 在写代码前激活。通过提问来完善粗糙的想法，探索替代方案，分块展示设计以供验证。保存设计文档。
2. **using-git-worktrees** - Activates after design approval. Creates isolated workspace on new branch, runs project setup, verifies clean test baseline.
2. **using-git-worktrees（使用 Git 工作树）** - 在设计批准后激活。在新分支上创建隔离的工作空间，运行项目初始化，验证干净的测试基线。
3. **writing-plans** - Activates with approved design. Breaks work into bite-sized tasks (2-5 minutes each). Every task has exact file paths, complete code, verification steps.
3. **writing-plans（编写计划）** - 在设计批准后激活。将工作分解为小块任务（每个 2–5 分钟）。每个任务都有确切的文件路径、完整代码和验证步骤。
4. **subagent-driven-development** or **executing-plans** - Activates with plan. Dispatches fresh subagent per task with two-stage review (spec compliance, then code quality), or executes in batches with human checkpoints.
4. **subagent-driven-development（子智能体驱动开发）或 executing-plans（执行计划）** - 在有计划后激活。为每个任务分派全新的子智能体，进行两阶段审查（先检查规格合规性，再检查代码质量）；或批量执行并设置人工检查点。
5. **test-driven-development** - Activates during implementation. Enforces RED-GREEN-REFACTOR: write failing test, watch it fail, write minimal code, watch it pass, commit. Deletes code written before tests.
5. **test-driven-development（测试驱动开发）** - 在实现过程中激活。强制 RED-GREEN-REFACTOR 循环：编写会失败的测试，观察它失败，编写最小代码，观察它通过，然后提交。删除在测试之前编写的代码。
6. **requesting-code-review** - Activates between tasks. Reviews against plan, reports issues by severity. Critical issues block progress.
6. **requesting-code-review（请求代码审查）** - 在任务之间激活。对照计划进行审查，按严重程度报告问题。关键问题会阻塞进度。
7. **finishing-a-development-branch** - Activates when tasks complete. Verifies tests, presents options (merge/PR/keep/discard), cleans up worktree.
7. **finishing-a-development-branch（完成开发分支）** - 在任务完成后激活。验证测试，提供选项（合并/PR/保留/丢弃），清理工作树。
**The agent checks for relevant skills before any task.** Mandatory workflows, not suggestions.
**智能体在任何任务之前都会检查相关技能。** 这是强制性工作流，而非建议。
## What's Inside
## 内部包含
### Skills Library
### 技能库
**Testing**
- **test-driven-development** - RED-GREEN-REFACTOR cycle (includes testing anti-patterns reference)
**测试**
- **test-driven-development（测试驱动开发）** - RED-GREEN-REFACTOR 循环（包含反模式参考）
**Debugging**
- **systematic-debugging** - 4-phase root cause process (includes root-cause-tracing, defense-in-depth, condition-based-waiting techniques)
- **verification-before-completion** - Ensure it's actually fixed
**调试**
- **systematic-debugging（系统化调试）** - 4 阶段根因定位流程（包含根因追踪、纵深防御、条件等待等技术）
- **verification-before-completion（完成前验证）** - 确保问题确实已修复
**Collaboration**
- **brainstorming** - Socratic design refinement
- **writing-plans** - Detailed implementation plans
- **executing-plans** - Batch execution with checkpoints
- **dispatching-parallel-agents** - Concurrent subagent workflows
- **requesting-code-review** - Pre-review checklist
- **receiving-code-review** - Responding to feedback
- **using-git-worktrees** - Parallel development branches
- **finishing-a-development-branch** - Merge/PR decision workflow
- **subagent-driven-development** - Fast iteration with two-stage review (spec compliance, then code quality)
**协作**
- **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（子智能体驱动开发）** - 带两阶段审查的快速迭代（先检查规格合规性，再检查代码质量）
**Meta**
- **writing-skills** - Create new skills following best practices (includes testing methodology)
- **using-superpowers** - Introduction to the skills system
**元技能**
- **writing-skills（编写技能）** - 遵循最佳实践创建新技能（包含测试方法）
- **using-superpowers（使用 Superpowers）** - 技能系统介绍
## Philosophy
## 哲学理念
- **Test-Driven Development** - Write tests first, always
- **Systematic over ad-hoc** - Process over guessing
- **Complexity reduction** - Simplicity as primary goal
- **Evidence over claims** - Verify before declaring success
- **测试驱动开发** - 始终先写测试
- **系统化优于临时应对** - 流程优于猜测
- **降低复杂性** - 以简洁为首要目标
- **用证据说话** - 验证后再宣布成功
Read [the original release announcement](https://blog.fsck.com/2025/10/09/superpowers/).
阅读[原始发布公告](https://blog.fsck.com/2025/10/09/superpowers/)。
## Contributing
## 贡献
The general contribution process for Superpowers is below. Keep in mind that we don't generally accept contributions of new skills and that any updates to skills must work across all of the coding agents we support.
以下是 Superpowers 的一般贡献流程。请注意，我们通常不接受新技能的贡献，且任何对已有技能的更新必须在我们支持的所有编码智能体上都能正常工作。
1. Fork the repository
2. Switch to the 'dev' branch
3. Create a branch for your work
4. Follow the `writing-skills` skill for creating and testing new and modified skills
5. Submit a PR, being sure to fill in the pull request template.
1. Fork 本仓库
2. 切换到 `dev` 分支
3. 为你自己的工作创建一个分支
4. 遵循 `writing-skills` 技能来创建和测试新的或修改后的技能
5. 提交 PR，并务必填写 PR 模板。
Skill-behavior tests use the drill eval harness from [superpowers-evals](https://github.com/prime-radiant-inc/superpowers-evals/), cloned into `evals/` — see `evals/README.md` for setup. Plugin-infrastructure tests live at `tests/` and run via the relevant `run-*.sh` or `npm test`.
技能行为测试使用来自 [superpowers-evals](https://github.com/prime-radiant-inc/superpowers-evals/) 的 drill eval 测试框架，克隆到 `evals/` 目录下——配置方法见 `evals/README.md`。插件基础设施测试位于 `tests/` 目录，通过相应的 `run-*.sh` 或 `npm test` 运行。
See `skills/writing-skills/SKILL.md` for the complete guide.
完整指南请参见 `skills/writing-skills/SKILL.md`。
## Updating
## 更新
Superpowers updates are somewhat coding-agent dependent, but are often automatic.
Superpowers 的更新方式在一定程度上取决于编码智能体，但通常是自动的。
## License
## 许可证
MIT License - see LICENSE file for details
MIT 许可证——详情见 LICENSE 文件
## Visual companion telemetry
## 可视化伴侣遥测
Because skills and plugins don't provide any feedback to creators, we have no idea how many of you are using Superpowers. By default, the Prime Radiant logo on brainstorming's optional visual companion feature is loaded from our website. It includes the version of Superpowers in use. It does not include any details about your project, prompt, or coding agent. We don't see your clicks or anything about what you're building. This helps us have a rough idea of how many folks are using Superpowers and which version of Superpowers they're using. It's 100% optional. To disable this, set the environment variable `SUPERPOWERS_DISABLE_TELEMETRY` to any true value. Superpowers also honors Claude Code's `DISABLE_TELEMETRY` and `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` opt-outs.
由于技能和插件不会向创作者提供任何反馈，我们不知道有多少人在使用 Superpowers。默认情况下，brainstorming 的可选可视化伴侣功能中的 Prime Radiant 标志会从我们的网站加载。其中包含正在使用的 Superpowers 版本。它不包含有关你的项目、提示或编码智能体的任何细节。我们无法看到你的点击操作或你正在构建的任何内容。这有助于我们大致了解有多少人在使用 Superpowers 以及他们正在使用哪个版本。这是完全可选的。要禁用此功能，请将环境变量 `SUPERPOWERS_DISABLE_TELEMETRY` 设置为任何真值。Superpowers 也会遵守 Claude Code 的 `DISABLE_TELEMETRY` 和 `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 退出机制。
## Community
## 社区
Superpowers is built by [Jesse Vincent](https://blog.fsck.com) and the rest of the folks at [Prime Radiant](https://primeradiant.com).
Superpowers 由 [Jesse Vincent](https://blog.fsck.com) 和 [Prime Radiant](https://primeradiant.com) 的其他成员构建。
- **Discord**: [Join us](https://discord.gg/35wsABTejz) for community support, questions, and sharing what you're building with Superpowers
- **Issues**: https://github.com/obra/superpowers/issues
- **Release announcements**: [Sign up](https://primeradiant.com/superpowers/) to get notified about new versions
- **Discord**：[加入我们](https://discord.gg/35wsABTejz) 获取社区支持、提问，以及分享你用 Superpowers 构建的内容
- **Issues**：https://github.com/obra/superpowers/issues
- **发布公告**：[注册](https://primeradiant.com/superpowers/) 获取新版本通知
USD 预算：$0/$3；剩余 $3（分配：$250/月 + $250 启动池，已使用：$0/$497）
剩余预算：$3（试用池：$3）