requirements-mcp-server: Command for Claude Code

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ツールの代わりにコマンドラインでも実行可能:

# デフォルト設定で起動
npx miyabi auto

# 最大Issue数と間隔を指定
npx miyabi auto --max-issues 10 --interval 30

# 1回だけ実行（ポーリングなし）
npx miyabi auto --max-issues 5 --interval 0

環境変数

.env ファイルに以下を設定:

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経由

# Ctrl+C で停止
^C

プログラム的停止

# 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上で確認

# 処理されたIssueを確認
gh issue list --label "status:in-progress"

# 作成されたPRを確認
gh pr list --label "automated"

# Projectsボードで進捗確認
gh project list