claw-superpowers

⚡ 系统化AI工程纪律:从设计到交付

13项系统化AI辅助软件开发技能集,覆盖从需求分析到代码交付的完整工程纪律,强调TDD、严格代码审查与流程约束

收藏
7.1k
安装
1.5k
版本
1.0.1
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心定位

Superpowers是一套强制性代理开发方法论,将传统软件工程纪律注入AI辅助开发流程。区别于松散的"提示技巧",它以13个互锁技能构建完整生命周期管理,核心设计哲学是:流程纪律优先于执行速度

核心用法

技能按开发阶段编排,形成7步闭环工作流:
1. Brainstorm(第2节) - 任何代码编写前的强制设计评审,需用户书面批准

2. Plan(第3节) - 产出颗粒度为2-5分钟任务的详细执行文档

3. Execute(第4-6节) - 单会话子代理、跨会话批量执行或并行代理三种模式

4. Test(第7节) - 严格的RED-GREEN-REFACTOR TDD循环

5. Debug(第8节) - 根因分析优先的问题排查框架

6. Review(第10节) - 双阶段代码审查(规格符合性+代码质量)

7. Finish(第12节) - 分支整合与清理的标准化流程

关键机制

  • 硬门槛(HARD-GATE):第2节的"未经用户批准不得编写代码"为绝对约束
  • 技能触发规则:只要存在1%适用可能就必须调用,无豁免条款
  • 合理化识别表:内置12种常见逃避话术及反驳,防止代理绕过流程

显著优点

1. 系统性防漂移:通过"设计→计划→执行→验证→审查"的强制顺序,遏制AI常见的"边想边做"行为模式
2. 质量双保险:Subagent-Driven Development(第5节)的"规格审查→质量审查"两道闸门,显著降低幻觉代码流入主分支的风险

3. 可复现的调试框架:第8节的"根因分析四阶段"提供结构化问题排查路径,避免"试错式修复"

4. 工程基础设施:Git worktrees(第11节)与分支管理(第12节)的标准化,解决AI并发修改的隔离难题

潜在局限与风险

1. 刚性成本:对简单任务(如单文件配置修改)强制走完整流程,可能产生过度工程
2. 上下文消耗:13个技能文档较长,频繁调用会增加token开销

3. 用户摩擦:第2节的"用户批准"门槛在快速迭代场景下可能成为瓶颈

4. 代理合规依赖:大量约束依赖代理自我识别合理化行为,存在被绕过的可能

适合人群

  • 多人协作的AI辅助开发项目(流程一致性关键)
  • 需要审计追踪的关键业务系统开发
  • 技术债务较重的遗留系统重构
  • 对代码质量有强约束要求的受监管行业

常规风险

  • 流程形式主义风险:代理可能机械执行步骤而未真正理解目的(文档通过"合理化识别表"试图缓解)
  • 计划-执行脱节:第3节的详细计划可能在执行阶段因环境变化失效,需频繁回退到重规划
  • 子代理级联错误:第5节的多层代理调用中,早期环节的规格理解偏差会在后续放大
  • 测试覆盖率幻觉:TDD的"测试先行"不保证测试充分性,复杂边界条件仍需人工设计

来源与权威性

源自OpenClaw组织的内部工程实践文档,经过多轮代理压力测试迭代。方法论借鉴了极限编程(XP)的TDD实践、精益开发的拉动式流程,以及航空航天领域的检查单文化。文档明确承认自身为"disciplined methodology",非通用最佳实践,而是特定约束下的优化解。

claw-superpowers 内容

手动下载zip · 16.2 kB
skill-card.mdtext/markdown
请选择文件