ClawGator 超能力框架

面向 ClawGator 团队的完整软件开发框架。基于 obra/superpowers 构建，但专为 ClawGator 的实际需求定制优化。

何时使用

在以下所有场景中，务必在开始前启用本技能：

• 启动新功能或新组件
• 修改现有行为或功能逻辑
• 修复 Bug 或问题
• 进行大规模代码变更
• 制定具体实施计划

以下情况可跳过本技能：

• 简单提问或信息检索类请求
• 单行命令类操作
• 仅需查看项目上下文（请改用对应上下文技能）

完整工作流

开发需求
    ↓
┌──────────────────────┐
│  USING SUPERPOWERS   │ ← 主技能 —— 驱动全部流程
│  (基础技能)          │   - 自动识别相关子技能
│                      │   - 动态确定子技能执行优先级
└──────────┬───────────┘
           ↓
┌──────────────────────┐
│   BRAINSTORMING      │ ← 理解需求与设计
│  (如需设计时启用)    │   - 逐条提出关键问题
│                      │   - 提出 2–3 种可行方案
│                      │   - 增量式验证设计方案
└──────────┬───────────┘
           ↓
┌──────────────────────┐
│  USING GIT WORKTREES │ ← 搭建隔离开发环境
│  (编码前必做)        │   - 创建新分支
│                      │   - 初始化项目环境
│                      │   - 验证基线测试通过
└──────────┬───────────┘
           ↓
┌──────────────────────┐
│   WRITING PLANS      │ ← 编写实施计划
│  (多任务时启用)      │   - 拆分为小任务（每项耗时 2–5 分钟）
│                      │   - 明确指定文件路径与完整代码片段
│                      │   - 内置 TDD 步骤
└──────────┬───────────┘
           ↓
    ┌──────┴──────┐
    │             ↓
    │  ┌──────────────────────┐
    │  │ SUBAGENT-DRIVEN DEV  │ ← 通过子 Agent 执行（选项一）
    │  │  (当前会话内)        │   - 每个任务启动全新子 Agent
    │  │                      │   - 任务间自动触发代码审查
    │  └──────────┬───────────┘
    │
    │  ┌──────────────────────┐
    │  │   EXECUTING PLANS    │ ← 批量执行计划（选项二）
    │  │  (独立会话)          │   - 批量运行全部任务
    │  │                      │   - 在检查点处暂停并审查
    │  └──────────┬───────────┘
    │
    ↓  ↓
┌──────────────────────┐
│ TEST-DRIVEN DEVELOPMENT │ ← 所有编码均强制启用
│  (始终激活)            │   - RED：先写失败测试，确认其失败
│                        │   - GREEN：编写最小可用实现，使测试通过
│                        │   - REFACTOR：重构代码，保持测试绿色
└──────────┬─────────────┘
           ↓
┌──────────────────────┐
│ SYSTEMATIC DEBUGGING  │ ← 出现错误时启用
│  (发生异常时)         │   - 第一阶段：根因调查
│                      │   - 第二阶段：模式分析
│                      │   - 第三阶段：假设生成与验证
│                      │   - 第四阶段：修复并验证
└──────────┬───────────┘
           ↓
┌──────────────────────┐
│   CODE REVIEW        │ ← 任务间交叉审查
│  (任务切换时)        │   - 发起方：提交待审代码
│                      │   - 接收方：应用审查反馈
└──────────┬───────────┘
           ↓
┌──────────────────────┐
│   VERIFICATION       │ ← 完成前最终确认
│  (交付前)            │   - 重新运行测试
│                      │   - 检查是否引入回归问题
└──────────┬───────────┘
           ↓
┌──────────────────────┐
│ FINISHING DEV BRANCH │ ← 收尾开发分支
│  (全部完成后)        │   - 验证所有测试通过
│                      │   - 提供后续选项：
│                      │   * 合并至 main 分支
│                      │   * 创建 PR
│                      │   * 保留当前分支
│                      │   * 丢弃分支
└──────────────────────┘

可用子技能列表

🎯 核心技能（流程类）

🔨 执行类技能

🧪 质量保障类技能

🔧 Git 与代码审查类技能

📝 元技能（Meta Skills）

核心原则

铁律（Iron Laws）

1. 未经失败测试先行，禁止编写任何生产代码（TDD 原则）
2. 未经根因调查，禁止实施任何修复（调试原则）
3. 只要存在哪怕 1% 的可能性某技能适用，就必须显式调用该技能

TDD 循环

RED → 编写失败测试 → 确认其确实失败
GREEN → 编写最小实现 → 确保测试通过
REFACTOR → 重构代码 → 保持所有测试仍为绿色
REPEAT → 进入下一个测试

调试循环

第一阶段：根因调查
  - 仔细阅读错误信息
  - 稳定复现问题
  - 检查近期变更
  - 追踪数据流向

第二阶段：模式分析
  - 查找正常工作的案例
  - 对照参考实现进行比对
  - 识别差异点

第三阶段：假设生成与验证
  - 提出单一明确假设
  - 设计验证方式并执行
  - 基于结果学习并迭代

第四阶段：修复与验证
  - 在根因位置实施修复
  - 使用原始问题场景验证修复效果
  - 运行全部测试套件

技能调用优先级

当多个技能可能同时适用时，请严格遵循以下优先级顺序：

1. 流程类技能优先（如 brainstorming、systematic-debugging、writing-plans）
2. 质量保障类技能次之（如 test-driven-development、systematic-debugging）
3. Git/审查类技能再次之（如 using-git-worktrees、requesting-code-review）
4. 执行类技能最后（如 executing-plans、subagent-driven-development）

示例：

• “Let's build X” → brainstorming → using-git-worktrees → writing-plans → executing-plans
• “Fix this bug” → systematic-debugging → test-driven-development
• “Add X” → test-driven-development（简单场景，无需额外计划）

与 OpenClaw 的集成

本技能已与 OpenClaw 深度集成：

• ✅ 关键词自动触发：包含 “build”、“create”、“implement”、“fix”、“add” 等关键词时自动激活
• ✅ skills/ 目录下已内置 14 个完整子技能
• ✅ 子技能支持上下文感知，自动触发
• ✅ using-superpowers 作为统一入口点
• ✅ 内置工具： brainstorm、plan_review、get_status
• ✅ 已集成 OpenClaw Agent，支持 subagent-driven-development

ClawGator 团队实践

ClawGator 团队使用本技能开展以下工作：

• 🔨 开发 OpenClaw 各项功能
• 🚀 平台整体演进与升级
• 🔧 Bug 修复与系统优化
• 📝 产品路线图与功能规划
• 💡 新功能创意头脑风暴
• 🔍 系统化调试与问题定位
• ✅ 全面采用 TDD 进行测试驱动开发
• 📊 任务间交叉代码审查

本技能确保 ClawGator 团队始终践行：

• 先思考，再编码（Think before they code）
• 先计划，再构建（Plan before they build）
• 先验证，再交付（Verify before they ship）
• 先测试，再上线（Test before production）

目录结构

/home/clawgator-superpowers/
├── SKILL.md                    - 主技能文档
├── openclaw.plugin.json        - 插件配置文件
├── package.json                 - 元数据文件
├── brainstorming.js              - 核心头脑风暴逻辑
├── index.js                     - 入口文件
├── skills/                       - 来自 obra/superpowers 的全部子技能
│   ├── using-superpowers/       - 基础技能
│   ├── brainstorming/           - 头脑风暴与设计
│   ├── writing-plans/           - 实施计划生成
│   ├── executing-plans/         - 计划执行
│   ├── test-driven-development/ - TDD 工作流
│   ├── systematic-debugging/    - 四阶段调试
│   ├── using-git-worktrees/     - Git worktree 管理
│   ├── subagent-driven-development/ - 子 Agent 驱动开发
│   ├── dispatching-parallel-agents/ - 并行 Agent 调度
│   ├── requesting-code-review/  - 发起代码审查
│   ├── receiving-code-review/   - 接收并应用审查反馈
│   ├── verification-before-completion/ - 完成前验证
│   ├── finishing-a-development-branch/ - 分支收尾
│   └── writing-skills/          - 新技能开发框架
└── README.md                     - 完整文档说明

基础用法

启动新项目

Buat fitur [feature name]

技能将自动执行以下步骤：

1. 激活 using-superpowers
2. 启动 brainstorming 以明确需求
3. 创建新的 git worktree
4. 生成详细实施计划
5. 基于 TDD 执行开发
6. 测试与最终验证

修复 Bug

Fix bug: [bug description]

技能将自动执行以下步骤：

1. 激活 systematic-debugging
2. 执行四阶段根因分析
3. 基于 TDD 实施修复
4. 验证修复有效性
5. 运行全部测试套件

版本： 1.0.0
适用团队： ClawGator 团队
基础来源： obra/superpowers（100% 复用其工作流与全部 14 个子技能）
许可证： MIT