什么是ClawGator Superpowers
ClawGator Superpowers 是专为 ClawGator 团队打造的完整软件开发框架，旨在系统化地指导整个开发流程。该框架基于 obra/superpowers 的核心理念进行深度定制，覆盖从项目启动到代码交付的全生命周期。其核心设计原则强调在动手编码前必须完成充分的思考与规划，确保每一步都有据可依、有迹可循。框架通过一系列自动化触发机制和结构化工作流，帮助团队避免常见开发陷阱，提升代码质量与协作效率。
该框架适用于所有需要实质性代码变更的场景，无论是新增功能、修复缺陷还是重构系统。它强制要求在修改任何代码之前先执行头脑风暴、制定详细计划并设置隔离的 Git worktree 环境。这种前置检查机制有效防止了“边写边想”带来的返工风险，尤其适合中大型团队协作或复杂业务逻辑的实现。同时，框架内置的测试驱动开发（TDD）流程和系统性调试方法，确保每个改动都经过严格验证。
ClawGator Superpowers 不仅是一套工具集合，更是一种被内化的工程文化。它通过标准化的子技能调用顺序——优先使用过程类技能（如 brainstorming），再执行质量保障技能（如 TDD），最后处理版本控制与审查任务——形成可复用的开发范式。对于新成员而言，这套体系提供了清晰的行为准则；对于资深开发者，则大幅减少了上下文切换成本，让精力聚焦于问题本身而非流程细节。
核心功能特点
- 全自动触发机制：在检测到‘build’、‘create’、‘fix’等关键词时自动激活主引导流程
- 强制测试驱动开发（TDD）：要求所有代码变更必须先编写失败测试用例
- 四阶段系统性调试法：包含根因调查、模式分析、假设验证和修复确认的完整排错路径
- Git Worktrees 隔离开发：为每个新功能创建独立分支环境以避免代码污染
- 多维度计划生成器：支持将复杂任务拆解为2-5分钟可执行的微任务并输出完整文件路径
- 子代理驱动开发模式：允许为每个微任务分配专属AI代理实现并行高效开发
适用场景
当团队接到一个全新的功能需求时，ClawGator Superpowers 会首先启动 brainstorming 子技能，通过逐层提问的方式深入理解业务目标和技术约束，提出2-3种可行方案供选择。确认方向后，系统会自动调用 using-git-worktrees 创建物理隔离的开发分支，防止与主线代码产生冲突。接着 writing-plans 会将大目标分解成原子级任务，精确标注每个文件需要修改的内容及预期行为，并嵌入 TDD 步骤说明。执行阶段可选择 subagent-driven-development 模式让不同代理并行处理独立模块，极大缩短交付周期。
面对生产环境出现的紧急 Bug，框架会立即切换至 systematic-debugging 模式。第一阶段要求开发者反复阅读错误日志并复现问题，第二阶段对比历史成功案例寻找差异点，第三阶段形成单一假设并通过最小化测试验证，第四阶段实施精准修复并运行全量回归测试。整个过程杜绝了‘猜测式’修补，确保解决方案直击病灶且不会引入新风险。完成后还需通过 verification-before-completion 二次确认修复有效性，最后由 finishing-a-development-branch 决定合并策略或保留现场。
对于持续迭代中的产品维护，该框架同样表现出色。每次提交前都会触发 TDD 循环：红色阶段编写描述边界条件的测试用例并验证其失败，绿色阶段仅实现满足测试的最简代码，蓝色阶段优化结构保持测试通过。这种肌肉记忆式的开发习惯显著降低了技术债务积累速度。而在多人协作场景下，requesting-code-review 会在关键节点暂停进度请求人工审核，receiving-code-review 则提供结构化反馈吸收机制，保证代码风格统一性和架构合理性。整个流程像精密齿轮般咬合运转，使 ClawGator 团队始终保持在高质量交付轨道上。