学习路径指南
难度等级
初级
预计时长
2-3小时
适合人群
希望利用AI编程助手(如Claude Code)进行更结构化、高质量软件开发的开发者,尤其是对AI辅助编程感兴趣但缺乏系统化工作流经验的新手。

学习目标:学会如何为你的AI编程助手安装并配置Superpowers,理解其核心工作流,并能够利用它引导AI完成从需求澄清、设计、计划到自动化实施和审查的完整软件开发过程。

前置知识

Shell基础 了解

项目本身是Shell脚本,安装和部分配置需要在终端中操作。

Git基础 了解

项目工作流中会使用Git进行分支管理和代码提交。

AI编程助手(Claude Code/Codex/OpenCode) 熟悉

Superpowers是一个运行在AI编程助手之上的工作流系统,你需要至少拥有其中一个助手的使用经验。

学习步骤

1

环境准备与安装

30分钟

选择并确认你的AI编程助手

根据README,确认你使用的是Claude Code、Codex还是OpenCode。这将决定你的安装方式。

Claude Code的安装最简单,因为它有插件市场。如果你是新手,建议从Claude Code开始体验。

按照对应平台指南安装

根据你选择的助手,严格遵循README中的安装步骤。例如,对于Claude Code,需要先注册插件市场,然后安装Superpowers插件。

安装后务必执行“Verify Installation”步骤,确认相关命令已成功加载到你的AI助手中。

查阅详细文档

如果你的助手是Codex或OpenCode,前往项目docs目录下阅读对应的详细文档(README.codex.md或README.opencode.md)。

即使安装成功,也建议快速浏览文档,了解可能的高级配置或特定于该助手的注意事项。

2

快速入门:体验核心工作流

1小时

启动一个简单的编码任务

在你的AI编程助手中,提出一个明确的、小型的编码需求(例如:“帮我写一个Python函数,计算斐波那契数列”)。

选择一个你熟悉的语言和简单问题,这样你可以专注于观察Superpowers的工作流,而不是被复杂逻辑分心。

观察并参与“brainstorming”阶段

注意AI助手不会立即写代码,而是会开始提问以澄清需求。积极回答这些问题,帮助它生成一个清晰的设计规格。

这是Superpowers的核心价值之一。尝试提供模糊的需求,看看它是如何通过提问帮你理清思路的。

批准设计并观察“writing-plans”

在AI展示设计规格并征得你同意后,观察它如何将任务分解成详细的、分步的实施计划。

注意计划中强调的TDD、YAGNI等工程实践。理解每个子任务的目标和验证步骤。

下达“go”指令,观察自动化执行

同意计划后,告诉AI“go”。观察它如何自动创建Git工作区、按计划执行任务、进行测试和代码审查。

这个阶段AI可能会自主工作较长时间。你可以观察它的操作日志,了解子代理如何被调度和审查。

3

理解与探索核心技能

1小时

浏览“The Basic Workflow”列表

回到README,仔细阅读从“brainstorming”到“finishing-a-development-branch”的每个技能描述。

将每个技能的名称和触发时机与你刚才体验的流程对应起来,理解整个链条是如何自动衔接的。

探索“Skills Library”

了解除了基础工作流外,项目还提供了哪些可组合的技能,如“systematic-debugging”、“dispatching-parallel-agents”等。

思考这些技能可以在你未来的哪些开发场景中被触发或调用,它们是对基础工作流的强大补充。

进行一次包含调试的完整练习

启动一个故意包含一个小bug的编码任务(例如:“写一个函数处理用户输入,但假设输入可能格式错误”)。

观察当代码出现问题时,“systematic-debugging”和“verification-before-completion”等技能是如何被激活并引导AI系统化地定位和修复问题的。

推荐资源

项目README 必看

最核心的文档,包含了概述、工作原理、安装指南、基础工作流和技能库介绍。

docs/ 目录下的平台专属文档 推荐(如果你使用对应平台)

针对Codex或OpenCode的详细安装、配置和使用说明。

GitHub Issues 和 Discussions 可选

查看其他用户遇到的问题、使用技巧以及未来的开发计划。

常见错误与避坑指南

1

在需求澄清(brainstorming)阶段提供过于简单或模糊的指令

即使任务简单,也尽量像与真人同事沟通一样描述背景、边界条件和期望。这能帮助Superpowers生成更精准的设计和计划。

2

不仔细阅读AI生成的设计规格和计划就直接批准

Superpowers会将设计分块展示以便阅读。花几分钟时间确认计划符合你的预期,特别是任务分解和验证步骤,这是保证后续自动化执行不偏离方向的关键。

3

在AI自动化执行期间频繁打断或给出新指令

信任工作流。在子代理开发阶段,AI会按照既定计划工作并进行自我审查。频繁打断可能会破坏其上下文和状态。如有必要,可在计划中设置的检查点进行干预。

4

忽略安装验证步骤,导致技能未正确加载

安装后务必执行README中的验证命令,确保Superpowers的技能命令已成功注册到你的AI助手,否则整个工作流无法触发。

下一步探索

尝试将Superpowers应用于你真实的小型项目;探索如何组合使用不同的技能(如并行调度+代码审查)来处理更复杂的工程任务;关注项目更新,了解新技能的加入;如果你有特定需求,可以研究其可组合技能的设计思路,思考如何定制或扩展自己的工作流。

助手