xiaoming728

xiaoming728

SuperPowers 介绍

AI
4
2026-07-03
SuperPowers 介绍

https://github.com/obra/superpowers

https://github.com/jnMetaCode/superpowers-zh

superpowers-zh 是 superpowers(159k+ stars)的中文增强版,在完整翻译 14 个核心 Skills 的基础上,新增了 6 个面向中国开发者的原创 Skills,支持 Claude Code、Cursor、Windsurf、Gemini CLI 等 17 款 AI 编程工具一键安装。

项目简介

superpowers 是目前最火的 AI 编程 Skills 框架,为 AI 编程工具提供系统化的工作方法论。superpowers-zh 由 jnMetaCode 团队维护,在保持与上游同步的基础上,针对中国开发者生态做了大量增强。

与英文上游的核心区别:superpowers-zh 将 Skills 总数从 14 个扩展到 20 个,支持工具从 6 款扩展到 17 款,并增加了国内 Git 平台(Gitee、Coding、极狐 GitLab、CNB)和 CI/CD 适配。

核心特性

  • 20 个 Skills — 14 个翻译版 + 6 个中国原创(中文代码审查、Git 工作流、技术文档、提交规范、MCP 构建器、工作流执行器)

  • 17 款工具支持 — Claude Code、Copilot CLI、Hermes Agent、Cursor、Windsurf、Kiro、Gemini CLI、Codex、Aider、Trae、VS Code、DeerFlow、OpenCode、OpenClaw、Qwen Code、Antigravity、Claw Code

  • 一键安装npx superpowers-zh 自动检测项目中的工具并安装到正确位置

  • 国内生态适配 — 支持 Gitee、Coding、极狐 GitLab、CNB(腾讯云原生构建)等国内 Git 平台

  • 社区活跃 — 微信公众号「AI不止语」+ 微信群 + QQ 群

Skills 列表

翻译的 14 个核心 Skills

Skill

用途

头脑风暴 (brainstorming)

需求分析 → 设计规格,不写代码先想清楚

编写计划 (writing-plans)

把规格拆成可执行的实施步骤

执行计划 (executing-plans)

按计划逐步实施,每步验证

测试驱动开发 (test-driven-development)

严格 TDD:先写测试,再写代码

系统化调试 (systematic-debugging)

四阶段调试法:定位→分析→假设→修复

请求代码审查 (requesting-code-review)

派遣审查 agent 检查代码质量

接收代码审查 (receiving-code-review)

技术严谨地处理审查反馈

完成前验证 (verification-before-completion)

声称完成前必须跑验证

派遣并行 Agent (dispatching-parallel-agents)

多任务并发执行

子 Agent 驱动开发 (subagent-driven-development)

每个任务一个 agent,两轮审查

Git Worktree 使用 (using-git-worktrees)

隔离式特性开发

完成开发分支 (finishing-a-development-branch)

合并/PR/保留/丢弃四选一

编写 Skills (writing-skills)

创建新 skill 的方法论

使用 Superpowers (using-superpowers)

元技能:如何调用和优先使用 skills

中国原创的 6 个 Skills

Skill

用途

中文代码审查 (chinese-code-review)

符合国内团队文化的代码审查规范

中文 Git 工作流 (chinese-git-workflow)

适配 Gitee/Coding/极狐 GitLab

中文技术文档 (chinese-documentation)

中文排版规范、中英混排、告别机翻味

中文提交规范 (chinese-commit-conventions)

适配国内团队的 commit message 规范

MCP 服务器构建 (mcp-builder)

构建生产级 MCP 工具,扩展 AI 能力边界

工作流执行器 (workflow-runner)

在 AI 工具内运行多角色 YAML 工作流

安装与使用

方式一:npm 一键安装(推荐)

bashCopy

cd /your/project
npx superpowers-zh

运行后会自动检测项目中的 AI 编程工具,将 20 个 Skills 安装到正确位置。如果检测不到,可通过 --tool <name> 显式指定。

方式二:手动安装

bashCopy

git clone https://github.com/jnMetaCode/superpowers-zh.git

# 根据工具类型复制到对应目录
cp -r superpowers-zh/skills /your/project/.claude/skills      # Claude Code
cp -r superpowers-zh/skills /your/project/.cursor/skills      # Cursor
cp -r superpowers-zh/skills /your/project/.gemini/skills      # Gemini CLI
cp -r superpowers-zh/skills /your/project/.windsurf/skills    # Windsurf

安装前后对比

没有 superpowers-zh:

textCopy

你:给用户模块加个批量导出功能
AI:好的,我来实现...(直接开始写代码)
    export async function exportUsers() { ... }
你:等等,格式不对,没分页,大数据量会 OOM...

有 superpowers-zh:

textCopy

你:给用户模块加个批量导出功能
AI:在开始实现之前,我需要了解几个关键问题:
    1. 导出格式是 CSV 还是 Excel?
    2. 预计数据量多大?需要异步处理吗?
    3. 有权限要求吗?
    → 给出 2-3 个方案,确认后再动手

项目生态

superpowers-zh 是五个项目生态的一部分,覆盖 AI 编程从「方法论 → 角色 → 协作 → 教程 → 安全」的完整链路:

项目

定位

superpowers-zh(本项目)

工作方法论 — 20 个 Skills 教 AI 怎么干活

agency-agents-zh

专家角色库 — 211 个即插即用 AI 专家

agency-orchestrator

编排引擎 — 一句话调度 211 个 AI 专家协作

ai-coding-guide

实战教程 — 66 个 Claude Code 技巧

shellward

安全中间件 — 8 层防御 + DLP 数据流