ClawGator Superpowers

ClawGator 超能力

为 ClawGator 团队打造的完整软件开发框架。基于 obra/superpowers 构建，并针对 ClawGator 的需求进行了专门调整。

何时使用

在以下操作之前，始终使用此技能：

• 开始开发新功能或组件
• 更改行为或功能
• 修复 bug 或问题
• 对代码进行重大更改
• 制定实现计划

以下情况可跳过：

• 简单问题或信息查询
• 单行命令
• 查看项目上下文（使用相关技能）

完整工作流

Permintaan Pengembangan
    ↓
┌──────────────────────┐
│  USING SUPERPOWERS   │ ← Skill utama - memandu semua langkah
│  (skill dasar)       │   - Menemukan skill yang relevan
│                      │   - Menentukan prioritas skill
└──────────┬───────────┘
           ↓
┌──────────────────────┐
│   BRAINSTORMING      │ ← Memahami requirement & desain
│  (jika butuh desain) │   - Tanya pertanyaan satu per satu
│                      │   - Usulkan 2-3 pendekatan
│                      │   - Validasi desain incrementally
└──────────┬───────────┘
           ↓
┌──────────────────────┐
│  USING GIT WORKTREES│ ← Setup workspace terisolasi
│  (sebelum coding)    │   - Create branch baru
│                      │   - Setup project
│                      │   - Verify baseline tests
└──────────┬───────────┘
           ↓
┌──────────────────────┐
│   WRITING PLANS      │ ← Buat rencana implementasi
│  (jika multi-task)   │   - Pecah jadi tasks kecil (2-5 min)
│                      │   - Exact file paths & complete code
│                      │   - Include TDD steps
└──────────┬───────────┘
           ↓
    ┌──────┴──────┐
    │             ↓
    │  ┌──────────────────────┐
    │  │ SUBAGENT-DRIVEN DEV  │ ← Eksekusi via subagent (option 1)
    │  │  (sesi ini)          │   - Fresh subagent per task
    │  │                      │   - Review antar task
    │  └──────────┬───────────┘
    │
    │  ┌──────────────────────┐
    │  │   EXECUTING PLANS    │ ← Eksekusi batch (option 2)
    │  │  (sesi terpisah)     │   - Batch execution
    │  │                      │   - Review checkpoints
    │  └──────────┬───────────┘
    │
    ↓  ↓
┌──────────────────────┐
│ TEST-DRIVEN DEVELOPMENT │ ← WAJIB untuk semua coding
│  (selalu aktif)         │   - RED: Tulis test, lihat fail
│                        │   - GREEN: Implement minimal code
│                        │   - REFACTOR: Clean up
└──────────┬─────────────┘
           ↓
┌──────────────────────┐
│ SYSTEMATIC DEBUGGING  │ ← Jika ada bug/issue
│  (jika error muncul)  │   - Phase 1: Investigasi root cause
│                      │   - Phase 2: Analisis pola
│                      │   - Phase 3: Hipotesis & testing
│                      │   - Phase 4: Fix & verify
└──────────┬───────────┘
           ↓
┌──────────────────────┐
│   CODE REVIEW        │ ← Review antar tasks
│  (antara tasks)      │   - Requesting: Review code
│                      │   - Receiving: Apply feedback
└──────────┬───────────┘
           ↓
┌──────────────────────┐
│   VERIFICATION       │ ← Konfirmasi benar-bener fix
│  (sebelum selesai)   │   - Test lagi
│                      │   - Cek regressions
└──────────┬───────────┘
           ↓
┌──────────────────────┐
│ FINISHING DEV BRANCH │ ← Selesai branch
│  (setelah semua)     │   - Verify tests
│                      │   - Present options:
│                      │   * Merge ke main
│                      │   * Buat PR
│                      │   * Keep branch
│                      │   * Discard
└──────────────────────┘

可用子技能

🎯 核心技能（流程）

技能	使用时机	功能
using-superpowers	始终在对话开始时	指导技能的使用
brainstorming	编码之前	理解需求与设计
writing-plans	设计获批后	制定实现计划
executing-plans	计划就绪后	执行计划
finishing-a-development-branch	完成后	收尾分支

🔨 执行技能

技能	使用时机	功能
subagent-driven-development	执行选项 1	每个任务使用全新的子 Agent
dispatching-parallel-agents	并行任务	分派多个 Agent

🧪 质量技能

技能	使用时机	功能
test-driven-development	编码之前，始终使用	RED-GREEN-REFACTOR
systematic-debugging	出现 bug 时	4 阶段根因分析
verification-before-completion	标记完成之前	确认问题确实已修复

🔧 Git 与评审技能

技能	使用时机	功能
using-git-worktrees	在新分支中编码之前	隔离的工作区
requesting-code-review	任务之间	根据计划评审代码
receiving-code-review	收到反馈后	应用评审反馈

📝 元技能

技能	使用时机	功能
writing-skills	创建新技能时	OpenClaw 技能结构

🎨 设计技能

技能	使用时机	功能
frontend-design	设计 UI/UX 时	组件、布局、样式

核心原则

铁律

1. 没有先编写失败测试，就不写生产代码（TDD）
2. 没有先调查根因，就不进行修复（调试）
3. 只要你认为某项技能有哪怕 1% 的可能适用，就绝对必须调用它

TDD 循环

RED → Write failing test → Verify fails
GREEN → Implement minimal code → Verify passes
REFACTOR → Clean up → Stay green
REPEAT → Next test

调试循环

Phase 1: Root Cause Investigation
  - Read errors carefully
  - Reproduce consistently
  - Check recent changes
  - Trace data flow

Phase 2: Pattern Analysis
  - Find working examples
  - Compare against references
  - Identify differences

Phase 3: Hypothesis & Testing
  - Form single hypothesis
  - Test it
  - Learn & iterate

Phase 4: Fix & Verify
  - Implement fix at root cause
  - Verify with original issue
  - Run all tests

技能优先级

当多个技能可能相关时：

1. 首先使用流程技能（brainstorming、debugging、writing-plans）
2. 其次使用质量技能（TDD、systematic-debugging）
3. 第三使用 Git/评审技能（worktrees、code-review）
4. 最后使用执行技能（executing-plans、subagent-driven）

示例：

• “Let's build X” → brainstorming → using-git-worktrees → writing-plans → executing-plans
• “Fix this bug” → systematic-debugging → TDD
• “Add X” → TDD（简单情况，无需计划）

与 OpenClaw 集成

此技能与 OpenClaw 完全集成：

• ✅ 根据 “build”“create”“implement”“fix”“add” 等关键词自动触发
• ✅ skills/ 文件夹包含 15 个完整的子技能
• ✅ 子技能会根据上下文自动触发
• ✅ using-superpowers 作为入口点
• ✅ 工具：brainstorm、plan_review、get_status
• ✅ OpenClaw Agent 集成，用于 subagent-driven-development

ClawGator 开发

ClawGator 团队使用此技能来：

• 🔨 构建 OpenClaw 功能
• 🚀 开发平台
• 🔧 修复 bug 并改进
• 📝 规划产品
• 💡 集思广益，提出新想法
• 🔍 系统化调试
• ✅ 使用 TDD 进行测试
• 📊 在任务之间进行代码评审

此技能确保 ClawGator 团队始终：

• 编码前先思考
• 构建前先规划
• 发布前先验证
• 投入生产前先测试

文件夹结构

/home/clawgator-superpowers/
├── SKILL.md                    - Dokumentasi skill utama
├── openclaw.plugin.json        - Konfigurasi plugin
├── package.json                 - Metadata
├── brainstorming.js              - Core brainstorming function
├── index.js                     - Entry point
├── skills/                       - Sub-skills dari obra/superpowers
│   ├── using-superpowers/       - Skill dasar
│   ├── brainstorming/           - Brainstorming & desain
│   ├── writing-plans/           - Rencana implementasi
│   ├── executing-plans/         - Eksekusi plan
│   ├── test-driven-development/ - TDD workflow
│   ├── systematic-debugging/    - 4-phase debugging
│   ├── using-git-worktrees/     - Git worktrees
│   ├── subagent-driven-development/ - Eksekusi via subagent
│   ├── dispatching-parallel-agents/ - Paralel agents
│   ├── requesting-code-review/  - Review code
│   ├── receiving-code-review/   - Terima feedback
│   ├── verification-before-completion/ - Verify fix
│   ├── finishing-a-development-branch/ - Wrap up
│   ├── writing-skills/          - Buat skill baru
│   └── frontend-design/         - Design UI/UX
└── README.md                     - Dokumentasi lengkap

基本用法

启动新项目

Buat fitur [nama fitur]

技能将自动：

1. 启用 using-superpowers
2. 通过头脑风暴了解需求
3. 创建新的 git worktree
4. 编写实现计划
5. 使用 TDD 执行
6. 测试并验证

修复 Bug

Fix bug: [deskripsi bug]

技能将自动：

1. 启用 systematic-debugging
2. 调查根本原因（4 个阶段）
3. 使用 TDD 实现修复
4. 验证修复
5. 运行所有测试

---

版本： 1.0.1 为以下团队创建： ClawGator 团队 基于： obra/superpowers（100% 工作流，15 个子技能） 许可证： MIT