Superpowers 是一套高效能 Agent Skills 工作流，本篇介绍其中三个核心 skill：using-superpowers、brainstorming、writing-plans
这三个 skill 按顺序推进，构成"动手之前"的防线
using-superpowers：任何行动前先查 skill
Agent 拿到任务往往直接行动，跳过可能更适合当前场景的 skill。using-superpowers 把"查 skill"变成固定前置动作。
核心规则：
"If you think there is even a 1% chance a skill might apply to what you are doing, you ABSOLUTELY MUST invoke the skill."
多个 skill 并存时，流程类 skill 先于实现类——brainstorming、systematic-debugging 这些 skill 决定怎么做，领域 skill（如 frontend-design）才决定怎么做好。用户指令的优先级高于所有 Superpowers skill。
源码整理了一份常见的自我合理化清单，遇到这些念头就该停下：
- "这只是个简单问题" → 问题也是任务，先查 skill
- "我需要先了解上下文" → skill 告诉你怎么收集上下文
- "我记得这个 skill 的内容" → Skill 在演进，读当前版本
- "这个 skill 太重了" → 简单事情会变复杂，用 skill
brainstorming：设计获批前不写代码
brainstorming 的触发面很宽：新功能、新组件、行为修改，乃至看起来很小的配置变更。凡是创造性工作都适用。
最重要的约束：
"Do NOT invoke any implementation skill, write any code, scaffold any project, or take any implementation action until you have presented a design and the user has approved it."
设计通过后，只允许调用 writing-plans——不能直接跳到 frontend-design、mcp-builder 或其他实现 skill。
设计 spec 通常要覆盖：
- 架构：改动放在哪一层，如何融入现有系统
- 组件：新建或修改哪些模块、边界和接口
- 数据流：输入、处理、输出
- 错误处理：异常和边界条件如何表现
- 测试：后续如何证明实现符合设计
自查后请用户 review，确认后才进入 writing-plans。spec 默认落盘并提交到 git：docs/superpowers/specs/YYYY-MM-DD--design.md
writing-plans：让执行者只凭文档就能开工
Plan 不依赖聊天记录——背景、文件路径、代码、命令、预期输出都要写进文档，无论读者是人还是新开的子 Agent，都应能只凭 plan 开工。
源码的表述：
"Write comprehensive implementation plans assuming the engineer has zero context for our codebase and questionable taste."
写 plan 的顺序
先做 scope check：如果 spec 覆盖多个独立子系统却没有在 brainstorming 阶段拆开，就先提醒拆分。一个 plan 最好产出一块可以独立运行、独立测试的软件。
文件结构要先于任务列表落地，经常一起改动的文件应该住在一起。
任务节奏
每个任务内部按 TDD 节奏走：
- 写失败测试
- 运行确认失败
- 写最小实现
- 运行确认通过
- 提交
每一步是一个具体动作，带明确命令和预期结果。源码把以下写法标为 plan failures——永远不该出现：
- "TBD", "TODO", "implement later"
- "Add appropriate error handling"
- "Write tests for the above"（没有给出测试代码）
- "Similar to Task N"（执行者可能乱序阅读，要重复代码）
plan 文件固定 header
每份 plan 必须从以下结构开始：
# [Feature Name] Implementation Plan
> **For agentic workers:** REQUIRED SUB-SKILL: Use superpowers:subagent-driven-development
> (recommended) or superpowers:executing-plans to implement this plan task-by-task.
> Steps use checkbox (`- [ ]`) syntax for tracking.
**Goal:** [一句话描述目标]
**Architecture:** [2~3 句描述方案]
**Tech Stack:** [关键技术/库]苏米注：这三个 skill 的核心思想是"先想清楚再动手"。using-superpowers 防止绕过已有流程，brainstorming 强制经历澄清和方案比较，writing-plans 把设计变成可独立执行的步骤。对于复杂项目来说，这套工作流能显著减少返工和沟通成本。