Superpowers AI编程技能库实战教程：从安装到跑通完整开发流程
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一套 AI 编程技能库框架：装到你的编程助手（Claude Code、OpenCode、Codex 等）上后，它会按"梳理需求→设计确认→拆计划→测试驱动开发→代码审查→分支收尾"的固定流程推进工作，而不是拿到需求就急着写代码。
🎯 项目定位
Superpowers 解决的核心问题是：AI 助手写代码快，但过程不可控。它把完整软件开发方法论做成一组会自动触发的技能，让助手在动手前先和你确认设计与计划，实现时强制走测试驱动和代码审查。
适合人群：
- 用 Claude Code / Codex / OpenCode 等工具日常写项目的开发者
- 希望 AI 长时自主干活、但不想全程盯着的独立开发者
- 需要给团队统一 AI 编程规范的负责人
🚀 快速上手
Claude Code 插件市场安装步骤
- 启动 Claude Code，打开插件市场面板
- 搜索 superpowers 并安装，官方市场中直接可装
- 重开会话即生效
手动克隆安装（OpenCode、Codex 等平台）
- 拉取仓库：
git clone https://gitcode.com/GitHub_Trending/su/superpowers - 按你所用平台的说明（仓库内 docs/README.opencode.md 等）把技能接入
- 注意：每个平台都要单独安装一份，装过 Claude Code 不等同 OpenCode 也装好了
验证安装是否生效
- 新开会话，直接问助手"告诉我你的 superpowers"
- 助手能列出已加载的技能清单，说明安装成功
🧩 核心功能拆解
| 功能 | 它能帮你做什么 | 适用场景 |
|---|---|---|
| brainstorming 设计梳理 | 苏格拉底式提问把模糊想法聊成设计文档，并分小节展示给你确认 | 需求还没想清楚的起步阶段 |
| writing-plans 计划拆解 | 把设计拆成每个 2–5 分钟的任务，附文件路径与验证步骤 | 设计确认后的实施规划 |
| test-driven-development 测试驱动 | 强制 RED-GREEN-REFACTOR：先写失败测试、再写最小实现 | 一切代码实现环节 |
| subagent-driven-development 子代理开发 | 每个任务派新子代理执行，并做"规范符合性＋代码质量"两段审查 | 计划批准后长时自主开发 |
| systematic-debugging 系统化调试 | 四阶段根因分析，避免靠试错碰运气修 bug | 遇到难复现的缺陷 |
这些技能不需要你手动点名，助手在执行任何任务前会自动检查并触发对应流程。
🛠️ 实战场景走查
场景一：从一句话需求到可执行计划
- 你说"让我们做一个 React 待办清单" → 助手不写代码，而是用 brainstorming 连续提问、分小节展示设计。
- 你逐段确认设计 → writing-plans 把方案拆成每个 2–5 分钟、带文件路径和验证步骤的任务清单。
- 你说"go" → 得到一份子代理可以直接照着干、你不用全程盯的计划。
场景二：长时自主开发
- 你批准计划后离开 → 子代理逐个领任务，实现时强制先写失败测试再写代码。
- 任务之间自动触发代码审查 → 关键问题会直接阻塞进度，普通问题汇总等你决策。
- 任务完成 → finishing-a-development-branch 技能给出合并 / 提 PR / 保留 / 丢弃四个收尾选项。
⚠️ 常见坑与排查
- 技能从不自动触发：现象是助手照旧直接写代码；原因是会话启动引导（using-superpowers bootstrap）没加载，技能只是躺在磁盘上；解决是确认平台的会话启动钩子正常执行，然后重开新会话。
- 旧安装方式残留：现象是 OpenCode 里技能列表缺失或行为异常；原因是此前用 clone＋符号链接装的旧版本没清干净；解决是按 OpenCode 安装文档 的迁移说明删除旧符号链接，改用插件方式装。
- 多平台只装了一份：现象是换平台后功能"消失"；原因是每个平台（Claude Code、Codex、OpenCode 等）需要各自单独安装；解决是逐平台重复安装流程。
- 担心遥测：现象是默认遥测会把当前 Superpowers 版本号带出去；原因是可选的视觉伴侣功能从官网加载 logo；解决是把环境变量 SUPERPOWERS_DISABLE_TELEMETRY 设为任意真值即可关闭。
🌱 进阶与生态
- 技能源码：skills/ 下每个目录是一个技能，入口都是 SKILL.md，可自行阅读或仿写
- 平台文档：OpenCode 指南、Kimi 指南，各平台的接入细节都在这里
- 钩子系统：hooks/ 负责会话启动时注入引导，这是技能能自动触发的关键
- 技能优先级：项目技能（项目内 skills 目录）＞个人技能（用户目录）＞Superpowers 基础技能库，项目级可覆盖通用行为
- 写自己的技能：参考 writing-skills 技能，其中附了测试方法
📌 小结
Superpowers 本质是一套会自动触发的 AI 编程开发流程技能库：设计、计划、测试驱动、审查、收尾都有人（技能）把关。它适合希望 AI 长时自主开发、同时要求过程可控的开发者。现在就按上面的步骤在你的 Claude Code 或 Codex 里装上 Superpowers，用下一个小功能验证效果。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
