1 🦸 superpowers-zh（AI 编程超能力 · 中文版）全景指南

一句话定义：superpowers-zh 是 GitHub 上最火的 AI 编程技能框架 superpowers (250k+ ⭐) 的完整中文增强版。它为 Claude Code、Cursor、Antigravity、Trae 等 20 款主流 AI 编程工具提供了一套严格的、可重复执行的软件工程标准作业程序 (SOP)。

1.1 📌 目录

1. 这个仓库是干嘛的？（核心价值与对比）
2. 20 个技能库全景分类地图 (Skill Directory)
3. superpowers-zh 的标准六步工作流 (The Master SOP Workflow)
4. superpowers-zh 核心硬约束与反模式防护
5. 如何在 Obsidian 中高效使用本指南

1.2 这个仓库是干嘛的？（核心价值与对比）

1.2.1 💡 解决什么痛点？

大部分人在使用 AI 编程时，经常遇到以下 “AI 乱干活” 的典型故障：

直接动手：你刚说一句“加个导出功能”，AI 不问细节直接开始写了几百行代码，最后发现逻辑全错。
凭空幻想：AI 没写测试，光靠自己口头承诺“我已经写好了，绝对没 Bug”。
上下文爆炸：AI 试图在单个会话中把所有模块重构完，导致 Token 溢出、出现幻觉、越改越乱。

1.2.2 🛡️ superpowers-zh 的解决方案

它注入了一套硬性防护关卡 (Hard Gates) 与 方法论 (Skills)：

强制规约：在未得到用户批准的设计规格书（Spec）之前，绝对禁止编写任何代码。
证据至上：在未运行真实 Bash 命令抓取日志证明测试通过前，绝对禁止声称“已完成”。
环境隔离：使用子 Agent (Subagent) 或 Git Worktree 执行具体任务，保持上下文干净。

1.3 20 个技能库全景分类地图 (Skill Directory)

superpowers-zh 包含 20 个独立技能，每个技能都是一个包含明确检查清单（Checklist）和决策流程图的 Prompt 指南。

superpowers-zh/skills/
├── 核心工作流 (Brainstorming -> Plan -> Execute -> Finish)
├── 工程纪律 (TDD, Systematic Debugging, Code Review, Verification)
└── 中国特色扩展 (Chinese Docs, Git, Commit, Code Review, MCP, Workflow)

1.3.1 核心工作流技能 (Core Workflow - 8个)

技能名称 (ID)	类型	核心作用与使用时机
头脑风暴 (`brainstorming`)	自动	需求分析与设计规格书。在做任何功能之前强制触发，通过提问探索意图，给出 2-3 个选择方案，合成 `YYYY-MM-DD-topic-design.md` 规格书。
编写计划 (`writing-plans`)	自动	任务切片。将头脑风暴产生的设计规格书拆解为可被单个 Agent 执行的、粒度极小的“实施计划（Plan）”。
执行计划 (`executing-plans`)	自动	单进程按计划实施。按计划一步步编写代码，每完成一步必须立即进行验证。
子 Agent 驱动开发 (`subagent-driven-development`)	自动	上下文隔离实施。为主计划中的每个 Task 派生一个全新的子 Agent 独立去写代码，并由主 Agent 审查，防止上下文污染。
派遣并行 Agent (`dispatching-parallel-agents`)	自动	多任务并发。对于彼此没有依赖关系的独立 Task，同时派生多个子 Agent 并行开发。
Git Worktree 使用 (`using-git-worktrees`)	自动	代码目录隔离。为大的特性开发创建独立的 Git Worktree 隔离目录，避免污染主工作区。
完成开发分支 (`finishing-a-development-branch`)	自动	收尾与合并。分支开发完成后，提供“合并/发 PR/保留/丢弃”4 选 1 收尾方案。
元技能：使用超能力 (`using-superpowers`)	元技能	技能调度引擎。教 AI 如何在合适的时机主动调用其他技能。

1.3.2 工程纪律与质量保证 (Engineering Discipline - 6个)

技能名称 (ID)	类型	核心作用与使用时机
测试驱动开发 (`test-driven-development`)	自动	严格 TDD 循环。遵循“先写失败测试(Red) -> 仅编写刚好能通过的代码(Green) -> 重构(Refactor)”的铁律。
系统化调试 (`systematic-debugging`)	自动	四阶段科学排错法。放弃瞎猜！分为：1.现象定位 2.最小复现 3.科学假设 4.代码修复。
请求代码审查 (`requesting-code-review`)	自动	自我拉取 PR。派生一个独立的审查子 Agent 按照 Fowler 代码坏味道对当前 Diff 进行严格审查。
接收代码审查 (`receiving-code-review`)	自动	理性对待反馈。教 AI 严谨对待审查意见，不敷衍、不盲从盲改，用技术证据回复。
完成前验证 (`verification-before-completion`)	自动	证据先行关卡。在跟用户说“我做好了”之前，强制运行命令行测试并展示真实成功的 Console 输出。
编写 Skills (`writing-skills`)	工具	技能元生成器。当你想为自己的团队编写自定义 Skill 时，提供编写标准化 Skill 的方法论。

1.3.3 中国本土特色扩展 (China Specific Extensions - 6个)

💡 提示：带 chinese-* 前缀的 4 个技能为显式手动技能（在对话中输入 /chinese-xxx 触发），设计上不污染通用自动工作流。

技能名称 (ID)	类型	核心作用与使用时机
中文代码审查 (`chinese-code-review`)	手动	适配国内团队的沟通文化与代码规范（告别西方过度犀利的措辞，强调建设性反馈）。
中文 Git 工作流 (`chinese-git-workflow`)	手动	专门适配 Gitee、Coding、极狐 GitLab、腾讯 CNB 等国内 Git 平台和 CI/CD 流程。
中文技术文档 (`chinese-documentation`)	手动	中文技术写作与排版规范（中英文混排加空格、告别机翻味、格式化规范）。
中文提交规范 (`chinese-commit-conventions`)	手动	适配国内团队的 Conventional Commits 规范（如 `feat(用户模块): 新增手机号注册`）。
MCP 服务器构建 (`mcp-builder`)	自动	生产级 MCP 扩展。帮助 AI 为工具快速构建符合 Model Context Protocol 规范的服务器插件。
工作流执行器 (`workflow-runner`)	自动	多角色 YAML 编排。在 AI 工具内部直接解析并运行 YAML 格式的多 Agent 协作流水线。

1.4 superpowers-zh 的标准六步工作流 (The Master SOP Workflow)

在实际日常开发中，superpowers-zh 引导 AI 按照一条严格的管道流水线 (Pipeline) 来完成任务：

flowchart TD
    Start([用户提出需求]) --> Step1

    subgraph 阶段一：方案设计
        Step1["1. 头脑风暴 (brainstorming)<br/>- 查看项目上下文<br/>- 每次只抛出 1 个提问<br/>- 提供 2-3 个方案及权衡<br/>- 生成 YYYY-MM-DD-topic-design.md"]
    end

    subgraph 阶段二：任务拆解
        Step1 -->|用户批准设计| Step2["2. 编写计划 (writing-plans)<br/>- 将 Spec 拆解为极其详尽的 Task 清单<br/>- 每个 Task 包含明确的验收标准"]
    end

    subgraph 阶段三：隔离执行
        Step2 -->|用户批准计划| Step3{"选择执行模式"}
        Step3 -->|简单任务| Step3A["执行计划 (executing-plans)"]
        Step3 -->|复杂/多模块任务| Step3B["子 Agent 驱动开发 (subagent-driven-development)"]
        
        Step3A --> Step4["4. 测试驱动开发 (TDD)<br/>- Red: 先写失败测试<br/>- Green: 补最简实现代码<br/>- Refactor: 重构"]
        Step3B --> Step4
    end

    subgraph 阶段四：验证与审查
        Step4 --> Step5["5. 证据先行验证 (verification-before-completion)<br/>- 必须在终端跑通命令<br/>- 打印出成功的真实 Log 证据"]
        Step5 --> Step6["6. 请求与接收审查 (code-review)<br/>- 派遣独立 Agent 双向代码审查<br/>- 确认无遗留 Bug"]
    end

    Step6 --> End([完成收尾 finishing-a-development-branch])

    style Step1 fill:#f9f,stroke:#333,stroke-width:2px
    style Step4 fill:#bbf,stroke:#333,stroke-width:2px
    style Step5 fill:#dfd,stroke:#333,stroke-width:2px

1.5 superpowers-zh 核心硬约束与反模式防护

在每个技能的文档头部，都包含被称为 <HARD-GATE>（硬关卡）的全局拦截规约：

🚫 禁止“直接动手” (Anti-Pattern: “Too simple to design”)：
- 哪怕只是修改一个简单的配置或加一个微小的待办事项，也必须先经过 brainstorming 生成极简设计并获得用户确认。
🚫 禁止“口头承诺” (Anti-Pattern: “Trust me it works”)：
- 在向用户报告“已完成”之前，必须由 verification-before-completion 运行终端命令并展示成功的 Console 日志证据。
🚫 禁止“上下文混用” (Anti-Pattern: Context Pollution)：
- 主控 Agent 只做调度和评审，具体的代码修改尽量推给 subagent-driven-development 产生的临时子 Agent 独立完成。

1.6 如何在 Obsidian 中高效使用本指南

建立双向链接 (Backlinks)：
- 在您的项目笔记中，每当需要 AI 帮你写复杂功能时，可以引用本指南中的节点，如：[[superpowers-zh 全景指南#头脑风暴]]。
标签检索 (Tags)：
- 本笔记包含了 #AI编程 #superpowers-zh #智能体框架 标签，方便在 Obsidian 的标签面板中统一筛选。
配合日常 Prompt：
- 当您发觉 AI 在偷懒或直接动手写代码时，直接复制对应技能的规则或提示它：“请严格遵循 superpowers-zh 的 brainstorming 技能，每次只问我一个问题，先提供 2-3 个方案。”

tags	ai编程, superpowers-zh, 智能体框架, 软件工程sop, obsidian知识库
aliases	superpowers-zh 智能体技能与工作流全景图

教学知识库

探索

superpowers_zh