1
Superpowers 入门：给 AI 装上一套开发方法论
Superpowers 入门：给 AI 装上一套开发方法论 更新日期：2026/06 TL;DR： Superpowers 是一套完整的 AI 编程方法论，通过可组合的技能（skills）系统强制执行"先理解、再设计、后实现"的工作流。它不让 AI 一上来就写代码，而是先通过 brainstorming 把模糊需求拆...
工具链更新于
Superpowers 详解：给 Claude Code 装上开发方法论
18 篇文章拆解 Superpowers 框架，从 Skills 系统到 TDD 执行、调试工作流、并行代理、跨平台适配，覆盖 Claude Code 工程化的完整知识体系。
18 篇文章0 人订阅 创建
专栏简介
适合已经在用 Claude Code 并希望系统化提升工程效率的开发者。专栏覆盖：Skills 系统原理、description 与 CSO 机制、Hooks/CLAUDE.md/Skill/Command 边界、brainstorming 到 writing-plans 工作流、git worktree 隔离、Subagent-Driven Development、TDD 执行、systematic-debugging 根因分析、verification 与 code review、分支管理、模型选择与成本控制、并行代理调度、自定义 Skill 编写、跨平台适配（Cursor/Codex/Copilot/Gemini），以及使用边界和避坑指南。建议按顺序阅读。
文章目录
2
Superpowers 原理 · Skills 系统是什么
Superpowers 原理 · Skills 系统是什么 更新日期：2026/06 TL;DR： Skills 是 Superpowers 的核心机制。每个技能是一个 YAML + Markdown 文件，定义了特定场景下的强制工作流。系统在会话启动时扫描所有技能的 frontmatter，根据任务自动匹配和触发。...
3
Superpowers 原理 · description 字段与 CSO
Superpowers 原理 · description 字段与 CSO 更新日期：2026/06 TL;DR： Description 字段是技能的"广告牌"，决定 AI 能否找到它。黄金法则： 只写触发条件，不写流程 。Obra 实验数据显示，description 总结工作流会导致 AI 跳过技能完整内容。好的...
4
Superpowers 原理 · Hooks / CLAUDE.md / Skill / Command 的边界
Superpowers 原理 · Hooks / CLAUDE.md / Skill / Command 的边界 更新日期：2026/06 TL;DR： 四件套各司其职。Hooks 在会话启动时自动执行，负责注入技能系统。CLAUDE.md/AGENTS.md/GEMINI.md 是项目配置层，定义偏好和规则。Ski...
5
Superpowers 工作流 · brainstorming：把模糊需求拆成 spec
Superpowers 工作流 · brainstorming：把模糊需求拆成 spec 更新日期：2026/06 TL;DR： brainstorming 技能在写任何代码前强制执行。它通过苏格拉底式追问把模糊需求变成明确设计，分段展示设计让你确认，最后保存为 spec 文档。不是"聊几句"，而是系统的需求工程流程...
6
Superpowers 工作流 · writing-plans：2-5 分钟一颗任务
Superpowers 工作流 · writing plans：2 5 分钟一颗任务 更新日期：2026/06 TL;DR： writing plans 把 spec 拆成 2 5 分钟可完成的任务。每个任务包含精确文件路径、完整代码、运行命令、预期输出。没有 "TBD"、"TODO"、"后续补充"。目标是让一个零上...
7
Superpowers 原理 · git worktrees：隔离工作区
Superpowers 原理 · git worktrees：隔离工作区 更新日期：2026/06 TL;DR： Superpowers 强制使用 git worktrees 创建隔离工作区。worktree 是 git 的原生功能，允许在同一个仓库的多个目录下同时工作。与分支不同，worktree 提供独立的文件系...
8
Superpowers 工作流 · Subagent-Driven Development 整体流程
Superpowers 工作流 · Subagent Driven Development 整体流程 更新日期：2026/06 TL;DR： Subagent Driven Development（SDD）通过派子代理执行任务，每任务两阶段审查（spec 合规性 → 代码质量）。核心是上下文隔离：每个子代理只拿到完成...
9
Superpowers 工作流 · 三种 subagent prompt 详解
Superpowers 工作流 · 三种 subagent prompt 详解 更新日期：2026/06 TL;DR： SDD 用三种 prompt 派不同的子代理。Implementer prompt 告诉子代理做什么、怎么问问题、如何自我审查。Spec Compliance Reviewer prompt 告诉子...
10
Superpowers 工作流 · TDD 是怎么被严格执行的
Superpowers 工作流 · TDD 是怎么被严格执行的 更新日期：2025/06 TL;DR： Superpowers 通过「铁律」强制执行 TDD——写了代码先于测试？删掉重来。RED GREEN REFACTOR 三个阶段每步都验证：测试先写并确实失败、最小实现、重构保持测试通过。违反规则的合理化借口都被...
11
Superpowers 工作流 · systematic-debugging 根因分析四阶段
Superpowers 工作流 · systematic debugging 根因分析四阶段 更新日期：2025/06 TL;DR： Superpowers 把 debug 拆成四个强制阶段：先查根因、再找模式、然后假设测试、最后实现。不允许没查根因就修 bug，不允许「试试这个先」，不允许 3 次修复失败后继续修—...
12
Superpowers 工作流 · verification-before-completion 与 code review
Superpowers 工作流 · verification before completion 与 code review 更新日期：2025/06 TL;DR： Superpowers 把「完成」独立成一个阶段，不允许修完代码就说完成。必须先验证：跑命令、读输出、数失败数，然后才能声明状态。code review...
13
Superpowers 工作流 · finishing-a-development-branch：合并、PR、清理
Superpowers 工作流 · finishing a development branch：合并、PR、清理 更新日期：2025/06 TL;DR： Superpowers 把分支完成独立成一个技能，避免「写完代码就不知道下一步」的混乱。强制先验证测试再给选项，然后根据环境检测（普通仓库 vs worktree...
14
Superpowers 进阶 · 模型选择与成本控制
Superpowers 进阶 · 模型选择与成本控制 更新日期：2025/06 TL;DR： 不同角色用不同档位模型：implementer 用 Haiku/Sonnet 快速执行，reviewer 用 Sonnet 平衡质量和成本，controller 用 Opus 做复杂决策。任务复杂度信号：文件数、跨模块、安全...
15
Superpowers 进阶 · dispatching-parallel-agents：并行 subagent
Superpowers 进阶 · dispatching parallel agents：并行 subagent 更新日期：2025/06 TL;DR： 3+ 个独立失败时串行调查是浪费。每个失败独立，可以并行。每个 agent 分配一个问题域，精确定义范围和约束。不共享状态、不互相干扰。工程手段：独立范围、约束边界...
16
Superpowers 元技巧 · 用 TDD 写一个自己的 skill
Superpowers 元技巧 · 用 TDD 写一个自己的 skill 让 AI 在不同项目、不同会话里稳定遵守同一条规则，是 skill 的核心价值。 TL;DR ：superpowers 把"写 skill"看作"把 TDD 应用到文档"。测试用例是 pressure scenario（让 subagent 在...
17
Superpowers 跨平台 · 在 Cursor / Codex / Copilot / Gemini 上跑起来
Superpowers 跨平台 · 在 Cursor / Codex / Copilot / Gemini 上跑起来 同一份 skill 文档，8 个平台共用。差异只在那一层薄薄的 hook。 TL;DR ：superpowers 不是 Claude Code 独占。它支持 Claude Code、Codex CLI...
18
Superpowers 边界 · 什么情况不该用，以及避坑指南
Superpowers 边界 · 什么情况不该用，以及避坑指南 superpowers 的整套流程很重。把它套在所有任务上，会让简单的事情变复杂；不用它，又怕 AI 跑偏。这篇拆边界和踩坑。 TL;DR ：superpowers 是一套"重型工程化方法论"，适合多步骤、需要审查、出错的代价高于流程成本的任务。它不适合...