{
  "markdown": "# Superpowers CN（中文触发词优化版）\n\n> 本项目是基于 [Superpowers](https://github.com/obra/superpowers) 的中文触发词优化版本，由 [jnlk-cn](https://github.com/jnlk-cn) 维护。所有 skill 已翻译为中文，并对 `description` 等触发元数据进行了中文优化，使中文提示更容易激活对应工作流。\n> 原项目采用 MIT 许可证，版权归属原作者 Jesse Vincent / Prime Radiant。\n\nSuperpowers 是一套完整的 coding agent 软件开发方法论，由一组可组合的技能（skills）和初始引导指令组成，确保你的 agent 在合适时机自动调用它们。\n\n## 快速开始\n\n为你的 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)。\n\n## 工作原理\n\n从你启动 coding agent 的那一刻起，Superpowers 就开始工作了。当它发现你要构建某个功能时，它**不会**立刻跳进去写代码，而是先退一步，问你真正想做什么。\n\n当对话中梳理出需求后，它会以足够短的片段把设计展示给你，确保你能真正阅读和消化。\n\n在你确认设计后，agent 会制定一份足够清晰的实现计划——清晰到哪怕是一位热情但品味差、没判断力、没有项目背景、还讨厌写测试的初级工程师也能照做。它强调真正的红/绿 TDD、YAGNI（你不会需要它）和 DRY。\n\n接下来，只要你一声\"开始\"，它就会启动*子代理驱动开发*流程：为每个工程任务调度独立的子代理，检查并评审它们的工作，持续推进。你的 agent 一次自主工作几个小时而不偏离你们一起制定的计划，并不少见。\n\n系统还有很多细节，但核心就是这样。因为 skill 是自动触发的，你不需要做什么特别操作——你的 coding agent 自然而然就拥有了 Superpowers。\n\n## 触发逻辑\n\nSuperpowers 的每个技能都是一份带 YAML frontmatter 的 Markdown 文件，位于 `skills/<skill-name>/SKILL.md`。触发机制分两步：\n\n### 1. 引导注入（Bootstrap）\n\n每次启动会话时，harness 会把 `skills/using-superpowers/SKILL.md` 注入到模型上下文中。这段引导告诉 agent：**在执行任何任务之前，先检查是否有相关的 Superpowers skill 适用**。\n\n### 2. Skill 匹配\n\n每个 `SKILL.md` 的 frontmatter 里都有 `name` 和 `description`：\n\n```yaml\n---\nname: brainstorming\ndescription: 用户想要构建某个功能、项目或组件，但需求还不清晰时触发 —— 通过提问澄清目标、探索替代方案并输出可评审的设计文档。\n---\n```\n\n- `description` 必须以**触发条件**开头，用第三人称描述\"什么时候触发这个 skill\"。\n- agent 会把用户的输入和所有 skill 的 `description` 一起评估，选择最匹配的一个或多个 skill。\n- 匹配成功后，agent 会读取对应 `SKILL.md` 的正文，并按照里面的指令执行工作流。\n\n### 中文触发词优化\n\n原版 Superpowers 的 `description` 是英文的，中文提示有时候触发不准。本项目把所有 skill 的 `description` 以及关键触发短语翻译成了自然、口语化的中文，例如：\n\n| 场景 | 中文触发示例 |\n|------|-------------|\n| 头脑风暴 | \"我想做一个 React Todo\"、\"我有个想法\"、\"帮我设计一下\" |\n| 测试驱动开发 | \"先写测试\"、\"TDD\"、\"红绿重构\" |\n| 系统调试 | \"出 bug 了\"、\"为什么报错\"、\"帮我定位问题\" |\n| 代码评审 | \"评审一下这段代码\"、\"看看有没有问题\" |\n| 完成分支 | \"做完了\"、\"可以合并了\"、\"收尾\" |\n\n这样你不需要刻意用英文关键词，正常用中文描述需求，agent 就会更准确地命中对应 skill。\n\n## 安装\n\n> **注意：** 本 fork 没有上架任何官方插件市场。各市场上的 `Superpowers` 通常指向上游原版 [`obra/superpowers`](https://github.com/obra/superpowers)。要安装这个中文触发词优化版，请**直接从本仓库 URL 安装**。\n>\n> 如果你使用多个 harness，需要分别安装。\n\n### Claude Code\n\n```text\n/plugin install https://github.com/jnlk-cn/superpowers-cn\n```\n\n安装后开启新会话即可生效。\n\n### Antigravity\n\n```bash\nagy plugin install https://github.com/jnlk-cn/superpowers-cn\n```\n\nAntigravity 会运行插件的 session-start hook，因此从第一条消息起 Superpowers 就处于激活状态。用相同命令重新安装即可更新。\n\n### Codex App\n\nCodex App 目前只能从官方市场安装插件，无法直装 GitHub 仓库。如果你想在这个 fork 上使用 Codex，请改用 **Codex CLI**。\n\n### Codex CLI\n\n```text\n/plugins install https://github.com/jnlk-cn/superpowers-cn\n```\n\n### Cursor\n\n```text\n/add-plugin https://github.com/jnlk-cn/superpowers-cn\n```\n\n如果 Cursor 不支持直接通过 URL 安装，可以手动将本仓库克隆到 Cursor 的插件目录，或在 Cursor 插件市场中搜索后确认来源指向 `jnlk-cn/superpowers-cn`。\n\n### Factory Droid\n\n```bash\ndroid plugin install https://github.com/jnlk-cn/superpowers-cn\n```\n\n### Gemini CLI\n\n```bash\ngemini extensions install https://github.com/jnlk-cn/superpowers-cn\n```\n\n后续更新：\n\n```bash\ngemini extensions update superpowers\n```\n\n### GitHub Copilot CLI\n\n```bash\ncopilot plugin install https://github.com/jnlk-cn/superpowers-cn\n```\n\n### Kimi Code\n\n```text\n/plugins install https://github.com/jnlk-cn/superpowers-cn\n```\n\n安装后开新会话：\n\n```text\n/new\n```\n\n详细文档：[docs/README.kimi.md](docs/README.kimi.md)\n\n### OpenCode\n\nOpenCode 使用自己的插件安装机制。即使你在其他 harness 中已安装 Superpowers，也需要为 OpenCode 单独安装。\n\n- 对 OpenCode 说：\n\n  ```\n  Fetch and follow instructions from https://raw.githubusercontent.com/jnlk-cn/superpowers-cn/refs/heads/main/.opencode/INSTALL.md\n  ```\n\n- 详细文档：[docs/README.opencode.md](docs/README.opencode.md)\n\n### Pi\n\n```bash\npi install git:github.com/jnlk-cn/superpowers-cn\n```\n\n本地开发时，可以将本仓库作为临时包加载：\n\n```bash\npi -e /path/to/superpowers-cn\n```\n\nPi 包会加载 Superpowers skills，并通过一个小扩展在 session 启动时以及 session compact 之后注入 `using-superpowers` 引导上下文。Pi 有原生 skills，因此不需要兼容性的 `Skill` 工具。子代理和任务列表工具仍是可选的 Pi 配套包。\n\n## 基础工作流\n\n1. **brainstorming（头脑风暴）** - 在写代码前激活。通过提问把模糊想法打磨清楚，探索替代方案，把设计分块展示给你确认，并保存设计文档。\n\n2. **using-git-worktrees（使用 Git worktree）** - 设计确认后激活。在新分支上创建隔离工作区，运行项目初始化，验证干净的测试基线。\n\n3. **writing-plans（编写计划）** - 设计获批后激活。把工作拆成小块任务（每个 2-5 分钟），每个任务都包含精确文件路径、完整代码和验证步骤。\n\n4. **subagent-driven-development（子代理驱动开发）** 或 **executing-plans（执行计划）** - 拿到计划后激活。每个任务调度一个全新子代理，进行两阶段评审（先规格符合性，再代码质量）；或按批次执行并设置人工检查点。\n\n5. **test-driven-development（测试驱动开发）** - 实现过程中激活。强制执行 RED-GREEN-REFACTOR：先写失败的测试，看着它失败，再写最精简的代码让它通过，最后重构并提交。会删除测试之前写的代码。\n\n6. **requesting-code-review（请求代码评审）** - 任务之间激活。对照计划评审，按严重程度报告问题。严重问题会阻止继续推进。\n\n7. **finishing-a-development-branch（完成开发分支）** - 任务完成后激活。验证测试，给出选项（合并/提 PR/保留/丢弃），清理 worktree。\n\n**agent 在执行任何任务前都会检查相关 skill。** 这是强制工作流，不是建议。\n\n## 内容一览\n\n### 技能库\n\n**测试**\n- **test-driven-development** - 红/绿/重构循环（包含测试反模式参考）\n\n**调试**\n- **systematic-debugging** - 四阶段根因定位流程（包含根因追踪、纵深防御、条件等待等技术）\n- **verification-before-completion** - 确保问题真的被修复\n\n**协作**\n- **brainstorming** - 苏格拉底式设计提炼\n- **writing-plans** - 详细的实现计划\n- **executing-plans** - 带检查点的批量执行\n- **dispatching-parallel-agents** - 并发子代理工作流\n- **requesting-code-review** - 评审前检查清单\n- **receiving-code-review** - 响应反馈\n- **using-git-worktrees** - 并行开发分支\n- **finishing-a-development-branch** - 合并/PR 决策工作流\n- **subagent-driven-development** - 快速迭代与两阶段评审（规格符合性，然后代码质量）\n\n**元技能**\n- **writing-skills** - 按照最佳实践创建新 skill（包含测试方法论）\n- **using-superpowers** - skills 系统简介\n\n## 理念\n\n- **测试驱动开发** - 永远先写测试\n- **系统化而非临时性** - 流程胜过猜测\n- **降低复杂度** - 把简洁作为首要目标\n- **证据胜于宣称** - 在宣布成功前先验证\n\n原项目发布说明：[Superpowers 原始公告](https://blog.fsck.com/2025/10/09/superpowers/)。\n\n## 参与贡献\n\n欢迎对这个中文优化版本提出 issue 和 PR。如果你想改动 skills，请先阅读 `skills/writing-skills/SKILL.md`，并尽量保持对所有支持的 coding agent 的兼容性。\n\n1. Fork 本仓库\n2. 切换到 `dev` 分支\n3. 为你的改动创建分支\n4. 遵循 `writing-skills` skill 创建和测试 skill\n5. 提交 PR，填写 PR 模板\n\nSkill 行为测试使用 [superpowers-evals](https://github.com/prime-radiant-inc/superpowers-evals/) 的 drill eval harness，克隆到 `evals/` 目录 —— 详见 `evals/README.md`。插件基础设施测试位于 `tests/`，通过对应的 `run-*.sh` 或 `npm test` 运行。\n\n完整指南请见 `skills/writing-skills/SKILL.md`。\n\n## 更新\n\n更新方式取决于你使用的 coding agent，部分 harness 会自动更新。\n\n## 许可证\n\nMIT License - 详见 LICENSE 文件。\n\n## 隐私说明\n\n本 fork 已**完全移除**可视化伴侣的远程遥测功能：\n\n- brainstorming 可视化伴侣不再从任何外部服务器加载 Prime Radiant logo 或版本图片。\n- 伴侣页面中只保留本地文本标识（`Superpowers CN v{version}`），不发起任何遥测请求。\n- 因此原版的 `SUPERPOWERS_DISABLE_TELEMETRY`、`DISABLE_TELEMETRY`、`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` 等环境变量在本 fork 中已不再需要。\n\n可视化伴侣仍然是一个纯本地 HTTP/WebSocket 服务器，用于在你的浏览器中展示原型、图表和选项；除了你本地打开的浏览器标签页外，不会向任何第三方服务发送项目、提示词或交互数据。\n\n## 社区\n\nSuperpowers CN 由 [jnlk-cn](https://github.com/jnlk-cn) 维护，基于 Jesse Vincent / Prime Radiant 的 [Superpowers](https://github.com/obra/superpowers) 构建。\n\n- **Issues**: https://github.com/jnlk-cn/superpowers-cn/issues\n",
  "bytes": 6790,
  "sha": "aab6655e864f699e4b9409c5cb106af2d81449ca0fe12a91a9ca843ee6338734",
  "repo_slug": "jnlk-cn/superpowers-cn",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_jnlk_cn_superpowers_cn_17273743/readme"
}