Content
# Tool List
🌐 **English** | [English (upstream)](https://github.com/obra/superpowers)
> 🦸 **superpowers（159k+ ⭐）complete translation + 6 China-specific skills** — Make **17 AI coding tools** truly productive. From brainstorming to code review, from TDD to debugging, each skill is a battle-tested methodology.
Chinese community edition of [superpowers](https://github.com/obra/superpowers) — 20 skills across 16 AI coding tools, including full translations and China-specific development skills.
<!-- 效果对比 -->
<table>
<tr><td>
**Without superpowers-zh：**
```
You: Add a batch export feature to the user module
AI: Okay, I'll implement it... (starts writing code)
export async function exportUsers() { ... }
You: Wait, the format is not right, no pagination, and it will OOM with large data...
```
</td><td>
**With superpowers-zh：**
```
You: Add a batch export feature to the user module
AI: Before implementation, I need to clarify a few key issues:
1. What is the export format, CSV or Excel?
2. What is the estimated data volume? Does it require asynchronous processing?
3. Are there any permission requirements?
→ Provide 2-3 solutions and confirm before implementation
```
</td></tr>
</table>
[](https://github.com/jnMetaCode/superpowers-zh)
[](https://www.npmjs.com/package/superpowers-zh)
[](https://opensource.org/licenses/MIT)
[](https://makeapullrequest.com)
### 📊 Project Overview
| 📦 Translated Skills | 🇨🇳 China-specific Skills | 🤖 Supported Tools |
|:---:|:---:|:---:|
| **14** | **6** | **Claude Code / Copilot CLI / Hermes Agent / Cursor / Windsurf / Kiro / Gemini CLI / Codex / Aider / Trae / VS Code (Copilot) / DeerFlow / OpenCode / OpenClaw / Qwen Code / Antigravity / Claw Code** |
---
## What is this?
[superpowers](https://github.com/obra/superpowers) is the most popular AI coding skills framework (159k+ stars), providing a **systematic methodology** for AI coding tools.
**superpowers-zh** is a Chinese community edition, adding China-specific skills on top of the complete translation.
### 🆚 Comparison with English Upstream
| Dimension | superpowers (English Upstream) | superpowers-zh (Chinese Enhanced) |
|------|----------------------|---------------------------|
| ⭐ Star Count | 159k+ | — |
| 📦 Skills Count | 14 | **20** (14 translated + 6 China-specific) |
| 🌐 Language | English | Chinese (technical terms in English) |
| 🤖 **Supported Tools** | **6**: Claude Code / Cursor / Codex / OpenCode / Copilot CLI / Gemini CLI | **17**: above 6 + Hermes Agent / Trae / Kiro / Qwen Code / OpenClaw / Claw Code / Antigravity / DeerFlow / VS Code / Windsurf / Aider |
| ⚡ **Installation** | Separate installation for each tool | **`npx superpowers-zh` one-command installation with automatic tool detection**; explicit tool specification with `--tool <name>` |
| 🇨🇳 Git Platform | GitHub mainly | GitHub + Gitee + Coding + GitLab + **CNB (Tencent Cloud Native Build)** |
| 🇨🇳 CI/CD Examples | GitHub Actions | GitHub Actions + Gitee Go + Coding CI + GitLab CI + `.cnb.yml` |
| 🇨🇳 Code Review Style | Western direct style | Adapted to Chinese team communication culture |
| 🇨🇳 Git Commit Conventions | None | Conventional Commits with Chinese adaptation |
| 🇨🇳 Chinese Documentation Conventions | None | Chinese typesetting + mixed Chinese-English formatting + no machine translation flavor |
| ➕ MCP Server Build | None | Independent `mcp-builder` skill |
| ➕ Workflow Executor | None | Independent `workflow-runner` skill (multi-role YAML orchestration) |
| 🔄 Version Follow-up | Independent iteration | **Synchronized with upstream + incremental China-specific features** |
| 🤝 New Skill PR Acceptance | Generally not accepted (original: *"we don't generally accept contributions of new skills"*) | Welcome PRs (prioritizing Chinese developer pain points) |
| 💬 Community | Discord | WeChat Official Account "AI不止语" + WeChat Group + QQ Group |
| 📜 License | MIT | MIT |
**One-sentence summary:** English upstream = methodology core; Chinese enhanced = methodology core **+** 17 tools one-click adaptation **+** domestic Git/CI ecosystem **+** Chinese expression habits.
### 🤖 Supported 17 Mainstream AI Coding Tools
| Tool | Type | One-click Installation | Manual Installation |
|------|------|:---:|:---:|
| [Claude Code](https://claude.ai/code) | CLI | `npx superpowers-zh` | `.claude/skills/` |
| [Copilot CLI](https://githubnext.com/projects/copilot-cli) | CLI | `npx superpowers-zh --tool copilot` | `.claude/skills/` |
| [Hermes Agent](https://github.com/NousResearch/hermes-agent) | CLI | `npx superpowers-zh --tool hermes` | `.hermes/skills/` |
| [Cursor](https://cursor.sh) | IDE | `npx superpowers-zh` | `.cursor/skills/` |
| [Windsurf](https://codeium.com/windsurf) | IDE | `npx superpowers-zh` | `.windsurf/skills/` |
| [Kiro](https://kiro.dev) | IDE | `npx superpowers-zh` | `.kiro/steering/` |
| [Gemini CLI](https://github.com/google-gemini/gemini-cli) | CLI | `npx superpowers-zh` | `.gemini/skills/` |
| [Codex CLI](https://github.com/openai/codex) | CLI | `npx superpowers-zh` | `.codex/skills/` |
| [Aider](https://aider.chat) | CLI | `npx superpowers-zh` | `.aider/skills/` |
| [Trae](https://trae.ai) | IDE | `npx superpowers-zh` | `.trae/skills/` + `.trae/rules/` |
| [VS Code](https://code.visualstudio.com) (Copilot) | IDE Plugin | `npx superpowers-zh` | `.github/superpowers/` |
| [DeerFlow 2.0](https://github.com/bytedance/deer-flow) | Agent Framework | `npx superpowers-zh` | `skills/custom/` |
| [OpenCode](https://opencode.ai) | CLI | `npx superpowers-zh` | `.opencode/skills/` |
| [OpenClaw](https://github.com/anthropics/openclaw) | CLI | `npx superpowers-zh` | `skills/` |
| [Qwen Code](https://tongyi.aliyun.com/lingma) (Tongyi Lingma) | IDE Plugin | `npx superpowers-zh` | `.qwen/skills/` |
| [Antigravity](https://github.com/anthropics/antigravity) | CLI | `npx superpowers-zh` | `.antigravity/skills/` |
| [Claw Code](https://github.com/ultraworkers/claw-code) | CLI (Rust) | `npx superpowers-zh` | `.claw/skills/` |
> Running `npx superpowers-zh` will automatically detect the tools used in your project and install 20 skills to the correct location.
### Translated Skills (14)
| Skill | Purpose |
|-------|------|
| **Brainstorming** | Demand analysis → design specifications, no code writing before thinking clearly |
| **Writing Plans** | Breaking down specifications into executable implementation steps |
| **Executing Plans** | Implementing step-by-step, verifying each step |
| **Test-Driven Development** | Strict TDD: writing tests before writing code |
| **Systematic Debugging** | Four-stage debugging: locating → analyzing → hypothesizing → fixing |
| **Requesting Code Review** | Dispatching review agents to check code quality |
| **Receiving Code Review** | Handling review feedback with technical rigor, refusing perfunctory responses |
| **Verification Before Completion** | Evidence-based: verifying before claiming completion |
| **Dispatching Parallel Agents** | Concurrent execution of multiple tasks |
| **Subagent-Driven Development** | One agent per task, two-round review |
| **Using Git Worktrees** | Isolated feature development |
| **Finishing a Development Branch** | Merging/PR/preserving/discarding, four options |
| **Writing Skills** | Methodology for creating new skills |
| **Using Superpowers** | Meta-skill: how to invoke and prioritize skills |
### 🇨🇳 China-specific Skills (6)
| Skill | Purpose | Upstream Available? |
|-------|------|:---:|
| **Chinese Code Review** | Code review specifications adapted to Chinese team culture | No |
| **Chinese Git Workflow** | Git workflow adapted to Gitee/Coding/GitLab | No |
| **Chinese Technical Documentation** | Chinese typesetting, mixed Chinese-English formatting, no machine translation flavor | No |
| **Chinese Commit Conventions** | Commit message specifications adapted to Chinese teams | No |
| **MCP Server Build** | Building production-grade MCP tools, expanding AI capability boundaries | No |
| **Workflow Executor** | Running multi-role YAML workflows within AI tools | No |
---
## Quick Start
### Method 1: npm Installation (Recommended)
```bash
cd /your/project
npx superpowers-zh
```
### Method 2: Manual Installation
```bash
# Clone repository
git clone https://github.com/jnMetaCode/superpowers-zh.git
# Copy skills to your project (choose the tools you use)
cp -r superpowers-zh/skills /your/project/.claude/skills # Claude Code / Copilot CLI
cp -r superpowers-zh/skills /your/project/.hermes/skills # Hermes Agent
cp -r superpowers-zh/skills /your/project/.cursor/skills # Cursor
cp -r superpowers-zh/skills /your/project/.codex/skills # Codex CLI
cp -r superpowers-zh/skills /your/project/.kiro/steering # Kiro
cp -r superpowers-zh/skills /your/project/skills/custom # DeerFlow 2.0
cp -r superpowers-zh/skills /your/project/.trae/rules # Trae
cp -r superpowers-zh/skills /your/project/.antigravity # Antigravity
cp -r superpowers-zh/skills /your/project/.github/superpowers # VS Code (Copilot)
cp -r superpowers-zh/skills /your/project/skills # OpenClaw
cp -r superpowers-zh/skills /your/project/.windsurf/skills # Windsurf
cp -r superpowers-zh/skills /your/project/.gemini/skills # Gemini CLI
cp -r superpowers-zh/skills /your/project/.aider/skills # Aider
cp -r superpowers-zh/skills /your/project/.opencode/skills # OpenCode
cp -r superpowers-zh/skills /your/project/.qwen/skills # Qwen Code
cp -r superpowers-zh/skills /your/project/.claw/skills # Claw Code (Rust)
```
### Method 3: Reference in Configuration Files
Depending on the tool you are using, reference skills in the corresponding configuration file:
| Tool | Configuration File | Description |
|------|---------|------|
| Claude Code | `CLAUDE.md` | Project root directory |
| Copilot CLI | `CLAUDE.md` | Shared plugin format with Claude Code |
| Hermes Agent | `HERMES.md` or `.hermes.md` | Project root directory, automatically generated during installation |
| Kiro | `.kiro/steering/*.md` | Supports always/globs/manual three modes |
| DeerFlow 2.0 | `skills/custom/*/SKILL.md` | ByteDance open-source SuperAgent, automatically discovers custom skills |
| Trae | `.trae/rules/project_rules.md` | Project-level rules |
| Antigravity | `GEMINI.md` or `AGENTS.md` | Project root directory |
| VS Code | `.github/copilot-instructions.md` | Copilot custom instructions |
| Cursor | `.cursor/rules/*.md` | Project-level rules directory |
| OpenClaw | `skills/*/SKILL.md` | Workspace-level skills directory, automatically discovered |
| Windsurf | `.windsurf/skills/*/SKILL.md` | Project-level skills directory |
| Gemini CLI | `.gemini/skills/*/SKILL.md` | Project-level skills directory |
| Aider | `.aider/skills/*/SKILL.md` | Project-level skills directory |
| OpenCode | `.opencode/skills/*/SKILL.md` | Project-level skills directory |
| Hermes Agent | `.hermes/skills/*/SKILL.md` | Project-level skills directory |
| Qwen Code | `.qwen/skills/*/SKILL.md` | Project-level skills directory |
| Claw Code | `.claw/skills/*/SKILL.md` | Rust version CLI agent, compatible with Claude Code's SKILL.md format |
> **Detailed Installation Guide**: [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) · [Hermes Agent](docs/README.hermes.md)
## Contribution
Welcome to participate! Translation improvements, new skills, bug fixes are all welcome.
### Contribution Directions
We only accept skills that align with superpowers' positioning - **AI programming workflow methodology**. Good skills should:
- Teach AI assistants **how to work**, not tutorials on specific frameworks or languages
- Solve **pain points for Chinese developers** not covered by the upstream English version
- Have clear steps, checklists, examples, and allow AI to execute directly after loading
Feel free to raise an issue to discuss your ideas!
## Communication · Community
WeChat public account **"AI 不止语"** (search `AI_BuZhiYu` on WeChat) - Technical Q&A · Project updates · Practical articles
| Channel | Join Method |
|------|---------|
| QQ Group 2 | [Click to join](https://qm.qq.com/q/EeNQA9xCxy) (group number 1071280067) |
| WeChat Group | Follow the public account and reply "group" to get the joining method |
## 🌟 Related Project Ecosystem
**Five projects combined use, covering the complete chain of AI programming from "methodology → roles → collaboration → tutorials → security".**
| Project | Positioning | One-sentence description |
|------|------|-------|
| **[superpowers-zh](https://github.com/jnMetaCode/superpowers-zh)** (this project)  | 🧠 Workflow methodology | 20 skills teach AI how to work (TDD / debugging / code review, etc.) |
| **[agency-agents-zh](https://github.com/jnMetaCode/agency-agents-zh)**  | 🎭 Expert role library | 211 **plug-and-play** AI experts, including 46 China originals (Little Red Book / Douyin / Feishu / DingTalk) |
| **[agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator)** | 🚀 Orchestration engine | One sentence → 211 expert collaboration, **minutes to deliver a complete plan** (9 LLM / 6 free) |
| **[ai-coding-guide](https://github.com/jnMetaCode/ai-coding-guide)** | 📖 Practical tutorial | 66 Claude Code tips + 9 tool best practices + configuration templates |
| **[shellward](https://github.com/jnMetaCode/shellward)** | 🛡️ Security middleware | 8-layer defense + DLP data flow + injection detection, **zero dependencies** (including MCP Server) |
### 🔥 Featured Recommendation: [agency-orchestrator](https://github.com/jnMetaCode/agency-orchestrator) - One sentence schedules 211 AI expert collaboration, minutes to deliver a complete plan
Previously, writing a plan: you as the commander, let AI take turns playing 5 roles, copy and paste 10 times, 1 hour gone.
**Now:** throw a sentence into `"Make an e-commerce refund process"`, **product → architecture → security → testing → DBA automatic relay**, minutes to complete plan landing.
- 🎭 **211+ expert roles** (including 46 China market originals: Little Red Book / Douyin / WeChat / Feishu / DingTalk)
- 🧩 **Zero-code YAML**, one-line prompt can run
- 💰 **9 LLM options** (DeepSeek / Claude / OpenAI / Ollama, etc., **6 free**)
- 🔗 **Complementary to superpowers-zh**: this project manages "**how to do**" (methodology), orchestrator manages "**who does**" (role collaboration)
👉 **[Experience agency-orchestrator immediately →](https://github.com/jnMetaCode/agency-orchestrator)**
## Acknowledgments
- Original English version: [obra/superpowers](https://github.com/obra/superpowers) (MIT license)
- Thanks to [@obra](https://github.com/obra) for creating this excellent project
## License
MIT License - Free use for commercial or personal purposes.
<div align="center">
**🦸 AI Programming Superpowers: Let Claude Code / Hermes Agent / Cursor / Claw Code and 17 other tools really work**
[Star this project](https://github.com/jnMetaCode/superpowers-zh) · [Submit Issue](https://github.com/jnMetaCode/superpowers-zh/issues) · [Contribute Code](https://github.com/jnMetaCode/superpowers-zh/pulls)
</div>
