Superpowers AI开发技能进阶指南：从入门到创新

一、认知阶段：构建Superpowers知识体系

学习目标：理解Superpowers核心概念与项目架构

认识Superpowers项目结构

Superpowers采用模块化设计，如同一个精心组织的工具箱，每个目录都有明确职责：

• skills/：核心技能模块库，存放各类AI开发相关技能文档
• docs/：项目知识库，包含设计方案和实现细节
• tests/：实践验证区，提供测试脚本和示例项目
• lib/：功能引擎室，如核心功能库文件lib/skills-core.js

📋 准备工作：

1. 克隆项目仓库：git clone https://gitcode.com/GitHub_Trending/su/superpowers
2. 阅读项目简介文档：README.md和docs/README.opencode.md

💡 技巧：将项目结构想象成厨房，skills是烹饪方法，docs是食谱，tests是试吃环节，lib则是基础厨具。

掌握技能调用核心流程

Superpowers的一切操作都围绕"技能"展开，如同使用GPS导航到达目的地：

1. 接收用户需求（确定目的地）
2. 判断适用技能（选择导航路线）
3. 调用相关技能（启动导航）
4. 执行技能流程（按导航行驶）

⚠️ 注意：即使只有1%的可能性适用某个技能，也必须先检查技能文档确认。

拓展资源：

• 核心文档：技能使用规范文档skills/using-superpowers/SKILL.md
• 实践项目：技能触发测试tests/skill-triggering/

二、实践阶段：掌握核心技能与工具使用

学习目标：熟练应用基础技能解决实际问题

构建开发环境

开发环境配置是使用Superpowers的第一步，如同调试乐器确保音准：

🔧 实施步骤：

1. 克隆项目后进入目录：cd superpowers
2. 配置系统环境：参考docs/windows/polyglot-hooks.md
3. 验证安装：cd tests/opencode && ./run-tests.sh

常见问题解决：

• 脚本权限问题：执行chmod +x run-tests.sh赋予执行权限
• 依赖缺失：查看错误信息，安装相应依赖包

应用三大基础技能

掌握这些基础技能如同学会驾驶的油门、刹车和方向盘：

1. 系统性调试：像侦探破案一样定位问题

   • 参考文档：skills/systematic-debugging/SKILL.md
   • 核心方法：问题复现→假设验证→根因定位→解决方案

2. 测试驱动开发：先设计靶子再射箭

   • 参考文档：skills/test-driven-development/SKILL.md
   • 基本流程：编写测试→实现功能→通过测试→重构优化

3. 编写计划：航行前绘制海图

   • 参考文档：skills/writing-plans/SKILL.md
   • 关键要素：目标明确→步骤清晰→资源评估→风险预案

拓展资源：

• 核心文档：技能测试脚本tests/claude-code/run-skill-tests.sh
• 实践项目：技能触发测试用例tests/skill-triggering/prompts/

三、深化阶段：掌握高级开发策略

学习目标：运用高级特性提升开发效率

子代理驱动开发实践

子代理驱动开发（SDD：Subagent-Driven Development）是将复杂任务分解给专业子代理的协作模式，如同组建一支各司其职的开发团队：

基础版实施流程：

1. 阅读SDD技能文档：skills/subagent-driven-development/SKILL.md
2. 理解三大角色：
   • 规范审查者：检查设计合理性spec-reviewer-prompt.md
   • 实现者：负责具体编码implementer-prompt.md
   • 代码质量审查者：确保代码质量code-quality-reviewer-prompt.md

高级版应用策略：

• 动态角色切换：根据任务复杂度调整子代理数量
• 结果交叉验证：不同子代理对同一任务结果互审
• 迭代优化循环：建立反馈机制持续改进

问题诊断指南

当你遇到问题时，可按照以下流程系统解决：

1. 问题定义：精确描述症状，避免模糊表述

   • 好例子："执行run-tests.sh时第15行出现权限错误"
   • 坏例子："脚本运行不了"

2. 数据收集：收集相关日志和配置信息

   • 错误日志位置：项目根目录/logs/
   • 配置检查：hooks/hooks.json

3. 假设验证：

   # 检查文件权限
   ls -l tests/opencode/run-tests.sh
   # 测试基础功能
   ./tests/opencode/test-tools.sh
   

4. 解决方案实施：小步验证，逐步修复

拓展资源：

• 核心文档：高级调试技巧skills/systematic-debugging/root-cause-tracing.md
• 实践项目：分形生成器开发tests/subagent-driven-dev/go-fractals/

四、创新阶段：贡献与拓展Superpowers生态

学习目标：参与项目贡献并拓展技能边界

并行代理调度技术

并行代理调度是提升复杂项目效率的高级技术，如同乐队指挥协调多个乐器声部：

基础版：

• 学习并行调度技能文档：skills/dispatching-parallel-agents/SKILL.md
• 尝试简单任务分解：将测试任务分配给多个代理并行执行

高级版：

• 实现动态负载均衡：根据代理性能分配任务
• 建立结果整合机制：合并并行执行结果并处理冲突
• 设计错误恢复策略：处理部分代理失败的情况

社区贡献路径

成为Superpowers社区贡献者，分享你的专业知识：

1. 技能开发：

   • 学习技能编写指南：skills/writing-skills/SKILL.md
   • 参考示例：skills/writing-skills/examples/
   • 遵循最佳实践：skills/writing-skills/anthropic-best-practices.md

2. 测试贡献：

   • 添加新测试用例到tests/skill-triggering/prompts/
   • 改进测试脚本tests/claude-code/run-skill-tests.sh

3. 文档优化：

   • 更新版本说明：RELEASE-NOTES.md
   • 完善技能文档：基于用户反馈改进说明

💡 技巧：从修复小问题开始，逐步过渡到开发新技能，定期查看docs/plans/2025-11-28-skills-improvements-from-user-feedback.md了解社区需求。

拓展资源：

• 核心文档：技能改进计划docs/plans/2025-11-28-skills-improvements-from-user-feedback.md
• 实践项目：待办应用开发tests/subagent-driven-dev/svelte-todo/

快速参考卡片

核心技能路径

1. 基础阶段：系统性调试→测试驱动开发→编写计划
2. 进阶阶段：子代理驱动开发→并行代理调度→问题诊断
3. 专家阶段：技能开发→测试贡献→文档优化

常用命令速查

• 项目验证：cd tests/opencode && ./run-tests.sh
• 技能测试：cd tests/claude-code && ./run-skill-tests.sh
• 查看版本：cat RELEASE-NOTES.md | head -n 1