wavybaby

wavybaby

Claude Code のネイティブなスキルディスパッチを、標準では備わっていない次の 3 つの機能で拡張します。

1. CoVe - 生成したすべてのコードに対する Chain-of-Verification による自己監査
2. スキルの検出 - まだインストールされていない skills.sh 上の 29,000 件以上のスキルを検索
3. ツールキットの知識 - Claude が本来は把握していない MCP サーバー、設定、リポジトリ

Claude 組み込みのスキルシステムを置き換えるわけではありません。その上に機能を重ねます。すでにインストールされているスキルへのディスパッチは、Claude のネイティブな Skill() ツールに任せてください。あなたの役割は、それでは対応できないすべてのことです。

---

フェーズ 1：ネイティブディスパッチの強化

/wavybaby [task] が呼び出されたとき：

1A. まず Claude のネイティブシステムに任せる

Claude は関連するインストール済みスキルを自動的に検出して呼び出します。これを重複して行わないでください。

1B. Claude のディスパッチで見落とされた部分を補う

まだインストールされていないスキルを検索してインストールする：

# Search for relevant skills
npx skills find [keywords from task]

# Install them immediately — don't just recommend, DO IT
npx skills add <owner/repo> --skill <name> --agent claude-code -y

スキルのインストール許可を求めないでください。そのままインストールしてください。-y フラグで自動的に確認されます。タスクに関連するスキルがあれば、インストールして次に進んでください。

不足している MCP サーバーをインストールする。 推奨するだけでなく、インストールコマンドを直接実行してください：

# Example: always install Context7 if not present
claude mcp add context7 -- npx -y @upstash/context7-mcp

以下のツールキットナレッジベースを使って、プロジェクトの技術スタックに適したサーバーを選び、関連するものをすべてインストールしてください。

不足しているプロジェクト設定をセットアップする。 CLAUDE.md、settings.local.json、または .planning/ ディレクトリがなく、タスクに必要な場合は、確認を求めずに直接作成してください。

---

フェーズ 2：CoVe プロトコル（中核となる拡張機能）

Claude Code に根本的に欠けているのは、自己検証です。

CoVe を適用する場合

必ず適用するケース：

• 状態を持つコード（useState、useReducer、context、stores）
• 非同期／並行処理のロジック（useEffect、mutations、subscriptions）
• データベース操作（queries、transactions、migrations）
• 認証／セキュリティのコード
• キャッシュ無効化ロジック
• 金融または精度が重要な計算
• バグが明白ではなく、見つけにくいコード

次の場合に限り省略する：

• 簡単な 1 行のコード
• 純粋な書式／スタイルの変更
• README／ドキュメントのみの変更
• ユーザーが「quick」「prototype」「just do it」と明示した場合

4 段階のプロトコル

ステージ 1：生成（未検証のドラフト）

最善の解決策を作成します。[UNVERIFIED DRAFT] と記します。この出力は意図的に信頼できないものとして扱います。

ステージ 2：検証計画

役割を切り替えます。ここからは作成者ではなく監査者です。

問題を解き直さずに、確認すべき内容を列挙します：

## Verification Plan
- [ ] [API/library usage]: Is this the correct method/signature?
- [ ] [Edge case]: What happens when [input] is [boundary value]?
- [ ] [Concurrency]: Can [operation A] race with [operation B]?
- [ ] [Type safety]: Is this cast/assertion actually safe?
- [ ] [State]: Can this reach an invalid state?
- [ ] [Environment]: Does this assume [runtime/version/config]?
- [ ] [Performance]: Is the claimed complexity accurate?
- [ ] [Security]: Is [input] validated before [operation]?

検証対象は一般論ではなく、作成したコードに固有のものでなければなりません。

ステージ 3：独立した検証

重要：ステージ 1 の推論を再度正当化してはいけません。各項目を最初から検証してください。

チェックリストの各項目について：

### [Item]
- **Verdict**: ✓ PASSED / ✗ FAILED / ⚠ WARNING
- **Evidence**: [Concrete proof, counterexample, or test scenario]
- **Fix**: [If failed, the specific change required]

次の検証手法を使います：

敵対的テスト - 自分のコードが壊れる条件を試します：

• 並行操作間の競合状態
• 境界値での 1 つずれ
• Null／undefined の経路
• コールバック内の古いクロージャ
• ダブルクリック、短時間での連続実行
• 処理中のネットワーク障害
• 非同期処理中のコンポーネントのアンマウント

制約の検証 - 厳格な要件との整合性を確認します：

• Node／ブラウザーのバージョン互換性
• TypeScript の strict モードへの準拠
• データベースの分離レベル
• API のレート制限またはペイロード制限

差分推論 - 代替案と比較します：

• この方法は単純な方法より優れているか？
• どのようなトレードオフがあるか？

セマンティック行監査（重要な処理経路のみ）：

• 各行は何をするか？
• 削除しても動作が変わらない行に印を付ける

ステージ 4：修正済みの解決策

ステージ 3 で見つかった修正をすべて反映した最終実装を作成します。

## [VERIFIED]

### Changes from Draft
1. [Change]: [Why]
2. [Change]: [Why]

### Verification Summary
- Checked: [N] items
- Passed: [X] | Fixed: [Y] | Warnings: [Z]

[Final code]

---

フェーズ 3：あいまいなプロンプトの展開

ユーザーのプロンプトがあいまいな場合、CoVe を実行する前に内容を具体化します。

入力： "add pagination"

展開：

Task: Add pagination to [detected table/list component]

Requirements (inferred):
- Page size selection
- Page navigation controls
- URL state sync (survives refresh)
- Loading state during page transitions
- Total count display
- Keyboard accessibility

Technical considerations:
- Query key must include page params
- Cache per-page for back navigation
- Handle items added/removed between pages

続いて、展開したタスクに 4 段階の CoVe プロトコルを適用します。

入力： "fix the bug"

展開：

Task: Investigate and fix the bug in [detected context]

Steps:
1. Read the relevant code and understand current behavior
2. Identify the root cause (not just symptoms)
3. Implement fix with CoVe verification
4. Verify fix doesn't introduce regressions

---

ツールキットナレッジベース

Claude はこれらを本来把握していません。関連する場合は直接インストールしてください。確認を求めず、そのまま実行してください。

MCP サーバー — 関連する場合に自動インストール

サーバー	インストールするタイミング	コマンド
Context7	ライブラリを使用する場合。ドキュメントに関する幻覚を防ぎます	claude mcp add context7 -- npx -y @upstash/context7-mcp
GitHub	PR ワークフロー、課題の追跡、コードレビュー	claude mcp add github --transport http https://api.githubcopilot.com/mcp/
Sequential Thinking	複雑なアーキテクチャ上の判断	claude mcp add thinking -- npx -y mcp-sequentialthinking-tools
Supabase	Supabase プロジェクト	claude mcp add supabase -- npx -y @supabase/mcp-server
Sentry	エラー追跡、本番環境の問題のデバッグ	claude mcp add sentry --transport http https://mcp.sentry.dev/mcp
Notion	ドキュメントのワークフロー	claude mcp add notion --transport http https://mcp.notion.com/mcp

検索するスキルリポジトリ

リポジトリ	最適な用途	インストールコマンド
vercel-labs/agent-skills	React、Next.js、Web デザイン	npx skills add vercel-labs/agent-skills
vercel-labs/next-skills	Next.js 15/16 の詳細	npx skills add vercel-labs/next-skills
anthropics/skills	ドキュメント、デザイン、MCP ビルダー	npx skills add anthropics/skills
trailofbits/skills	セキュリティ監査	npx skills add trailofbits/skills
obra/superpowers-marketplace	TDD、計画、デバッグ	/plugin marketplace add obra/superpowers-marketplace
expo/skills	React Native / Expo	npx skills add expo/skills
stripe/skills	決済	npx skills add stripe/skills
supabase/agent-skills	Postgres のベストプラクティス	npx skills add supabase/agent-skills
cloudflare/skills	Workers、エッジ、Web パフォーマンス	npx skills add cloudflare/skills
huggingface/skills	ML トレーニング、データセット	npx skills add huggingface/skills
sentry/skills	コードレビュー、コミット	npx skills add sentry/skills
K-Dense-AI/claude-scientific-skills	125 以上の科学分野のツール	npx skills add K-Dense-AI/claude-scientific-skills

動的検索

# When you don't know if a skill exists
npx skills find [keyword]

# Examples
npx skills find "stripe payments"
npx skills find "terraform"
npx skills find "graphql"

設定テンプレート

プロジェクトに設定がない場合にのみ、これらを推奨してください。

settings.local.json（フルスタック）：

{
  "permissions": {
    "allow": [
      "WebSearch",
      "Bash(npm *)", "Bash(pnpm *)",
      "Bash(git *)", "Bash(gh *)",
      "Bash(docker *)",
      "mcp__plugin_context7_context7__*",
      "Skill(*)"
    ]
  }
}

settings.local.json（Python）：

{
  "permissions": {
    "allow": [
      "Bash(python *)", "Bash(pip *)", "Bash(poetry *)",
      "Bash(pytest *)", "Bash(docker-compose *)",
      "Bash(git *)"
    ]
  }
}

---

スタック別の敵対的チェックリスト

タスクに以下のテクノロジーが関係する場合は、CoVe のステージ 3 で使用してください。

React / Next.js

- [ ] useEffect dependency array complete (no missing, no extra)
- [ ] Cleanup function handles subscriptions/timers/AbortController
- [ ] No stale closures in event handlers or callbacks
- [ ] Server/Client component boundary correct
- [ ] Keys stable and unique in lists
- [ ] Suspense boundaries handle loading

TanStack Query

- [ ] Query key includes ALL params that affect the result
- [ ] Mutations invalidate the correct queries
- [ ] Optimistic updates roll back correctly on failure
- [ ] No race between refetch and mutation
- [ ] Loading/error states handled in UI

Prisma / データベース

- [ ] Related writes wrapped in transaction
- [ ] N+1 queries avoided (include/select)
- [ ] Concurrent update conflicts handled
- [ ] Null handling explicit
- [ ] Indexes exist for query patterns

認証 / セキュリティ

- [ ] Auth checked server-side, not just UI
- [ ] Input validated before database/API call
- [ ] No secrets in client bundle
- [ ] CSRF/XSS protections in place
- [ ] Ownership verified for user-scoped resources

非同期処理 / 並行処理

- [ ] Promise.all for independent operations
- [ ] Race conditions prevented
- [ ] Cleanup on unmount/cancel
- [ ] Debounce/throttle where appropriate
- [ ] Error handling doesn't swallow failures

---

自律モード：Ralph ループ

大規模なタスク（機能全体、移行、複数ファイルのリファクタリング）では、/spidey を推奨してください。

/spidey [project description]

次の機能を備えた自律開発ループをセットアップします。

• すべてのタスクが完了するまで Claude Code を継続して実行します
• 行き詰まるとサーキットブレーカーが停止します（3 ループ進展がなければ停止）
• 二重条件の終了ゲートにより、早すぎる停止を防ぎます
• セッションはイテレーションをまたいで保持されます（Claude はコンテキストを記憶します）
• レート制限により API の無駄な使用を防ぎます

Ralph と通常の実行を推奨する状況：

シナリオ	推奨
単一ファイルの変更	通常の実行
関連する変更が 3〜5 件	/rnv（CoVe 検証）
タスクが 10 件以上、機能全体	/spidey（自律ループ）
数日がかりの構築	段階的な fix_plan.md と組み合わせた /spidey

---

実行概要

/wavybaby [task]
    │
    ├─ Claude's native dispatch handles installed skills
    │
    ├─ wavybaby extends with:
    │   ├─ Search skills.sh for uninstalled skills
    │   ├─ Recommend missing MCP servers
    │   ├─ Suggest project config if missing
    │   │
    │   ├─ CoVe Protocol (if non-trivial):
    │   │   ├─ Stage 1: Generate [UNVERIFIED]
    │   │   ├─ Stage 2: Plan verification targets
    │   │   ├─ Stage 3: Independently verify each
    │   │   └─ Stage 4: Produce [VERIFIED] solution
    │   │
    │   └─ Ralph Loop (if large/autonomous task):
    │       └─ /spidey → continuous loop until done
    │
    └─ Output: Verified code + verification report

Other commands:
  /rnv [task]     → just CoVe verification
  /spidey [task]   → just Ralph autonomous loop setup

---

処理中：$ARGUMENTS