功能描述

Framework pengembangan perangkat lunak lengkap untuk tim ClawGator. Brainstorming, planning, eksekusi sistematis, TDD, debugging, code review, dan git worktrees. Trigger otomatis sebelum memulai proyek atau perubahan kode.

使用说明 (SKILL.md)

ClawGator Superpowers

Name: ClawGator Superpowers
Author: renggap

Framework pengembangan perangkat lunak lengkap untuk tim ClawGator. Dibuat berdasarkan obra/superpowers namun disesuaikan khusus untuk kebutuhan ClawGator.

Kapan Menggunakan

SELALU gunakan skill ini SEBELUM:

Memulai fitur baru atau komponen
Mengubah perilaku atau fungsi
Fix bug atau issue
Perubahan signifikan pada kode
Membuat perencanaan implementasi

Lewati untuk:

Pertanyaan simpel atau pencarian informasi
Perintah satu baris
Melihat konteks proyek (gunakan skill terkait)

Alur Kerja Lengkap

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
└──────────────────────┘

Sub-Skills Tersedia

🎯 Skills Utama (Process)

Skill	Kapan Dipakai	Fungsi
using-superpowers	SELALU di awal conversation	Memandu penggunaan skill
brainstorming	Sebelum coding	Memahami requirement & desain
writing-plans	Setelah desain disetujui	Buat rencana implementasi
executing-plans	Setelah plan siap	Eksekusi plan
finishing-a-development-branch	Setelah selesai	Wrap up branch

🔨 Skills Eksekusi

Skill	Kapan Dipakai	Fungsi
subagent-driven-development	Option 1 eksekusi	Fresh subagent per task
dispatching-parallel-agents	Paralel tasks	Dispatch multiple agents

🧪 Skills Quality

Skill	Kapan Dipakai	Fungsi
test-driven-development	SELALU sebelum coding	RED-GREEN-REFACTOR
systematic-debugging	Jika ada bug	4-phase root cause analysis
verification-before-completion	Sebelum mark selesai	Konfirmasi benar-bener fix

🔧 Skills Git & Review

Skill	Kapan Dipakai	Fungsi
using-git-worktrees	Sebelum coding di new branch	Isolated workspace
requesting-code-review	Antara tasks	Review code terhadap plan
receiving-code-review	Setelah feedback	Apply review feedback

📝 Skills Meta

Skill	Kapan Dipakai	Fungsi
writing-skills	Membuat skill baru	Struktur skill OpenClaw

Prinsip Utama

Iron Laws

NO PRODUCTION CODE WITHOUT A FAILING TEST FIRST (TDD)
NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST (Debugging)
If you think there is even a 1% chance a skill might apply, you ABSOLUTELY MUST invoke it

TDD Cycle

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

Debugging Cycle

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

Prioritas Skill

Ketika multiple skills mungkin relevan:

Process skills first (brainstorming, debugging, writing-plans)
Quality skills second (TDD, systematic-debugging)
Git/Review skills third (worktrees, code-review)
Execution skills fourth (executing-plans, subagent-driven)

Contoh:

"Let's build X" → brainstorming → using-git-worktrees → writing-plans → executing-plans
"Fix this bug" → systematic-debugging → TDD
"Add X" → TDD (sederhana, no plan needed)

Integration dengan OpenClaw

Skill ini terintegrasi penuh dengan OpenClaw:

✅ Automatic triggers pada kata kunci: "build", "create", "implement", "fix", "add"
✅ Folder skills/ berisi 14 sub-skills lengkap
✅ Sub-skills trigger otomatis berdasarkan konteks
✅ using-superpowers sebagai entry point
✅ Tools: brainstorm, plan_review, get_status
✅ OpenClaw Agent integration untuk subagent-driven-development

Pengembangan ClawGator

Tim ClawGator menggunakan skill ini untuk:

🔨 Membangun fitur-fitur OpenClaw
🚀 Mengembangkan platform
🔧 Bug fixing dan improvement
📝 Perencanaan produk
💡 Brainstorming ide-ide baru
🔍 Debugging sistematis
✅ Testing dengan TDD
📊 Code review antar tasks

Skill ini memastikan tim ClawGator selalu:

Think before they code
Plan before they build
Verify before they ship
Test before production

Struktur Folder

/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
└── README.md                     - Dokumentasi lengkap

Penggunaan Dasar

Memulai Proyek Baru

Buat fitur [nama fitur]

Skill akan otomatis:

Mengaktifkan using-superpowers
Brainstorming untuk pahami requirement
Buat git worktree baru
Tulis implementasi plan
Eksekusi dengan TDD
Test dan verify

Fix Bug

Fix bug: [deskripsi bug]

Skill akan otomatis:

Mengaktifkan systematic-debugging
Investigasi root cause (4 phases)
Implement fix dengan TDD
Verify fix
Run semua tests

Versi: 1.0.0 Dibuat untuk: Tim ClawGator Didasarkan: obra/superpowers (100% workflow, 14 sub-skills) Lisensi: MIT

安全使用建议

Before installing, review these points: 1) Inspect hooks/session-start.sh carefully. It injects the whole 'using-superpowers' SKILL.md into session startup and includes a directive asking the agent to emit a particular warning in its first reply — that is an active context-injection and may affect every session. 2) Expect to run manual, system-level commands. The README/SKILL.md asks you to copy files into ~/.openclaw/extensions, edit ~/.openclaw/openclaw.json, and restart the gateway (kill -USR1 or systemctl). Only do this on machines where you control and trust the OpenClaw install. 3) The code contains scripts that run shell commands (child_process/execSync, dot, git fetch) and shell helpers (render-graphs.js, various .sh). These are normal for developer tooling, but verify you trust the author and run them in a safe environment (sandbox or non-production) the first time. 4) Confirm provenance. Source/homepage is unknown and owner ID is just an identifier. If this is meant for your org, prefer a vetted internal copy or ask the ClawGator author for an origin (git URL, commit history) before deploying broadly. 5) Test in a disposable environment first. Install locally in a throwaway user account or VM, run the session start to see what it injects, and verify no unwanted side effects occur (no unexpected network connections, no changes to system services you don't intend). 6) Consider modifying the skill before use: remove or alter the SessionStart hook (or make it opt-in), and avoid blindly following the 'invoke any skill with 1% applicability' rule — that guideline can escalate automated agent actions across many skills. If you want, I can: a) show the exact lines in hooks/session-start.sh that you should pay attention to, b) list all files that execute shell/child_process, or c) suggest a minimal safe-install checklist for trying this plugin in a sandbox.

功能分析

Package: ClawGator Superpowers (mcp) Version: 1.0.0 Description: Framework pengembangan perangkat lunak lengkap untuk tim ClawGator. Brainstorming, planning, eksekusi sistematis, TDD, debugging, code review, dan git worktrees. The 'ClawGator Superpowers' package provides a comprehensive set of AI agent skills and supporting utilities designed for software development workflows, including brainstorming, planning, test-driven development (TDD), systematic debugging, code review, and Git worktree management. The package consists primarily of Markdown files defining AI agent 'skills' (workflows and best practices), along with several executable scripts and a core JavaScript module. Executable components include: - `hooks/session-start.sh`: A shell script that runs on session start to inject context, read skill documentation, and check for legacy configuration. It uses standard shell commands and file I/O, including a robust JSON escaping function. - `skills/systematic-debugging/find-polluter.sh`: A diagnostic shell script to identify which test creates unwanted files or state by running `npm test` on individual test files. This is a legitimate debugging tool for developers. - `skills/writing-skills/render-graphs.js`: A Node.js script that renders Graphviz DOT diagrams from Markdown files into SVG images, executing the `dot` command. This is a benign utility for documentation visualization. - `lib/skills-core.js`: A Node.js module providing core functionalities for skill management, such as parsing frontmatter, discovering skills, resolving skill paths, and checking for Git repository updates using `git fetch` and `git status`. These operations are standard for a self-managing plugin. The `openclaw.plugin.json` manifest defines the plugin's configuration and a set of high-level tools for AI agent interaction, consistent with a development workflow. Documentation files (`.md`) describe the skills, installation, usage, and internal design/testing processes. The `docs/windows/polyglot-hooks.md` explains a cross-platform technique for shell scripts, which is a legitimate compatibility solution. All observed code logic and operations are consistent with the stated purpose of enhancing a developer's workflow within an IDE/agent environment. There are no indications of malicious activities such as unauthorized data access, exfiltration, system compromise, or obfuscation. The package focuses on structured development practices and diagnostic tools.

能力评估

ℹ Purpose & Capability

The skill's name, SKILL.md, package.json and many files align with a developer workflow (brainstorming, TDD, git worktrees, debugging). The included utilities (graphviz renderer, git helper library, debugging scripts) are reasonable for this purpose. However, some included pieces (a SessionStart hook that injects the entire using-superpowers SKILL.md into session context and a script that suggests modifying ~/.openclaw/openclaw.json and restarting an openclaw service) are more intrusive than typical ‘documentation-only’ skills and exceed what a purely passive guidance skill would normally require.

⚠ Instruction Scope

SKILL.md instructs users to copy files into ~/.openclaw/extensions, edit ~/.openclaw/openclaw.json, and restart the OpenClaw gateway or service — these are system-level operations. The session-start hook (hooks/session-start.sh) emits a JSON payload that embeds the full using-superpowers SKILL.md and a warning which explicitly demands that 'IN YOUR FIRST REPLY...' the agent tell the user a specific message; that is an active context injection and an instruction for behavior on every session start. The skill also contains executable scripts (render-graphs.js, shell scripts, and code that can run git fetch via execSync) that, if invoked, will run shell commands and access the file system and network. Those behaviors go beyond passive guidance and broaden the agent's runtime actions.

✓ Install Mechanism

There is no automatic remote installer or download step; the project is instruction + local files. No external URLs or archive extraction are used in an automated install spec. That reduces supply-chain risk compared to remote downloads. However, proposed manual install steps require copying files into user config directories and restarting services (kill -USR1 or systemctl), which are high-impact manual actions and should be done with care.

ℹ Credentials

The skill declares no required environment variables or credentials, which is appropriate. Still, the code and scripts reference $HOME and other local paths, call git fetch (network), call external binaries (dot / graphviz), and instruct edits to ~/.openclaw/openclaw.json and restarting the gateway. Those file and process-level operations are consistent with a developer tooling skill, but they require filesystem and process privileges — make sure you only install this in an environment where such changes are acceptable. Also note the strong instruction in SKILL.md to invoke skills whenever there's a 1% chance they apply — that can cause broad invocation of other sub-skills and elevated access.

⚠ Persistence & Privilege

always:false (good), but the plugin registers a SessionStart hook that runs asynchronously and emits additionalContext on each session start. That gives the skill a persistent foothold in session initialization and injects a potentially large chunk of content (and an explicit behavioral directive) into the agent's context every time sessions start. This behavior is powerful and unexpected for many users; combined with the explicit rule to invoke skills aggressively, it increases the surface area for unintended autonomous actions.

版本历史

v1.0.0

ClawGator Superpowers v1.0.0 - Initial release of a comprehensive software development framework custom for the ClawGator team. - Includes guided workflows for brainstorming, planning, TDD, debugging, code review, and git worktree management. - Features 14 modular sub-skills with clear triggers and usage rules. - Automatic activation before major code changes, new features, or bug fixes. - Thorough process documentation and integration points for the OpenClaw Agent. - Enforces TDD, systematic debugging, and structured code review practices.

元数据

Slug clawgator-superpowers

版本 1.0.0

许可证 —

累计安装 12

当前安装数 11

历史版本数 1

常见问题