superpowers-cn
Superpowers 中文触发词优化版：为中文提示优化的 Gemini CLI 技能库（基于 Superpowers）
Open source Open in the app JSON README (API)
About
Superpowers 中文触发词优化版：为中文提示优化的 Gemini CLI 技能库（基于 Superpowers）
Details
- Kind
- Plugins
- Topic
- AI, RAG & memory
- Publisher
- jnlk-cn
- Origin
- gemini
- Category
- ferramentas
- Version
- 6.0.3
- Stars
- 5
- Forks
- 1
- Open pull requests
- 1
- Last push
- 2026-07-12T02:20:55Z
- Repository state
- ativo
- Language
- Shell
- License
- MIT
- Added
- 2026-08-30 14:13:39
- Updated
- 2026-08-30 14:13:39
- Origin id
jnlk-cn/superpowers-cn
README
# Superpowers CN（中文触发词优化版）
> 本项目是基于 [Superpowers](https://github.com/obra/superpowers) 的中文触发词优化版本，由 [jnlk-cn](https://github.com/jnlk-cn) 维护。所有 skill 已翻译为中文，并对 `description` 等触发元数据进行了中文优化，使中文提示更容易激活对应工作流。
> 原项目采用 MIT 许可证，版权归属原作者 Jesse Vincent / Prime Radiant。
Superpowers 是一套完整的 coding agent 软件开发方法论，由一组可组合的技能（skills）和初始引导指令组成，确保你的 agent 在合适时机自动调用它们。
## 快速开始
为你的 coding agent 启用 Superpowers：[Claude Code](#claude-code)、[Antigravity](#antigravity)、[Codex App](#codex-app)、[Codex CLI](#codex-cli)、[Cursor](#cursor)、[Factory Droid](#factory-droid)、[Gemini CLI](#gemini-cli)、[GitHub Copilot CLI](#github-copilot-cli)、[Kimi Code](#kimi-code)、[OpenCode](#opencode)、[Pi](#pi)。
## 工作原理
从你启动 coding agent 的那一刻起，Superpowers 就开始工作了。当它发现你要构建某个功能时，它**不会**立刻跳进去写代码，而是先退一步，问你真正想做什么。
当对话中梳理出需求后，它会以足够短的片段把设计展示给你，确保你能真正阅读和消化。
在你确认设计后，agent 会制定一份足够清晰的实现计划——清晰到哪怕是一位热情但品味差、没判断力、没有项目背景、还讨厌写测试的初级工程师也能照做。它强调真正的红/绿 TDD、YAGNI（你不会需要它）和 DRY。
接下来，只要你一声"开始"，它就会启动*子代理驱动开发*流程：为每个工程任务调度独立的子代理，检查并评审它们的工作，持续推进。你的 agent 一次自主工作几个小时而不偏离你们一起制定的计划，并不少见。
系统还有很多细节，但核心就是这样。因为 skill 是自动触发的，你不需要做什么特别操作——你的 coding agent 自然而然就拥有了 Superpowers。
## 触发逻辑
Superpowers 的每个技能都是一份带 YAML frontmatter 的 Markdown 文件，位于 `skills/<skill-name>/SKILL.md`。触发机制分两步：
### 1. 引导注入（Bootstrap）
每次启动会话时，harness 会把 `skills/using-superpowers/SKILL.md` 注入到模型上下文中。这段引导告诉 agent：**在执行任何任务之前，先检查是否有相关的 Superpowers skill 适用**。
### 2. Skill 匹配
每个 `SKILL.md` 的 frontmatter 里都有 `name` 和 `description`：
```yaml
---
name: brainstorming
description: 用户想要构建某个功能、项目或组件，但需求还不清晰时触发 —— 通过提问澄清目标、探索替代方案并输出可评审的设计文档。
---
```
- `description` 必须以**触发条件**开头，用第三人称描述"什么时候触发这个 skill"。
- agent 会把用户的输入和所有 skill 的 `description` 一起评估，选择最匹配的一个或多个 skill。
- 匹配成功后，agent 会读取对应 `SKILL.md` 的正文，并按照里面的指令执行工作流。
### 中文触发词优化
原版 Superpowers 的 `description` 是英文的，中文提示有时候触发不准。本项目把所有 skill 的 `description` 以及关键触发短语翻译成了自然、口语化的中文，例如：
| 场景 | 中文触发示例 |
|------|-------------|
| 头脑风暴 | "我想做一个 React Todo"、"我有个想法"、"帮我设计一下" |
| 测试驱动开发 | "先写测试"、"TDD"、"红绿重构" |
| 系统调试 | "出 bug 了"、"为什么报错"、"帮我定位问题" |
| 代码评审 | "评审一下这段代码"、"看看有没有问题" |
| 完成分支 | "做完了"、"可以合并了"、"收尾" |
这样你不需要刻意用英文关键词，正常用中文描述需求，agent 就会更准确地命中对应 skill。
## 安装
> **注意：** 本 fork 没有上架任何官方插件市场。各市场上的 `Superpowers` 通常指向上游原版 [`obra/superpowers`](https://github.com/obra/superpowers)。要安装这个中文触发词优化版，请**直接从本仓库 URL 安装**。
>
> 如果你使用多个 harness，需要分别安装。
### Claude Code
```text
/plugin install https://github.com/jnlk-cn/superpowers-cn
```
安装后开启新会话即可生效。
### Antigravity
```bash
agy plugin install https://github.com/jnlk-cn/superpowers-cn
```
Antigravity 会运行插件的 session-start hook，因此从第一条消息起 Superpowers 就处于激活状态。用相同命令重新安装即可更新。
### Codex App
Codex App 目前只能从官方市场安装插件，无法直装 GitHub 仓库。如果你想在这个 fork 上使用 Codex，请改用 **Codex CLI**。
### Codex CLI
```text
/plugins install https://github.com/jnlk-cn/superpowers-cn
```
### Cursor
```text
/add-plugin https://github.com/jnlk-cn/superpowers-cn
```
如果 Cursor 不支持直接通过 URL 安装，可以手动将本仓库克隆到 Cursor 的插件目录，或在 Cursor 插件市场中搜索后确认来源指向 `jnlk-cn/superpowers-cn`。
### Factory Droid
```bash
droid plugin install https://github.com/jnlk-cn/superpowers-cn
```
### Gemini CLI
```bash
gemini extensions install https://github.com/jnlk-cn/superpowers-cn
```
后续更新：
```bash
gemini extensions update superpowers
```
### GitHub Copilot CLI
```bash
copilot plugin install https://github.com/jnlk-cn/superpowers-cn
```
### Kimi Code
```text
/plugins install https://github.com/jnlk-cn/superpowers-cn
```
安装后开新会话：
```text
/new
```
详细文档：[docs/README.kimi.md](docs/README.kimi.md)
### OpenCode
OpenCode 使用自己的插件安装机制。即使你在其他 harness 中已安装 Superpowers，也需要为 OpenCode 单独安装。
- 对 OpenCode 说：
```
Fetch and follow instructions from https://raw.githubusercontent.com/jnlk-cn/superpowers-cn/refs/heads/main/.opencode/INSTALL.md
```
- 详细文档：[docs/README.opencode.md](docs/README.opencode.md)
### Pi
```bash
pi install git:github.com/jnlk-cn/superpowers-cn
```
本地开发时，可以将本仓库作为临时包加载：
```bash
pi -e /path/to/superpowers-cn
```
Pi 包会加载 Superpowers skills，并通过一个小扩展在 session 启动时以及 session compact 之后注入 `using-superpowers` 引导上下文。Pi 有原生 skills，因此不需要兼容性的 `Skill` 工具。子代理和任务列表工具仍是可选的 Pi 配套包。
## 基础工作流
1. **brainstorming（头脑风暴）** - 在写代码前激活。通过提问把模糊想法打磨清楚，探索替代方案，把设计分块展示给你确认，并保存设计文档。
2. **using-git-worktrees（使用 Git worktree）** - 设计确认后激活。在新分支上创建隔离工作区，运行项目初始化，验证干净的测试基线。
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/保留/丢弃），清理 worktree。
**agent 在执行任何任务前都会检查相关 skill。** 这是强制工作流，不是建议。
## 内容一览
### 技能库
**测试**
- **test-driven-development** - 红/绿/重构循环（包含测试反模式参考）
**调试**
- **systematic-debugging** - 四阶段根因定位流程（包含根因追踪、纵深防御、条件等待等技术）
- **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** - 按照最佳实践创建新 skill（包含测试方法论）
- **using-superpowers** - skills 系统简介
## 理念
- **测试驱动开发** - 永远先写测试
- **系统化而非临时性** - 流程胜过猜测
- **降低复杂度** - 把简洁作为首要目标
- **证据胜于宣称** - 在宣布成功前先验证
原项目发布说明：[Superpowers 原始公告](https://blog.fsck.com/2025/10/09/superpowers/)。
## 参与贡献
欢迎对这个中文优化版本提出 issue 和 PR。如果你想改动 skills，请先阅读 `skills/writing-skills/SKILL.md`，并尽量保持对所有支持的 coding agent 的兼容性。
1. Fork 本仓库
2. 切换到 `dev` 分支
3. 为你的改动创建分支
4. 遵循 `writing-skills` skill 创建和测试 skill
5. 提交 PR，填写 PR 模板
Skill 行为测试使用 [superpowers-evals](https://github.com/prime-radiant-inc/superpowers-evals/) 的 drill eval harness，克隆到 `evals/` 目录 —— 详见 `evals/README.md`。插件基础设施测试位于 `tests/`，通过对应的 `run-*.sh` 或 `npm test` 运行。
完整指南请见 `skills/writing-skills/SKILL.md`。
## 更新
更新方式取决于你使用的 coding agent，部分 harness 会自动更新。
## 许可证
MIT License - 详见 LICENSE 文件。
## 隐私说明
本 fork 已**完全移除**可视化伴侣的远程遥测功能：
- brainstorming 可视化伴侣不再从任何外部服务器加载 Prime Radiant logo 或版本图片。
- 伴侣页面中只保留本地文本标识（`Superpowers CN v{version}`），不发起任何遥测请求。
- 因此原版的 `SUPERPOWERS_DISABLE_TELEMETRY`、`DISABLE_TELEMETRY`、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 等环境变量在本 fork 中已不再需要。
可视化伴侣仍然是一个纯本地 HTTP/WebSocket 服务器，用于在你的浏览器中展示原型、图表和选项；除了你本地打开的浏览器标签页外，不会向任何第三方服务发送项目、提示词或交互数据。
## 社区
Superpowers CN 由 [jnlk-cn](https://github.com/jnlk-cn) 维护，基于 Jesse Vincent / Prime Radiant 的 [Superpowers](https://github.com/obra/superpowers) 构建。
- **Issues**: https://github.com/jnlk-cn/superpowers-cn/issues