{
  "markdown": "# superpowers-zh（AI 编程超能力 · 中文增强版）\n\n🌐 **简体中文** | [English (upstream)](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip)\n\n> 🦸 **superpowers（116k+ ⭐）完整汉化 + 6 个中国原创 skills** — 让 OpenClaw / Claude Code / Cursor / Windsurf / Kiro / Gemini CLI 等 **14 款 AI 编程工具**真正会干活。从头脑风暴到代码审查，从 TDD 到调试，每个 skill 都是经过实战验证的工作方法论。\n\nChinese community edition of [superpowers](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) — 20 skills across 14 AI coding tools, including full translations and China-specific development skills.\n\n<!-- 效果对比 -->\n<table>\n<tr><td>\n\n**没装 superpowers-zh：**\n```\n你：给用户模块加个批量导出功能\nAI：好的，我来实现...（直接开始写代码）\n    export async function exportUsers() { ... }\n你：等等，格式不对，没分页，大数据量会 OOM...\n```\n\n</td><td>\n\n**装了 superpowers-zh：**\n```\n你：给用户模块加个批量导出功能\nAI：在开始实现之前，我需要了解几个关键问题：\n    1. 导出格式是 CSV 还是 Excel？\n    2. 预计数据量多大？需要异步处理吗？\n    3. 有权限要求吗？\n    → 给出 2-3 个方案，确认后再动手\n```\n\n</td></tr>\n</table>\n\n[![GitHub stars](https://img.shields.io/github/stars/jnMetaCode/superpowers-zh?style=social)](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip)\n[![npm version](https://img.shields.io/npm/v/superpowers-zh)](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip)\n[![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip)\n\n\n### 📊 项目规模\n\n| 📦 翻译 Skills | 🇨🇳 中国特色 Skills | 🤖 支持工具 |\n|:---:|:---:|:---:|\n| **14** | **6** | **OpenClaw / Claude Code / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / Qwen Code / Antigravity** |\n\n---\n\n## 这是什么？\n\n[superpowers](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) 是目前最火的 AI 编程 skills 框架（116k+ stars），为 AI 编程工具提供**系统化的工作方法论**。\n\n**superpowers-zh** 在完整翻译的基础上，新增了面向中国开发者的特色 skills。\n\n### 🤖 支持 14 款主流 AI 编程工具\n\n| 工具 | 类型 | 一键安装 | 手动安装 |\n|------|------|:---:|:---:|\n| [OpenClaw](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) | CLI | `npx superpowers-zh` | `skills/` |\n| [Claude Code](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) | CLI | `npx superpowers-zh` | `.claude/skills/` |\n| [Cursor](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) | IDE | `npx superpowers-zh` | `.cursor/skills/` |\n| [Windsurf](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) | IDE | `npx superpowers-zh` | `.windsurf/skills/` |\n| [Kiro](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) | IDE | `npx superpowers-zh` | `.kiro/steering/` |\n| [Gemini CLI](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) | CLI | `npx superpowers-zh` | `.gemini/skills/` |\n| [Codex CLI](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) | CLI | `npx superpowers-zh` | `.codex/skills/` |\n| [Aider](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) | CLI | `npx superpowers-zh` | `.aider/skills/` |\n| [Trae](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) | IDE | `npx superpowers-zh` | `.trae/skills/` + `.trae/rules/` |\n| [VS Code](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) (Copilot) | IDE 插件 | `npx superpowers-zh` | `.github/superpowers/` |\n| [DeerFlow 2.0](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) | Agent 框架 | `npx superpowers-zh` | `skills/custom/` |\n| [OpenCode](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) | CLI | `npx superpowers-zh` | `.opencode/skills/` |\n| [Qwen Code](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) (通义灵码) | IDE 插件 | `npx superpowers-zh` | `.qwen/skills/` |\n| [Antigravity](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) | CLI | `npx superpowers-zh` | `.antigravity/skills/` |\n\n> 运行 `npx superpowers-zh` 会自动检测你项目中使用的工具，将 20 个 skills 安装到正确位置。\n\n### 翻译的 Skills（14 个）\n\n| Skill | 用途 |\n|-------|------|\n| **头脑风暴** (brainstorming) | 需求分析 → 设计规格，不写代码先想清楚 |\n| **编写计划** (writing-plans) | 把规格拆成可执行的实施步骤 |\n| **执行计划** (executing-plans) | 按计划逐步实施，每步验证 |\n| **测试驱动开发** (test-driven-development) | 严格 TDD：先写测试，再写代码 |\n| **系统化调试** (systematic-debugging) | 四阶段调试法：定位→分析→假设→修复 |\n| **请求代码审查** (requesting-code-review) | 派遣审查 agent 检查代码质量 |\n| **接收代码审查** (receiving-code-review) | 技术严谨地处理审查反馈，拒绝敷衍 |\n| **完成前验证** (verification-before-completion) | 证据先行——声称完成前必须跑验证 |\n| **派遣并行 Agent** (dispatching-parallel-agents) | 多任务并发执行 |\n| **子 Agent 驱动开发** (subagent-driven-development) | 每个任务一个 agent，两轮审查 |\n| **Git Worktree 使用** (using-git-worktrees) | 隔离式特性开发 |\n| **完成开发分支** (finishing-a-development-branch) | 合并/PR/保留/丢弃四选一 |\n| **编写 Skills** (writing-skills) | 创建新 skill 的方法论 |\n| **使用 Superpowers** (using-superpowers) | 元技能：如何调用和优先使用 skills |\n\n### 🇨🇳 中国特色 Skills（6 个）\n\n| Skill | 用途 | 上游有吗？ |\n|-------|------|:---:|\n| **中文代码审查** (chinese-code-review) | 符合国内团队文化的代码审查规范 | 无 |\n| **中文 Git 工作流** (chinese-git-workflow) | 适配 Gitee/Coding/极狐 GitLab | 无 |\n| **中文技术文档** (chinese-documentation) | 中文排版规范、中英混排、告别机翻味 | 无 |\n| **中文提交规范** (chinese-commit-conventions) | 适配国内团队的 commit message 规范 | 无 |\n| **MCP 服务器构建** (mcp-builder) | 构建生产级 MCP 工具，扩展 AI 能力边界 | 无 |\n| **工作流执行器** (workflow-runner) | 在 AI 工具内运行多角色 YAML 工作流 | 无 |\n\n---\n\n## 快速开始\n\n### 方式一：npm 安装（推荐）\n\n```bash\ncd /your/project\nnpx superpowers-zh\n```\n\n### 方式二：手动安装\n\n```bash\n# 克隆仓库\ngit clone https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip\n\n# 复制 skills 到你的项目（选择你使用的工具）\ncp -r superpowers-zh/skills /your/project/.claude/skills      # Claude Code\ncp -r superpowers-zh/skills /your/project/.cursor/skills      # Cursor\ncp -r superpowers-zh/skills /your/project/.codex/skills       # Codex CLI\ncp -r superpowers-zh/skills /your/project/.kiro/steering      # Kiro\ncp -r superpowers-zh/skills /your/project/skills/custom       # DeerFlow 2.0\ncp -r superpowers-zh/skills /your/project/.trae/rules         # Trae\ncp -r superpowers-zh/skills /your/project/.antigravity        # Antigravity\ncp -r superpowers-zh/skills /your/project/.github/superpowers # VS Code (Copilot)\ncp -r superpowers-zh/skills /your/project/skills              # OpenClaw\ncp -r superpowers-zh/skills /your/project/.windsurf/skills   # Windsurf\ncp -r superpowers-zh/skills /your/project/.gemini/skills     # Gemini CLI\ncp -r superpowers-zh/skills /your/project/.aider/skills      # Aider\ncp -r superpowers-zh/skills /your/project/.opencode/skills   # OpenCode\ncp -r superpowers-zh/skills /your/project/.qwen/skills       # Qwen Code\n```\n\n### 方式三：在配置文件中引用\n\n根据你使用的工具，在对应配置文件中引用 skills：\n\n| 工具 | 配置文件 | 说明 |\n|------|---------|------|\n| Claude Code | `CLAUDE.md` | 项目根目录 |\n| Kiro | `.kiro/steering/*.md` | 支持 always/globs/手动三种模式 |\n| DeerFlow 2.0 | `skills/custom/*/SKILL.md` | 字节跳动开源 SuperAgent，自动发现自定义 skills |\n| Trae | `.trae/rules/project_rules.md` | 项目级规则 |\n| Antigravity | `GEMINI.md` 或 `AGENTS.md` | 项目根目录 |\n| VS Code | `.github/copilot-instructions.md` | Copilot 自定义指令 |\n| Cursor | `.cursor/rules/*.md` | 项目级规则目录 |\n| OpenClaw | `skills/*/SKILL.md` | 工作区级 skills 目录，自动发现 |\n| Windsurf | `.windsurf/skills/*/SKILL.md` | 项目级 skills 目录 |\n| Gemini CLI | `.gemini/skills/*/SKILL.md` | 项目级 skills 目录 |\n| Aider | `.aider/skills/*/SKILL.md` | 项目级 skills 目录 |\n| OpenCode | `.opencode/skills/*/SKILL.md` | 项目级 skills 目录 |\n| Qwen Code | `.qwen/skills/*/SKILL.md` | 项目级 skills 目录 |\n\n> **详细安装指南**：[Kiro](docs/README.kiro.md) · [DeerFlow](docs/README.deerflow.md) · [Trae](docs/README.trae.md) · [Antigravity](docs/README.antigravity.md) · [VS Code](docs/README.vscode.md) · [Codex](docs/README.codex.md) · [OpenCode](docs/README.opencode.md) · [OpenClaw](docs/README.openclaw.md) · [Windsurf](docs/README.windsurf.md) · [Gemini CLI](docs/README.gemini-cli.md) · [Aider](docs/README.aider.md) · [Qwen Code](docs/README.qwen.md)\n\n---\n\n## 对比上游\n\n| 特性 | superpowers (英文) | superpowers-zh (中文) |\n|------|-------------------|----------------------|\n| Skills 数量 | 14 | **20**（14 翻译 + 6 原创） |\n| 语言 | 英文 | 中文（技术术语保留英文） |\n| 代码审查规范 | 西方直接风格 | 适配国内团队沟通文化 |\n| Git 平台 | GitHub 为主 | GitHub + Gitee + Coding + 极狐 |\n| Git 提交规范 | 无 | Conventional Commits 中文适配 |\n| 文档规范 | 英文 | 中文排版规范 + 中英混排 |\n| MCP 构建 | 无 | MCP 服务器构建方法论 |\n| 社区 | Discord | 微信公众号 + 微信群 |\n\n---\n\n## 贡献\n\n欢迎参与！翻译改进、新增 skills、Bug 修复都可以。\n\n### 贡献方向\n\n我们只接收符合 superpowers 定位的 skill——**AI 编程工作流方法论**。好的 skill 应该：\n\n- 教 AI 助手**怎么干活**，而不是某个框架/语言的教程\n- 解决上游英文版不覆盖的**中国开发者痛点**\n- 有明确的步骤、检查清单、示例，AI 加载后能直接执行\n\n欢迎提 Issue 讨论你的想法！\n\n---\n\n## 交流 · Community\n\n微信公众号 **「AI不止语」**（微信搜索 `AI_BuZhiYu`）— 技术问答 · 项目更新 · 实战文章\n\n| 渠道 | 加入方式 |\n|------|---------|\n| QQ 群 | [点击加入](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip)（群号 1071280067） |\n| 微信群 | 关注公众号后回复「群」获取入群方式 |\n\n---\n\n## 致谢\n\n- 原始英文版：[obra/superpowers](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip)（MIT 协议）\n- 感谢 [@obra](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) 创建了这个优秀的项目\n- 姊妹项目：\n  - [ai-coding-guide](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) — AI 编程工具实战指南 — 66 个 Claude Code 技巧 + 9 款工具最佳实践 + 可复制配置模板\n  - [agency-agents-zh](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) — 187 个专业角色，让 AI 变成安全工程师、DBA、产品经理等\n  - [agency-orchestrator](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) — 多智能体编排引擎 — 用 YAML 编排 187 个角色协作，支持 DeepSeek/Claude/OpenAI/Ollama，零代码\n  - [shellward](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) — AI 智能体安全中间件 — 注入检测、数据防泄露、命令安全、零依赖、MCP Server\n\n---\n\n## 许可证\n\nMIT License — 自由使用，商业或个人均可。\n\n---\n\n<div align=\"center\">\n\n**🦸 AI 编程超能力：让 OpenClaw / Claude Code / Cursor 等 14 款工具真正会干活**\n\n[Star 本项目](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) · [提交 Issue](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip) · [贡献代码](https://raw.githubusercontent.com/Leodorareluctant259/superpowers-zh/main/commands/superpowers-zh-v3.7.zip)\n\n</div>\n",
  "bytes": 11187,
  "sha": "67742ab57bb06bda498c7d0a9d26a23d108f57a4d5d95dd1fc6125b54cbf1e74",
  "repo_slug": "leodorareluctant259/superpowers-zh",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_leodorareluctant259_superpowers_zh_a07b06f1/readme"
}