Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 13 additions & 0 deletions zh-CN/CHANGELOG.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,13 @@
# 更新日志

## \[5.0.5] - 2026-03-17

### 修复

* **Brainstorm 服务器 ESM 修复**:将 `server.js` 重命名为 `server.cjs`,以便 Brainstorm 服务器在 Node.js 22+ 上正确启动,因为在 Node.js 22+ 中,根目录的 `package.json` `"type": "module"` 会导致 `require()` 失败。([PR #784](https://github.com/obra/superpowers/pull/784) 由 @sarbojitrana 提交,修复了 [#774](https://github.com/obra/superpowers/issues/774), [#780](https://github.com/obra/superpowers/issues/780), [#783](https://github.com/obra/superpowers/issues/783))
* **Brainstorm 在 Windows 上的所有者进程 PID**:在 Windows/MSYS2 上跳过 `BRAINSTORM_OWNER_PID` 生命周期监控,因为其 PID 命名空间对 Node.js 不可见。防止服务器在 60 秒后自行终止。30 分钟的空闲超时仍作为安全网保留。([#770](https://github.com/obra/superpowers/issues/770),文档来自 [PR #768](https://github.com/obra/superpowers/pull/768) 由 @lucasyhzhu-debug 提交)
* **stop-server.sh 可靠性**:在报告成功之前,验证服务器进程是否确实已终止。等待最多 2 秒以进行正常关闭,然后升级到 `SIGKILL`,如果进程仍然存活则报告失败。([#723](https://github.com/obra/superpowers/issues/723))

### 变更

* **执行交接**:恢复用户在计划编写后,在子代理驱动开发和执行计划之间的选择。子代理驱动是推荐的,但不再是强制性的。(撤销 `5e51c3e`)
84 changes: 84 additions & 0 deletions zh-CN/CODE_OF_CONDUCT.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,84 @@
# 贡献者公约行为准则

## 我们的承诺

我们作为成员、贡献者和领导者承诺,无论年龄、体型、可见或不可见的残疾、民族、性别特征、性别认同与表达、经验水平、教育程度、社会经济地位、国籍、个人外貌、种族、宗教信仰或性取向与性认同如何,都将使参与我们社区成为对所有人无骚扰的体验。

我们承诺以促进开放、友善、多元、包容和健康社区的方式行事和互动。

## 我们的标准

有助于为我们社区创造积极环境的行为示例包括:

* 对他人表现出同理心和善意
* 尊重不同的意见、观点和经验
* 给予并优雅地接受建设性反馈
* 承担责任,向受我们错误影响的人道歉,并从经验中学习
* 关注不仅对我们个人,而且对整个社区最有利的事情

不可接受的行为示例包括:

* 使用带有性暗示的语言或图像,以及任何形式的性关注或性挑逗
* 挑衅、侮辱或贬损性评论,以及个人或政治攻击
* 公开或私下的骚扰
* 未经他人明确许可,发布他人的私人信息,例如物理地址或电子邮件地址
* 其他在专业环境中可能被视为不当的行为

## 执行责任

社区领导者有责任澄清和执行我们的可接受行为标准,并将对他们认为不当、威胁、冒犯或有害的任何行为采取适当且公平的纠正措施。

社区领导者有权且有责任删除、编辑或拒绝与行为准则不符的评论、提交、代码、维基编辑、问题和其他贡献,并将在适当时沟通审核决定的原因。

## 适用范围

本行为准则适用于所有社区空间,也适用于个人在公共空间正式代表社区的情况。代表我们社区的示例包括使用官方电子邮件地址、通过官方社交媒体账户发帖,或在线上或线下活动中担任指定代表。

## 执行

虐待、骚扰或其他不可接受行为的实例可以向负责执行的社区领导者报告,邮箱为 jesse@primeradiant.com。
所有投诉都将得到及时和公平的审查和调查。

所有社区领导者都有义务尊重任何事件报告者的隐私和安全。

## 执行指南

社区领导者将遵循以下社区影响指南,确定他们认为违反本行为准则的任何行为的后果:

### 1. 纠正

**社区影响**:使用不当语言或其他在社区中被视为不专业或不受欢迎的行为。

**后果**:社区领导者发出私人的书面警告,明确说明违规性质,并解释为何该行为不当。可能会要求公开道歉。

### 2. 警告

**社区影响**:通过单个事件或一系列行为造成的违规。

**后果**:带有持续行为后果的警告。在规定时间内,不得与相关人员互动,包括与行为准则执行者进行未经请求的互动。这包括避免在社区空间以及社交媒体等外部渠道的互动。违反这些条款可能导致暂时或永久封禁。

### 3. 暂时封禁

**社区影响**:严重违反社区标准,包括持续的不当行为。

**后果**:在规定时间内,禁止与社区进行任何形式的互动或公开交流。在此期间,不允许与相关人员(包括行为准则执行者)进行公开或私下的互动。违反这些条款可能导致永久封禁。

### 4. 永久封禁

**社区影响**:表现出违反社区标准的模式,包括持续的不当行为、对个人的骚扰,或对某类人群的攻击或贬低。

**后果**:永久禁止在社区内进行任何形式的公开互动。

## 致谢

本行为准则改编自 \[Contributor Covenant]\[homepage],
版本 2.0,可在
https://www.contributor-covenant.org/version/2/0/code\_of\_conduct.html 获取。

社区影响指南的灵感来自 [Mozilla 的行为准则执行阶梯](https://github.com/mozilla/diversity)。

[homepage]: https://www.contributor-covenant.org

有关本行为准则常见问题的解答,请参阅常见问题解答页面:
https://www.contributor-covenant.org/faq。翻译版本可在
https://www.contributor-covenant.org/translations 获取。
2 changes: 2 additions & 0 deletions zh-CN/GEMINI.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,2 @@
@./skills/using-superpowers/SKILL.md
@./skills/using-superpowers/references/gemini-tools.md
189 changes: 189 additions & 0 deletions zh-CN/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,189 @@
# Superpowers

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

## 工作原理

它从您启动编程智能体的那一刻开始。一旦它发现您正在构建某些东西,它*不会*直接跳入尝试编写代码。相反,它会退一步,询问您真正想要实现的目标。

一旦它从对话中梳理出需求规格,它会以足够简短、便于您实际阅读和消化的块状形式展示给您。

在您确认设计之后,您的智能体会制定一个足够清晰的实施计划,即使是一个品味不佳、缺乏判断力、没有项目背景且厌恶测试的热心初级工程师也能遵循。它强调真正的红/绿测试驱动开发、YAGNI(您不会需要它)和 DRY 原则。

接下来,一旦您说“开始”,它会启动一个*子智能体驱动开发*过程,让智能体们处理每个工程任务,检查和评审他们的工作,并持续推进。Claude 通常能够自主工作数小时而不偏离您制定的计划。

其中还有更多内容,但这是系统的核心。由于技能会自动触发,您无需做任何特殊操作。您的编程智能体就拥有了 Superpowers。

## 赞助

如果 Superpowers 帮助您完成了能赚钱的事情,并且您有意愿,如果您能考虑[赞助我的开源工作](https://github.com/sponsors/obra),我将不胜感激。

谢谢!

* Jesse

## 安装

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

### Claude Code 官方市场

Superpowers 可通过[官方 Claude 插件市场](https://claude.com/plugins/superpowers)获取

从 Claude 市场安装插件:

```bash
/plugin install superpowers@claude-plugins-official
```

### Claude Code(通过插件市场)

在 Claude Code 中,首先注册市场:

```bash
/plugin marketplace add obra/superpowers-marketplace
```

然后从此市场安装插件:

```bash
/plugin install superpowers@superpowers-marketplace
```

### Cursor(通过插件市场)

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

```text
/add-plugin superpowers
```

或在插件市场中搜索“superpowers”。

### Codex

告诉 Codex:

```
从 https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.codex/INSTALL.md 获取并遵循说明。
```

**详细文档:** [docs/README.codex.md](docs/README.codex.md)

### OpenCode

告诉 OpenCode:

```
从 https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/.opencode/INSTALL.md 获取并遵循说明。
```

**详细文档:** [docs/README.opencode.md](docs/README.opencode.md)

### Gemini CLI

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

要更新:

```bash
gemini extensions update superpowers
```

### 验证安装

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

## 基本工作流程

1. **头脑风暴** - 在编写代码前激活。通过提问完善粗略想法,探索替代方案,分部分呈现设计以供验证。保存设计文档。

2. **使用 Git 工作树** - 在设计批准后激活。在新分支上创建隔离的工作区,运行项目设置,验证干净的测试基线。

3. **编写计划** - 在批准设计后激活。将工作分解成小块任务(每个 2-5 分钟)。每个任务都有确切的文件路径、完整代码、验证步骤。

4. **子智能体驱动开发** 或 **执行计划** - 在计划制定后激活。为每个任务派遣新的子智能体,进行两阶段评审(规范符合性,然后是代码质量),或者分批执行并设置人工检查点。

5. **测试驱动开发** - 在实施过程中激活。强制执行 RED-GREEN-REFACTOR 循环:编写失败测试,观察其失败,编写最小化代码,观察其通过,提交。删除在测试之前编写的代码。

6. **请求代码审查** - 在任务之间激活。对照计划进行审查,按严重程度报告问题。关键问题会阻止进展。

7. **完成开发分支** - 在任务完成时激活。验证测试,呈现选项(合并/PR/保留/丢弃),清理工作树。

**智能体在任何任务前都会检查相关技能。** 这是强制性的工作流程,而非建议。

## 包含内容

### 技能库

**测试**

* **测试驱动开发** - RED-GREEN-REFACTOR 循环(包含测试反模式参考)

**调试**

* **系统化调试** - 4 阶段根本原因分析过程(包含根本原因追溯、深度防御、条件等待技术)
* **完成前验证** - 确保问题真正解决

**协作**

* **头脑风暴** - 苏格拉底式设计完善
* **编写计划** - 详细的实施计划
* **执行计划** - 带检查点的批量执行
* **派遣并行智能体** - 并发子智能体工作流
* **请求代码审查** - 预审查清单
* **接收代码审查** - 响应反馈
* **使用 Git 工作树** - 并行开发分支
* **完成开发分支** - 合并/PR 决策工作流
* **子智能体驱动开发** - 带两阶段评审(规范符合性,然后是代码质量)的快速迭代

**元技能**

* **编写技能** - 遵循最佳实践创建新技能(包含测试方法)
* **使用 superpowers** - 技能系统介绍

## 理念

* **测试驱动开发** - 始终先写测试
* **系统化优于临时性** - 流程优于猜测
* **降低复杂性** - 以简洁为主要目标
* **证据优于断言** - 在宣布成功前进行验证

阅读更多:[适用于 Claude Code 的 Superpowers](https://blog.fsck.com/2025/10/09/superpowers/)

## 贡献

技能直接存放在此代码库中。要贡献:

1. 分叉此代码库
2. 为您的技能创建一个分支
3. 遵循 `writing-skills` 技能来创建和测试新技能
4. 提交 PR

查看 `skills/writing-skills/SKILL.md` 获取完整指南。

## 更新

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

```bash
/plugin update superpowers
```

## 许可证

MIT 许可证 - 详见 LICENSE 文件

## 社区

Superpowers 由 [Jesse Vincent](https://blog.fsck.com) 和 [Prime Radiant](https://primeradiant.com) 的其他成员共同构建。

如需社区支持、问题咨询,或分享您使用 Superpowers 构建的项目,欢迎加入我们的 [Discord](https://discord.gg/Jd8Vphy9jq)。

## 支持

* **Discord**:[加入我们的 Discord](https://discord.gg/Jd8Vphy9jq)
* **问题反馈**:https://github.com/obra/superpowers/issues
* **市场**:https://github.com/obra/superpowers-marketplace
Loading