Superpowers 开发方法论

解决的具体问题

软件开发过程中常遇到需求模糊、设计反复、代码维护性差等问题，导致项目质量低下和效率受损。Superpowers 通过提供一个结构化、可重复的工作流，为 AI 代理开发软件时确保每个阶段都有明确检查点和文档输出，从而减少混乱，提升代码的可维护性和项目可追溯性。

核心工作流程

Superpowers 强制执行一个 7 阶段的开发流程，每个阶段都不可跳过，并产出相应文档：

• 头脑风暴（Brainstorming）：自动触发于任何开发任务，通过提问澄清用户真实需求，探索设计选项，生成设计文档 design.md。
• 设计验证（Design Validation）：确保设计完整可行，分块呈现给用户审查，确认后更新设计。
• 实施规划（Implementation Planning）：将设计分解为细粒度任务（每个 2-5 分钟），包含具体文件路径、代码和验证步骤，遵循 YAGNI 和 DRY 原则，输出 plan.md。
• 测试驱动开发（TDD）：在实施中强制红-绿-重构循环：先写失败测试，再写最小代码通过，然后重构代码。
• 子代理驱动开发（Subagent-Driven Development）：使用子代理并行或顺序执行任务，每个任务创建新子代理，进行两阶段审查（规范合规性和代码质量），并在批量执行时设置人类检查点。
• 代码审查（Code Review）：在任务间或完成后审查代码，按严重性报告问题（关键、主要、次要），关键问题必须修复后才继续，输出 review.md。
• 完成开发分支（Finishing Development Branch）：所有任务完成后验证测试通过，提供合并、创建 PR、保留分支或丢弃选项，清理工作区，生成最终报告。

核心原则与注意点

技能基于核心原则：测试驱动开发、系统化决策、复杂性降低和证据驱动。适用于需要高代码质量和可维护性的项目，但注意这是一个强制性工作流——当检测到开发活动时自动激活。需处理子代理偏离计划、测试失败或需求变更等情况，通常通过返回前期阶段调整。初始设计阶段可能增加时间投入，但有助于长期项目健康。