学习目标:学会如何为你的AI编程助手安装并配置Superpowers,理解其核心工作流,并能够利用它引导AI完成从需求澄清、设计、计划到自动化实施和审查的完整软件开发过程。
前置知识
项目本身是Shell脚本,安装和部分配置需要在终端中操作。
项目工作流中会使用Git进行分支管理和代码提交。
Superpowers是一个运行在AI编程助手之上的工作流系统,你需要至少拥有其中一个助手的使用经验。
学习步骤
环境准备与安装
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)。
即使安装成功,也建议快速浏览文档,了解可能的高级配置或特定于该助手的注意事项。
快速入门:体验核心工作流
1小时启动一个简单的编码任务
在你的AI编程助手中,提出一个明确的、小型的编码需求(例如:“帮我写一个Python函数,计算斐波那契数列”)。
选择一个你熟悉的语言和简单问题,这样你可以专注于观察Superpowers的工作流,而不是被复杂逻辑分心。
观察并参与“brainstorming”阶段
注意AI助手不会立即写代码,而是会开始提问以澄清需求。积极回答这些问题,帮助它生成一个清晰的设计规格。
这是Superpowers的核心价值之一。尝试提供模糊的需求,看看它是如何通过提问帮你理清思路的。
批准设计并观察“writing-plans”
在AI展示设计规格并征得你同意后,观察它如何将任务分解成详细的、分步的实施计划。
注意计划中强调的TDD、YAGNI等工程实践。理解每个子任务的目标和验证步骤。
下达“go”指令,观察自动化执行
同意计划后,告诉AI“go”。观察它如何自动创建Git工作区、按计划执行任务、进行测试和代码审查。
这个阶段AI可能会自主工作较长时间。你可以观察它的操作日志,了解子代理如何被调度和审查。
理解与探索核心技能
1小时浏览“The Basic Workflow”列表
回到README,仔细阅读从“brainstorming”到“finishing-a-development-branch”的每个技能描述。
将每个技能的名称和触发时机与你刚才体验的流程对应起来,理解整个链条是如何自动衔接的。
探索“Skills Library”
了解除了基础工作流外,项目还提供了哪些可组合的技能,如“systematic-debugging”、“dispatching-parallel-agents”等。
思考这些技能可以在你未来的哪些开发场景中被触发或调用,它们是对基础工作流的强大补充。
进行一次包含调试的完整练习
启动一个故意包含一个小bug的编码任务(例如:“写一个函数处理用户输入,但假设输入可能格式错误”)。
观察当代码出现问题时,“systematic-debugging”和“verification-before-completion”等技能是如何被激活并引导AI系统化地定位和修复问题的。
推荐资源
最核心的文档,包含了概述、工作原理、安装指南、基础工作流和技能库介绍。
针对Codex或OpenCode的详细安装、配置和使用说明。
查看其他用户遇到的问题、使用技巧以及未来的开发计划。
常见错误与避坑指南
在需求澄清(brainstorming)阶段提供过于简单或模糊的指令
即使任务简单,也尽量像与真人同事沟通一样描述背景、边界条件和期望。这能帮助Superpowers生成更精准的设计和计划。
不仔细阅读AI生成的设计规格和计划就直接批准
Superpowers会将设计分块展示以便阅读。花几分钟时间确认计划符合你的预期,特别是任务分解和验证步骤,这是保证后续自动化执行不偏离方向的关键。
在AI自动化执行期间频繁打断或给出新指令
信任工作流。在子代理开发阶段,AI会按照既定计划工作并进行自我审查。频繁打断可能会破坏其上下文和状态。如有必要,可在计划中设置的检查点进行干预。
忽略安装验证步骤,导致技能未正确加载
安装后务必执行README中的验证命令,确保Superpowers的技能命令已成功注册到你的AI助手,否则整个工作流无法触发。
下一步探索
尝试将Superpowers应用于你真实的小型项目;探索如何组合使用不同的技能(如并行调度+代码审查)来处理更复杂的工程任务;关注项目更新,了解新技能的加入;如果你有特定需求,可以研究其可组合技能的设计思路,思考如何定制或扩展自己的工作流。
相关项目推荐
ohmyzsh/ohmyzsh
🙃 社区驱动的卓越框架(拥有2400多名贡献者),用于管理zsh配置。包含300多个可选插件(rails、git、macOS、hub、docker、homebrew、node、php、python等)、140多种主题焕新每日体验,以及可轻松同步社区最新更新的自动更新工具
d3/d3
使用SVG、Canvas和HTML让数据跃然呈现
nvm-sh/nvm
Node 版本管理器 - 符合 POSIX 标准的 bash 脚本,用于管理多个活跃的 node.js 版本
anthropics/claude-code
Claude Code是一款基于终端的智能编程工具,它能理解您的代码库并通过自然语言命令执行常规任务、解释复杂代码和处理git工作流,从而帮助您更快地完成编码工作。
base/node
Everything required to run your own Base node
youngyangyang04/leetcode-master
《代码随想录》LeetCode刷题攻略:200道经典题目刷题顺序,60万字详细图解,视频难点解析,50余张思维导图,支持C++、Java、Python、Go、JavaScript等多语言版本,让算法学习不再迷茫!🔥🔥 快来探索,相见恨晚!🚀