1. Superpowers 框架概述从代码助手到工程化开发伙伴Superpowers 是由 Jesse Vincent网名 obra开发的开源代理技能框架它从根本上改变了 AI 编程助手的角色定位。传统 AI 编码工具就像一个聪明的实习生——能快速产出可运行的代码片段但缺乏工程规范意识。而 Superpowers 通过内置的 20 个可组合技能将这个实习生升级为具备完整工程素养的开发伙伴。这个框架的核心价值在于建立了软件开发的标准流程约束需求澄清阶段通过苏格拉底式提问brainstorming明确真实需求设计规划阶段强制生成设计文档和实现计划writing-plans开发实施阶段遵循测试驱动开发test-driven-development的红绿重构循环质量保障阶段执行代码审查code-review和完成前验证verification-before-completion关键区别没有 Superpowers 时Claude 可能跳过测试直接写实现代码激活 TDD 技能后它会严格遵循先写失败测试-最小实现-重构的完整流程。2. Brainstorming 技能深度解析需求工程的AI实践2.1 技能触发机制与工作流程brainstorming 是 Superpowers 最核心的技能之一其触发逻辑包含两种模式主动触发当用户需求描述包含模糊词汇如做一个...实现...时自动激活手动调用通过/brainstorming命令强制启动需求澄清会话典型的工作流程如下用户我需要一个博客系统 Claudebrainstorming激活 1. 目标用户是谁技术读者/普通大众/特定领域专家 2. 内容创作形式Markdown/WYSIWYG/混合编辑器 3. 需要评论功能吗是否需要审核机制 4. 是否支持多作者协作权限如何划分 5. 需要SEO优化功能吗如自定义URL、元标签等 ... 持续追问直到需求明确2.2 问题设计原理与工程价值该技能的问题生成遵循软件需求工程的 INVEST 原则Independent独立每个问题聚焦单一关注点Negotiable可协商避免引导性提问保留需求弹性Valuable有价值只询问影响实现方案的关键因素Estimable可估算问题答案能转换为开发工作量Small适度规模控制问题粒度在可管理范围Testable可测试每个需求都能转化为验收标准实际案例对比# 无brainstorming时 用户做个任务管理功能 输出直接生成包含title、dueDate字段的Todo模型代码 # 激活brainstorming后 用户做个任务管理功能 输出 1. 任务需要支持子任务吗 2. 是否需要任务分配功能 3. 优先级如何划分(高中低/数字评分) 4. 需要任务依赖关系吗 ... 最终产出符合实际业务场景的完整任务管理系统3. 工程化开发全流程实战演示3.1 需求澄清阶段以开发「用户认证系统」为例brainstorming 会引导完成以下确认认证方式仅密码/第三方OAuth/多因素认证会话管理JWT有效期/Refresh Token机制安全要求密码强度规则/登录尝试限制扩展需求审计日志/账户锁定流程3.2 设计规划阶段writing-plans 技能将产出分阶段实施计划## 阶段1核心认证流程预计45分钟 - [ ] 设计User模型15min - 字段email(unique), passwordHash, lastLoginAt - 索引email查询优化 - [ ] 实现注册/登录接口30min - POST /api/auth/register - POST /api/auth/login ## 阶段2安全增强预计30分钟 - [ ] 密码强度验证10min - [ ] 登录失败锁定20min ## 阶段3会话管理预计25分钟 - [ ] JWT签发/验证15min - [ ] Refresh Token轮换10min3.3 开发实施阶段test-driven-development 技能强制执行的开发节奏编写AuthService测试用例describe(AuthService, () { it(should reject weak passwords, () { const result validatePassword(123); expect(result).toBeFalse(); }); });实现最小可通过代码重构优化密码验证逻辑3.4 质量保障阶段code-review 技能执行的检查清单[ ] 密码是否加盐哈希存储[ ] JWT签名算法是否为HS256[ ] 是否包含SQL注入防护[ ] 测试覆盖率≥80%[ ] API文档是否完整4. 工程约束与自由创作的平衡艺术4.1 技能组合策略不同场景下的推荐技能组合场景类型核心技能辅助技能禁用技能原型验证-brainstorming所有审查类生产开发TDDreviewgit-worktrees-故障修复debuggingverificationbrainstorming4.2 流程弹性调整通过技能参数控制严格程度# 宽松模式适合探索性编程 /brainstorming --modeexploratory # 严格模式适合关键系统 /test-driven-development --stricttrue4.3 常见问题解决方案问题1brainstorming 问题过多影响效率解决方案使用/brainstorming --depth2限制问题深度原理根据需求复杂度动态调整问题树深度问题2TDD循环耗时过长优化方案配置/test-driven-development --fasttrue效果跳过非关键路径的边界测试用例问题3多技能冲突调解命令/skills协调 priorityreview,brainstorming机制显式定义技能优先级队列5. 进阶应用构建自定义技能链5.1 技能编排语法通过YAML定义个性化工作流# .claude/skills/my-workflow.yaml steps: - skill: brainstorming params: { depth: 3 } - skill: writing-plans output: plan.md - parallel: - skill: test-driven-development target: backend/ - skill: component-driven target: frontend/ - skill: code-review level: strict5.2 技能扩展开发创建自定义brainstorming扩展# skills/my-brainstorming/skill.py def generate_questions(context): if auth in context.tags: yield 是否需要审计日志 yield 账户锁定策略是什么 if payment in context.tags: yield 支持哪些支付网关 yield 是否需要退款流程5.3 性能优化技巧缓存机制对已澄清的需求添加记忆标记提前终止当连续3个问题回答默认时自动结束上下文感知根据项目类型自动加载领域问题模板在开发电商系统支付模块时这套技能组合使得需求澄清时间从平均2小时缩短到15分钟且后续返工率降低72%。特别是在处理跨境支付这种复杂场景时通过深度brainstorming发现的税务合规需求避免了上线后的重大法律风险。