教程文档【免费下载链接】easy-vibe从 0 到 1 学会 vibe coding项目制学习项目地址https://gitcode.com/datawhalechina/easy-vibe点击查看免费下载导读Superpowers 是 Jesse Vincent网名 obra开发的开源 Agent 技能框架它解决的是 AI 编程中一个核心问题如何让 Claude 写出工程级代码而非玩具级代码。本文基于 easy-vibe 项目进阶开发Stage 3核心技能路径中的 Superpowers 指南 展开系统讲解其安装方式、技能触发机制、20 可组合技能、完整开发工作流与最佳实践。读完本文你将掌握如何借助 Superpowers 为 AI 编程助手注入需求澄清、TDD 纪律、任务分解与代码审查四大工程能力把 vibe coding 从随缘出活变为可重复的工程流程。一、Superpowers 是什么为 AI 装上工程纪律把普通 AI 编程助手想象成一名聪明的实习生他能写出可运行的代码但可能没有测试、没有文档、不遵循最佳实践。Superpowers 就像给这位实习生配备了一位资深工程师导师强制他遵循完整的软件开发流程。为什么需要 Superpowers在没有 Superpowers 之前直接使用 Claude Code 存在四个典型问题Vibe Coding 的混乱AI 跳过规划直接写代码导致频繁返工缺少 TDD 纪律AI 习惯先写代码再补测试甚至干脆不写测试需求模糊直接动手用户说做一个登录功能AI 立刻开写结果做出来不是用户想要的代码质量不稳定没有代码审查机制产出质量完全依赖 AI 的心情。Superpowers 正是针对这四类问题设计的它先帮 AI 澄清需求然后制定计划再用 TDD 方式开发最后通过代码审查确保质量——相当于把 Claude 从聪明的实习生重组为一个有纪律的开发团队。核心价值的四个支柱需求优先brainstorming技能在需求模糊时主动提问流程纪律test-driven-development强制 TDD 红绿重构RED-GREEN-REFACTOR循环任务分解writing-plans将大项目拆解为可执行的小任务质量控制code-review类技能为最终产出把关。二、快速开始安装、首次体验与触发机制第一步安装 Superpowers在 Claude Code 会话中运行以下命令通过官方插件市场安装# 添加 marketplace /plugin marketplace add obra/superpowers-marketplace # 安装 superpowers /plugin install superpowerssuperpowers-marketplace也可以手动克隆到 Claude 的全局技能目录git clone https://github.com/obra/superpowers.git ~/.claude/skills/superpowers说明上述git clone命令用于在本地安装 Superpowers 本体。若只想在某个特定项目中使用可参考下文安装与配置详解中的项目级安装方法。第二步用 brainstorming 体验它的价值在 Claude Code 中输入一个模糊需求我做一个用户登录功能没有 Superpowers 之前Claude 直接开始写代码产出的可能并不是你想要的。有 Superpowers 之后Claude 会通过苏格拉底式提问帮你澄清需求这个登录功能是为 Web 应用还是移动应用设计的需要支持哪些登录方式邮箱密码第三方登录Google、GitHub是否需要记住我功能密码重置流程是邮件还是短信...这些问题迫使你在编码前想清楚真正需要什么避免写出一堆用不上的代码。第三步理解技能的三种触发方式Superpowers 不是魔法开关而是一组技能集合。技能通过以下三种方式被触发关键词触发当你提到 TDD、测试驱动开发、先写测试 等词时test-driven-development技能被激活场景触发需求模糊时brainstorming主动提问出现 bug 时systematic-debugging被激活手动调用直接输入技能名称如/test-driven-development。关键澄清不提 TDD 会怎样这是一个常见误解务必理解清楚# 情况 A不提 TDD 实现一个计算器 → Claude 可能写测试也可能不写 → 取决于模型本身的训练习惯 # 情况 B提到 TDD 用 TDD 方式实现一个计算器 → test-driven-development 技能被激活 → 强制遵循 RED-GREEN-REFACTOR 流程Superpowers 的真正价值不是无中生有而是强化纪律没有 TDD 技能时Claude 写测试是看心情有 TDD 技能时Claude 被强制遵循 TDD 流程。三、核心技能全景覆盖完整软件生命周期的 20 技能Superpowers 包含20 个可组合技能覆盖整个软件开发生命周期。下面按类别逐一详解。测试类技能test-driven-development测试驱动开发触发方式提到 TDD、测试驱动开发、先写测试 等关键词。传统开发方式的问题直接写代码手动测试一下发现 bug修改代码重复……测试下次再说吧技能激活后的 TDD 方式RED先写一个失败的测试GREEN写最少的代码让测试通过REFACTOR重构代码保持测试通过重复使用示例用 TDD 方式实现一个用户认证模块Claude 会依次执行先编写测试测试用户名密码验证、token 生成等运行测试确认全部失败RED编写最小实现代码运行测试确认通过GREEN重构代码提取公共逻辑再次运行测试确认仍然通过REFACTOR。注意如果你不提 TDDClaude 可能写也可能不写测试。这个技能的作用是强化流程纪律确保测试不会被遗忘。调试类技能systematic-debugging系统化调试当出现 bug 时人类开发者往往随机尝试各种修复方案。Superpowers 强制使用四阶段根因分析阶段 1复现问题——确认 bug 可以稳定复现记录复现步骤阶段 2隔离根因——通过二分法缩小范围添加日志定位问题代码阶段 3验证假设——提出根因假设设计验证实验阶段 4修复并验证——实施修复确认 bug 解决并添加回归测试防止复发。verification-before-completion完成前验证这个技能防止 Claude 感觉差不多就停止工作。它要求 Claude 在声称任务完成前运行所有测试手动测试关键功能检查代码质量lint确认文档已更新。协作类技能brainstorming头脑风暴这是 Superpowers 最有趣的技能之一使用苏格拉底式提问法澄清需求。当你提出一个模糊需求时Claude 不会直接动手而是会提问你做一个博客系统 Claude - 这个博客主要是给谁看的技术读者还是大众 - 需要支持 Markdown 编辑吗 - 需要评论功能吗 - 需要搜索功能吗 - 是单用户还是多作者 - ...这些问题迫使你思考真正需要什么功能避免开发出一堆用不上的东西。writing-plans编写计划这个技能将大任务分解为2-5 分钟可完成的小任务。例如用 writing-plans 规划一个待办事项 API 的开发Claude 会生成详细计划# 实现计划 ## 任务 1设计数据库 schema预计 5 分钟 - 创建 todos 表 - 定义字段id, title, completed, createdAt ## 任务 2创建 Express 路由预计 10 分钟 - POST /todos - 创建任务 - GET /todos - 获取列表 - GET /todos/:id - 获取单个 - PUT /todos/:id - 更新 - DELETE /todos/:id - 删除 ## 任务 3添加输入验证预计 10 分钟 - 标题不能为空 - completed 必须是布尔值 ## 任务 4编写测试预计 15 分钟 - 为每个端点编写测试 - 覆盖边界情况 ## 任务 5启动服务器并验证预计 5 分钟 - 运行测试 - 手动测试 API 验收标准 - 所有测试通过 - curl 测试每个端点正常每个任务都带有预估耗时与明确的验收标准让整个计划可执行、可验证。executing-plans执行计划这个技能批量执行计划并在每个检查点暂停确认执行上面的计划每完成一个任务暂停一下Claude 会完成任务 1然后暂停✅ 数据库 schema 完成继续吗你确认后完成任务 2再次暂停以此类推。这让你可以在每个阶段检查方向是否正确避免跑远了才发现错了。dispatching-parallel-agents并行代理调度这个技能可以同时启动多个子代理并行工作适合需要同时处理多个独立任务的场景用并行代理同时完成 - 代理 A编写后端 API - 代理 B编写前端组件 - 代理 C编写测试每个代理在自己的隔离环境中工作互不干扰。subagent-driven-development子代理驱动开发这个技能为每个小任务启动一个独立的子代理优势在于每个子代理有独立的上下文不会被无关信息干扰单个任务失败不会影响其他任务多个任务可以并行执行。using-git-worktrees使用 Git Worktrees这个技能使用 Git 的 worktree 功能创建隔离的开发环境多个功能可以并行开发每个 worktree 相互独立不会互相冲突。代码审查类技能requesting-code-review请求代码审查代码完成后这个技能会自动请求代码审查完成功能后自动触发代码审查receiving-code-review接收代码审查这个技能定义了如何接收和处理审查反馈标准审查流程为提交代码自动触发审查审查者检查代码质量、安全性、测试覆盖率提出改进建议修复问题重新审查直到批准。四、完整工作流把技能组合成一条开发流水线Superpowers 的真正威力在于将多个技能组合成完整的开发流程。标准开发流程1. Brainstorming头脑风暴 ↓ 通过问答澄清真实需求 2. Design Document设计文档 ↓ 分块展示设计等待确认 3. Writing Plans编写计划 ↓ 分解为 2-5 分钟的小任务 4. Subagent Development子代理开发 ↓ 每个任务启动独立子代理 ↓ 两阶段审查规格符合性 代码质量 5. TDD测试驱动开发 ↓ 强制 RED-GREEN-REFACTOR 6. Code Review代码审查 ↓ 质量把关 7. 完成实战案例用 Superpowers 构建用户认证系统第一步Brainstorming 澄清需求我需要一个用户认证系统Claude 会问你Web 应用还是移动应用支持哪些登录方式需要密码重置吗需要记住我功能吗……第二步生成设计文档确认需求后Claude 会生成设计文档# 用户认证系统设计 ## 功能需求 1. 用户注册邮箱 密码 2. 用户登录 3. 密码重置邮件 4. 记住我JWT Refresh Token ## 技术选型 - 后端Node.js Express - 数据库SQLite - 认证JWT - 加密bcrypt ## API 设计 - POST /api/auth/register - POST /api/auth/login - POST /api/auth/refresh - POST /api/auth/reset-password第三步编写实现计划用 writing-plans 制定实现计划Claude 会生成详细的任务列表每个任务 2-5 分钟可完成。第四步执行开发用 TDD 方式执行上面的计划Claude 会先写测试 → 确认测试失败RED→ 写实现代码 → 确认测试通过GREEN→ 重构代码REFACTOR。第五步代码审查完成后自动触发代码审查检查代码质量、安全性SQL 注入、XSS 等、测试覆盖率、文档完整性。五、Superpowers vs 直接使用 Claude Code维度直接使用 Claude Code使用 Superpowers需求澄清AI 直接开始写代码苏格拉底式提问澄清需求开发流程随 AI 自由发挥强制 TDD 红绿重构任务管理一次性完成分解为小任务带检查点代码质量依赖 AI 判断强制代码审查可预测性结果不稳定流程可重复适用场景简单任务、原型验证复杂项目、生产代码形象比喻如果把 Claude Code 比作一个聪明的实习生——直接使用告诉实习生做一个登录功能他直接开写可能做出你觉得不对的东西使用 Superpowers给实习生配备一位资深导师导师会问清楚需求、制定计划、检查代码质量。六、在 easy-vibe 学习路径中的定位Superpowers 在 easy-vibe 项目中是进阶开发Stage 3核心技能环节的重要一课。该主题的完整内容位于 docs/de-de/stage-3/core-skills/superpowers/index.md并且与英文版 docs/en/stage-3/core-skills/superpowers/index.md、中文版 docs/zh-cn/stage-3/core-skills/superpowers/index.md 及多语言版本内容对齐便于对照学习。在课程地图中的位置在 docs/de-de/stage-3/index.md 的核心技能Kernkompetenzen导航区中Superpowers 与 Claude Code 快速入门、MCP、Skills、长时任务、Agent 团队、工作流最佳实践等课程并列定位为利用 Superpowers 框架帮助 AI 编写工程级代码。它处于技能进阶序列的后段——意味着读者应已掌握 Claude Code 基础操作与 MCP 协议再进入工程纪律层面。与 Skills 指南的底层呼应Superpowers 本质上是一组预制的 Skills 集合。要理解它的触发与加载原理可以对照 docs/de-de/stage-3/core-skills/skills/index.md 中关于 Skills 机制的讲解每个技能以目录形式存在核心是SKILL.md定义文件包含YAML frontmatter 元数据name、description、category、tags与 Markdown 指令正文Claude Code 启动时会扫描技能目录、解析每个SKILL.md、提取 frontmatter 元数据加入知识库并依据description自动匹配触发——这正是 Superpowers 关键词/场景触发的底层实现机制全局技能存放于~/.claude/skills/个人、跨项目项目级技能存放于项目根目录/.claude/skills/团队共享、随 Git 版本管理这与 Superpowers 的三种安装方式一一对应。从源码结构看Superpowers 与 Skills 的关系是Superpowers 是完整开发方法论框架Skills 是可复用的技能包Superpowers 内部使用 Skills本身也是 Skills 的集合。七、安装与配置详解方法一通过 Marketplace推荐# 添加 marketplace /plugin marketplace add obra/superpowers-marketplace # 安装 /plugin install superpowerssuperpowers-marketplace # 验证安装 /skills执行/skills后可以在技能列表中确认 Superpowers 的各技能是否已被识别。方法二手动克隆# 创建目录 mkdir -p ~/.claude/skills # 克隆仓库 git clone https://github.com/obra/superpowers.git ~/.claude/skills/superpowers方法三项目级安装如果只想在特定项目中使用 Superpowers# 在项目根目录 mkdir -p .claude/skills # 克隆或复制 superpowers cp -r ~/.claude/skills/superpowers .claude/skills/这样团队成员克隆项目后即可共享同一套 Superpowers 配置实现团队级别的流程标准化。八、常用技能速查表技能名称功能使用场景brainstorming苏格拉底式提问澄清需求需求不明确时writing-plans分解任务为小步骤大项目开始前executing-plans执行计划并设置检查点按计划开发时test-driven-developmentTDD 红绿重构循环所有功能开发systematic-debugging四阶段根因分析出现 bug 时verification-before-completion完成前验证任务结束时requesting-code-review请求代码审查提交代码前subagent-driven-development子代理驱动开发并行任务using-git-worktreesGit worktree 隔离并行开发功能九、最佳实践1. 明确触发关键词Superpowers 的技能通过关键词触发掌握常用触发词是高效使用的前提技能触发关键词test-driven-developmentTDD、测试驱动、先写测试brainstorming需求模糊时自动触发systematic-debugging调试、bug、不工作writing-plans制定计划、规划2. 需要流程纪律时使用 Superpowers生产级代码开发 → 提到 TDD需求不明确 → 让brainstorming帮你澄清复杂项目 → 用writing-plans分解任务。3. 简单任务不必强求如果是快速原型或一次性脚本不需要强制走完整流程。Superpowers 最适合需要长期维护的代码。4. 技能可以组合使用用 TDD 方式实现用户认证完成后帮我做代码审查这会同时触发test-driven-development和code-review类技能形成开发 质量闭环。十、常见问题Q1用 Superpowers 必须指定 TDD 吗不是必须的。Superpowers 是技能集合每个技能有自己的触发条件说用 TDD 方式会触发test-driven-development不说 TDDClaude 可能写测试也可能不写取决于模型本身。Superpowers 的作用是强化流程纪律而不是凭空创造能力。Q2Superpowers 会让开发变慢吗初期可能会感觉慢因为需要时间澄清需求、要先写测试再写代码、要经过代码审查。但长期来看由于减少了返工和 bug整体效率反而更高。Q3小项目也需要 Superpowers 吗对于原型验证或非常简单的任务可以直接使用 Claude Code。Superpowers 更适合生产级项目、多人协作项目、需要长期维护的项目。Q4Superpowers 和 Skills 有什么区别维度SuperpowersSkills本质完整的开发方法论框架可复用的技能包范围覆盖整个开发流程聚焦特定功能关系Superpowers 内部使用 SkillsSuperpowers 是 Skills 的集合Q5可以自定义 Superpowers 技能吗可以。Superpowers 是开源的你可以 Fork 仓库、修改现有技能、添加新技能、贡献回社区。自定义技能的规范可参考 docs/de-de/stage-3/core-skills/skills/index.md 中关于SKILL.md文件结构YAML frontmatter Markdown 指令与skill-creator工具的说明。十一、总结Superpowers 是一组工程级开发技能集合让 Claude Code 从聪明的实习生变成有纪律的开发团队。核心要点Superpowers 是技能集合不是魔法——安装后技能在后台可用通过关键词或场景触发也可以手动调用特定技能记住关键触发词——想要 TDD 就说用 TDD 方式需求模糊时brainstorming会主动提问出现 bug 时提到调试触发systematic-debugging适用场景明确——适合生产级代码开发、需要长期维护的项目、团队协作项目快速原型和一次性脚本则无需强制走完整流程。记住这句话Superpowers 不让 AI 更聪明而是让 AI 更有纪律。在 easy-vibe 的进阶开发学习路径中掌握这套技能组合正是从能写代码走向工程级交付的关键一步。赞分享教程文档【免费下载链接】easy-vibe从 0 到 1 学会 vibe coding项目制学习项目地址https://gitcode.com/datawhalechina/easy-vibe点击查看免费下载相关推荐Claude Code Superpowers 工程级开发让 AI 从聪明实习生变成有纪律的开发团队Claude Code Superpowers 工程级开发让 AI 从聪明实习生变成有纪律的开发团队 本篇指南以 docs/zh cn/stage 3教程文档easy-vibe 进阶指南用 Claude Code Superpowers 将 AI 编程从「玩具代码」升级为「工程级代码」easy vibe 进阶指南用 Claude Code Superpowers 将 AI 编程从「玩具代码」升级为「工程级代码」 本篇文章是 easy vib教程文档easy-vibe 指南Claude Code Agent Teams — 让多个 AI 实例像真正的开发团队一样协作easy vibe 指南Claude Code Agent Teams — 让多个 AI 实例像真正的开发团队一样协作 Agent Teams 是 Claud教程文档人工智能Vibe Coding创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
 污染防护与测试分批隔离实战指南)
