# Using Superpowers

> 开始任何对话时使用 - 建立如何查找和使用技能，要求在任何回复（包括澄清问题）前调用 Skill tool

- Skill: `vinvcn/using-superpowers` (Agent Skill, multi-file: 4 files)
- Install (CLI): `npx skillmds@latest add vinvcn/using-superpowers`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vinvcn/using-superpowers/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: vinvcn (https://skillmd.com/u/vinvcn)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vinvcn/using-superpowers

---


<SUBAGENT-STOP>
如果你是作为 subagent 被派发来执行特定任务，跳过此技能。
</SUBAGENT-STOP>

<EXTREMELY-IMPORTANT>
如果你认为哪怕只有 1% 的可能性某个技能适用于你正在做的事，你都绝对必须调用该技能。

如果某个技能适用于你的任务，你没有选择。你必须使用它。

这没有商量余地。这不是可选项。你不能通过合理化来逃避它。
</EXTREMELY-IMPORTANT>

## 指令优先级

Superpowers skills 会覆盖默认 system prompt 行为，但**用户指令始终优先**：

1. **用户的明确指令**（CLAUDE.md、GEMINI.md、AGENTS.md、直接请求）— 最高优先级
2. **Superpowers skills** — 在冲突处覆盖默认 system 行为
3. **默认 system prompt** — 最低优先级

如果 CLAUDE.md、GEMINI.md 或 AGENTS.md 说“不要使用 TDD”，而某个技能说“始终使用 TDD”，遵循用户指令。用户掌控全局。

## 如何访问技能

**在 Claude Code 中：** 使用 `Skill` tool。调用技能时，其内容会被加载并呈现给你 — 直接遵循它。绝不要对技能文件使用 Read tool。

**在 Copilot CLI 中：** 使用 `skill` tool。技能会从已安装 plugins 中自动发现。`skill` tool 的工作方式与 Claude Code 的 `Skill` tool 相同。

**在 Gemini CLI 中：** 技能通过 `activate_skill` tool 激活。Gemini 会在会话开始时加载技能元数据，并按需激活完整内容。

**在其他环境中：** 查看你的平台文档，了解技能如何加载。

## 平台适配

技能使用 Claude Code tool 名称。非 CC 平台：查看 `references/copilot-tools.md`（Copilot CLI）、`references/codex-tools.md`（Codex）了解等价 tool。Gemini CLI 用户会通过 GEMINI.md 自动加载 tool 映射。

# 使用技能

## 规则

**在任何回复或行动之前调用相关或被请求的技能。** 哪怕只有 1% 的可能性某个技能适用，也意味着你应该调用该技能进行检查。如果调用后发现某个技能不适合当前情况，你不需要使用它。

```dot
digraph skill_flow {
    "User message received" [shape=doublecircle];
    "About to EnterPlanMode?" [shape=doublecircle];
    "Already brainstormed?" [shape=diamond];
    "Invoke brainstorming skill" [shape=box];
    "Might any skill apply?" [shape=diamond];
    "Invoke Skill tool" [shape=box];
    "Announce: 'Using [skill] to [purpose]'" [shape=box];
    "Has checklist?" [shape=diamond];
    "Create TodoWrite todo per item" [shape=box];
    "Follow skill exactly" [shape=box];
    "Respond (including clarifications)" [shape=doublecircle];

    "About to EnterPlanMode?" -> "Already brainstormed?";
    "Already brainstormed?" -> "Invoke brainstorming skill" [label="no"];
    "Already brainstormed?" -> "Might any skill apply?" [label="yes"];
    "Invoke brainstorming skill" -> "Might any skill apply?";

    "User message received" -> "Might any skill apply?";
    "Might any skill apply?" -> "Invoke Skill tool" [label="yes, even 1%"];
    "Might any skill apply?" -> "Respond (including clarifications)" [label="definitely not"];
    "Invoke Skill tool" -> "Announce: 'Using [skill] to [purpose]'";
    "Announce: 'Using [skill] to [purpose]'" -> "Has checklist?";
    "Has checklist?" -> "Create TodoWrite todo per item" [label="yes"];
    "Has checklist?" -> "Follow skill exactly" [label="no"];
    "Create TodoWrite todo per item" -> "Follow skill exactly";
}
```

## 危险信号

出现这些想法意味着停止 — 你正在合理化逃避：

| 想法 | 现实 |
|---------|---------|
| “这只是一个简单问题” | 问题也是任务。检查技能。 |
| “我需要先了解更多上下文” | 技能检查发生在澄清问题之前。 |
| “让我先探索代码库” | 技能会告诉你如何探索。先检查。 |
| “我可以快速检查 git/文件” | 文件没有对话上下文。检查技能。 |
| “让我先收集信息” | 技能会告诉你如何收集信息。 |
| “这不需要正式技能” | 如果技能存在，就使用它。 |
| “我记得这个技能” | 技能会演进。阅读当前版本。 |
| “这不算任务” | 行动 = 任务。检查技能。 |
| “这个技能太重了” | 简单事情会变复杂。使用它。 |
| “我就先做这一件事” | 做任何事之前先检查。 |
| “这感觉很有效率” | 无纪律的行动会浪费时间。技能会防止这种情况。 |
| “我知道那是什么意思” | 知道概念 ≠ 使用技能。调用它。 |

## 技能优先级

当多个技能可能适用时，按此顺序使用：

1. **流程技能优先**（brainstorming、debugging）- 它们决定如何处理任务
2. **实现技能其次**（frontend-design、mcp-builder）- 它们指导执行

“我们来构建 X” → 先使用 brainstorming，然后使用实现技能。
“修复这个 bug” → 先使用 debugging，然后使用领域特定技能。

## 技能类型

**刚性**（TDD、debugging）：严格遵循。不要为了适配而削弱纪律性。

**灵活**（patterns）：将原则适配到上下文。

技能本身会告诉你它属于哪一种。

## 用户指令

指令说明要做什么，而不是怎么做。“Add X”或“Fix Y”并不意味着跳过工作流。