Miyabi MCP Bundle

--- description: Miyabi Water Spider全自動モード起動 --- # Miyabi Water Spider全自動モード Water Spider Agent（水すまし）を起動して、GitHub Issueを自動的に検出・処理します。 ## MCPツール ### `miyabi__auto` Water Spider全自動モードを起動 **パラメータ**: - `maxIssues`: 最大処理Issue数（デフォルト: 5） - `interval`: ポーリング間隔（秒）（デフォルト: 60） **使用例**: ``` 全自動モード起動（デフォルト設定）: miyabi__auto({}) 最大10 Issue、30秒間隔: miyabi__auto({ maxIssues: 10, interval: 30 }) ``` ## 動作フロー ``` Water Spider Agent起動 ↓ GitHub Issueポーリング（60秒ごと） ↓ 未処理Issueを検出 ↓ 優先順位付け（緊急度・規模・種別） ↓ CoordinatorAgent起動 ↓ ├─ IssueAgent（分析・Label付与） ├─ CodeGenAgent（コード生成） ├─ ReviewAgent（品質チェック） └─ PRAgent（Draft PR作成） ↓ 次のIssueへ（maxIssues到達まで繰り返し） ``` ## 優先順位付けロジック Water Spiderは以下の順序でIssueを処理します: 1. **緊急度が高い**: `緊急度-高`, `緊急度-即時` ラベル付き 2. **セキュリティ関連**: `security`, `vulnerability` ラベル付き 3. **ブロッカー**: `status:blocked` 以外で、依存関係が解決済み 4. **規模が小さい**: `規模-小` ラベル付き（クイックウィン） 5. **作成日時が古い**: FIFOで公平に処理 ## コマンドライン実行 MCPツールの代わりにコマンドラインでも実行可能: ```bash # デフォルト設定で起動 npx miyabi auto # 最大Issue数と間隔を指定 npx miyabi auto --max-issues 10 --interval 30 # 1回だけ実行（ポーリングなし） npx miyabi auto --max-issues 5 --interval 0 ``` ## 環境変数 `.env` ファイルに以下を設定: ```bash GITHUB_TOKEN=ghp_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx ANTHROPIC_API_KEY=sk-ant-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx REPOSITORY=owner/repo DEVICE_IDENTIFIER=MacBook Pro 16-inch ``` ## 停止方法 ### MCPツール経由 Water Spiderはバックグラウンドで実行されないため、Claude Codeセッション終了時に自動停止します。 ### CLI経由 ```bash # Ctrl+C で停止 ^C ``` ### プログラム的停止 ```bash # maxIssues到達で自動停止 npx miyabi auto --max-issues 3 # interval=0 で1回のみ実行 npx miyabi auto --interval 0 ``` ## 成功条件 Water Spiderが正常に動作するための条件: ✅ **環境**: - `GITHUB_TOKEN` が設定済み - `ANTHROPIC_API_KEY` が設定済み（CodeGenAgent用） - `REPOSITORY` が正しい形式（owner/repo） ✅ **権限**: - GitHubトークンに `repo`, `workflow` 権限 - リポジトリへの書き込み権限 ✅ **Issue**: - 未処理Issueが存在する - Issueがブロック状態でない（`status:blocked` ラベルなし） ## 処理結果の確認 ### GitHub上で確認 ```bash # 処理されたIssueを確認 gh issue list --label "status:in-progress" # 作成されたPRを確認 gh pr list --label "automated" # Projectsボードで進捗確認 gh project list ``` ### ログで確認 ```bash # 実行ログ確認 cat .ai/logs/$(date +%Y-%m-%d).md # 詳細レポート確認 cat .ai/parallel-reports/agents-parallel-*.json | jq ``` ## エラーハンドリング ### Issue処理失敗時 Water Spiderは以下の場合にIssueをスキップして次へ進みます: - ❌ API呼び出し失敗（3回リトライ後） - ❌ 品質スコア不合格（<80点） - ❌ テスト実行失敗 - ❌ エスカレーション条件に該当 失敗したIssueには自動的にコメントが追加され、適切な担当者にエスカレーションされます。 ### レート制限 GitHub API レート制限に達した場合: 1. 自動的に待機（Retry-After ヘッダー参照） 2. 指数バックオフで再試行 3. 3回失敗後にエラー終了 ## 使用例 ### 例1: 一括処理（5件まで） ``` あなた: "全自動モードで未処理Issueを5件処理して" Claude: [miyabi__auto({ maxIssues: 5 }) を実行] Water Spider Agent起動 ✓ Issue #123を検出 → CoordinatorAgent起動 → CodeGenAgent: コード生成完了 → ReviewAgent: 品質スコア 85/100 ✅ → PRAgent: Draft PR #124作成 ✓ Issue #125を検出 → CoordinatorAgent起動 → ... 完了: 5件のIssueを処理しました ``` ### 例2: 継続監視モード ``` あなた: "30秒ごとにIssueをチェックして、最大10件処理" Claude: [miyabi__auto({ maxIssues: 10, interval: 30 }) を実行] Water Spider Agent起動（継続監視モード） [00:00] ポーリング中... [00:30] ポーリング中... Issue #130検出 → 処理開始 [01:00] ポーリング中... [01:30] ポーリング中... Issue #131検出 → 処理開始 ... 完了: 10件のIssueを処理しました（自動停止） ``` ## トラブルシューティング ### Water Spiderが起動しない ``` ❌ Error: GITHUB_TOKEN is required 解決策: 1. .envファイルを確認 2. GITHUB_TOKEN=ghp_... を追加 ``` ### Issueが処理されない ``` ⚠️ No unprocessed issues found 確認: 1. gh issue list で未処理Issueがあるか確認 2. status:blocked ラベルが付いていないか確認 3. 依存関係が解決されているか確認 ``` ### API制限エラー ``` ❌ GitHub API rate limit exceeded 解決策: 1. レート制限リセットまで待機（通常1時間） 2. GitHub Apps トークンを使用（レート制限が緩い） 3. --interval を長くする（例: 300秒） ``` ## ベストプラクティス ### 🎯 推奨設定 **通常運用**: ```bash npx miyabi auto --max-issues 10 --interval 60 ``` **夜間バッチ処理**: ```bash npx miyabi auto --max-issues 50 --interval 0 ``` **テスト・検証**: ```bash npx miyabi auto --max-issues 1 --interval 0 --dry-run ``` ### ⚠️ 注意事項 - **レート制限**: GitHub APIは1時間あたり5,000リクエスト制限があります - **並列実行**: 複数のWater Spiderを同時実行しないでください（競合の可能性） - **Draft PR**: 作成されるPRは全てDraftです。人間レビュー後にマージしてください --- 💡 **ヒント**: Water Spiderは「水すまし」のように、表面をさっと移動しながらタスクを次々と処理します。