你有没有遇到过这种情况？

你对 AI 编程助手说："帮我做一个待办事项应用"。它立刻开始写代码——文件一个接一个地涌出，几百行代码出现在屏幕上。然后你发现：它完全猜错了你的需求。

这是 AI 编程助手 的默认行为：收到请求就行动，没有停下来问"你真正想要的是什么？"

装上 Superpowers 之后，同样这句话会发生什么

你说："帮我做一个待办事项应用"。这次，AI 助手不会立刻写代码。它会先触发 brainstorming（头脑风暴）技能，问你：

什么是"技能"（Skill）？

把 AI 编程助手想象成一个刚加入团队的新人。他很聪明，但不了解你们团队的工作规范——什么时候写测试、怎么做代码审查、遇到 Bug 先查什么。

技能（Skill）就是这份操作手册。每个技能文件描述一个具体的工作场景和对应的操作流程。

为什么这对你很重要？

如果你用自然语言指挥 AI 工具来构建软件，你可能遇到过这些困境：

快速检验：你理解了吗？

认识主要角色

想象一下一家运转良好的公司：有人写规章制度，有人负责入职培训，有人在需要时自动发出提醒。Superpowers 也是这样分工的。

一个技能文件长什么样？

每个技能文件是一个 Markdown 文档，包含三个关键部分。我们来看 brainstorming 技能的开头：

---
name: brainstorming
description: "You MUST use this before
 any creative work - creating
 features, building components..."
---

# Brainstorming Ideas Into Designs

<HARD-GATE>
Do NOT invoke any implementation
skill, write any code, scaffold
any project, or take any action
until design is approved.
</HARD-GATE>

点击查看各组件的职责

下面是 Superpowers 的完整架构图。点击任意组件，了解它的作用。

架构理解测验

AI 助手的内心决策流程

当你发送一条消息时，装了 Superpowers 的 AI 助手不会直接回答。它先走一遍内部决策流程：

一次技能调用的全过程（对话演示）

想象你说了一句"我想给 App 加一个深色模式"。下面是 AI 内部"对话"的展开过程：

技能如何知道「这次该用我」？

每个技能文件顶部的 description 字段就是匹配的钥匙。

AI 助手在决策时，会把你的消息与每个技能的 description 做语义匹配。description 写得越精准，触发越准确。

description: "You MUST use this
 before any creative work -
 creating features, building
 components, adding functionality,
 or modifying behavior. Explores
 user intent, requirements and
 design before implementation."

防止 AI 偷懒的「红旗清单」

using-superpowers 技能里有一张特别有意思的表格——「Red Flags（红旗）」。它列出了 AI 最常见的自我欺骗借口，以及这些借口背后的真相：

技能触发机制测验

像邮政系统一样分发任务

想象一家大型快递公司的分拣中心。每个包裹到达后，中心不会让同一个工人从头跑到尾——它把包裹按目的地分类，分发给不同的快递员同时派送。

子 Agent 就是这些快递员：接到精确指令，执行一个任务，完成后汇报。

subagent-driven-development 的执行流程

点击「下一步」，跟随一个任务从计划到完成的完整旅程：

两阶段代码审查：为什么要分两次？

subagent-driven-development 的核心设计：完成每个任务后，总是经过两次独立审查，而不是一次。

## Two-Stage Review

Stage 1: Spec Compliance Review
- Does code match the spec?
- Are all requirements met?
- Missing functionality?

Stage 2: Code Quality Review
- Is the code clean?
- Error handling correct?
- Test coverage adequate?

并行执行 vs 顺序执行

Superpowers 有两种执行模式，选哪个取决于任务之间是否相互依赖：

Agent 调度模式测验

钩子（Hook）是什么？

把钩子想象成门铃感应器：你一进门，感应器自动触发，灯就亮了。你不需要手动开灯——它在你行动的那一刻自动响应。

Hook（钩子）就是这种「事件触发自动运行」的机制。

{
  "hooks": {
    "SessionStart": [
      {
        "matcher": "startup|clear|compact",
        "hooks": [{
          "type": "command",
          "command": "run-hook.cmd session-start",
          "async": false
        }]
      }
    ]
  }
}

session-start 脚本做了什么？

当你打开 AI 编程工具时，session-start 脚本悄悄完成了这几件事：

session-start 脚本的核心逻辑

这是脚本里最重要的部分——平台适配逻辑：

if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
  printf '{"additional_context":"%s"}' \
    "$session_context"
elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] \
  && [ -z "${COPILOT_CLI:-}" ]; then
  printf '{"hookSpecificOutput":
    {"additionalContext":"%s"}}' \
    "$session_context"
else
  printf '{"additionalContext":"%s"}' \
    "$session_context"
fi

如果没有 Hook，技能还能用吗？

CLAUDE.md 明确指出：「没有 using-superpowers bootstrap 的集成不是真正的集成」。让我们看看有没有 Hook 的区别：

钩子机制测验

完整工作流的 7 个阶段

Superpowers 的 README 描述了一个完整的开发工作流。我们用「给电商 App 添加购物车功能」来走一遍全程：

TDD 技能的核心：铁律

TDD 的哲学不复杂，但执行要求非常严格。test-driven-development 技能里有一段「铁律」：

## The Iron Law

NO PRODUCTION CODE
WITHOUT A FAILING TEST FIRST

Write code before the test? Delete it.
Start over.

## No exceptions:
- Don't keep it as "reference"
- Don't "adapt" it while writing tests
- Don't look at it
- Delete means delete

动手练习：组装一个技能文件

现在你理解了技能的结构，来试试把一个技能文件的各个部分对应到正确的区域：

理解 Superpowers 让你成为更好的 AI 指挥官

学完这门课，你获得了什么？不只是「Superpowers 是什么」的知识，而是在实际使用中能用上的技能：

综合测验：你能指挥 Superpowers 了吗？

你现在掌握了什么？