注意：エンドポイントを呼び出す前に、この SKILL.MD 全体を必ずお読みください。
Agent Inbox
ファイルベースのエージェント間メッセージングとヘッドレスディスパッチ、タスクモニター統合を提供します。
コアワークフロー
- 送信: エージェントAがプロジェクトBにバグ/リクエストを送信（モデル＋検証コマンド付き）
- トリアージ: AIが重要度を分類し、優先度/モデルを調整、プロジェクトにルーティング
- ディスパッチ: 指定されたモデルでヘッドレスエージェントを起動し、問題を修正
- 追跡: タスクモニターがリアルタイム進捗を表示（0% → 25% → 50% → 75% → 100%）
- 検証: 自動承認前にテストコマンドを実行 — 失敗時はエージェントにループバック
- スレッド: 複数メッセージの会話のために返信/やり取りスレッドを管理
セットアップ
# プロジェクトの登録（初回のみ）
.pi/skills/agent-inbox/agent-inbox register memory /home/user/workspace/memory
.pi/skills/agent-inbox/agent-inbox register scillm /home/user/workspace/litellm
# 一覧表示 / 確認
.pi/skills/agent-inbox/agent-inbox projects
.pi/skills/agent-inbox/agent-inbox whoami
コマンド
| コマンド | 説明 |
|---|---|
register <name> <path> | プロジェクトを登録 |
unregister <name> | プロジェクトを削除 |
projects [--json] | 登録済みプロジェクトを一覧表示 |
whoami | カレントディレクトリから検出されたプロジェクトを表示 |
send --to PROJECT --type TYPE "msg" | メッセージを送信（タイプ: bug, request, info, question） |
check [--project P] [--all] [--quiet] | 受信箱を確認 |
list [--project P] [--status S] [--json] | メッセージを一覧表示 |
read MSG_ID [--json] | メッセージを読む |
ack MSG_ID [--note "..."] | 承認/完了 |
reply MSG_ID "msg" | 返信（自動スレッド） |
thread THREAD_ID | スレッド全体のやり取りを表示 |
update-status MSG_ID STATUS [--note] | ステータスを手動更新 |
triage classify --message "..." [--no-llm] | 手動トリアージ分類 |
triage route --message "..." | ファイルパスで自動ルーティング |
triage log --msg-id ID | トリアージ決定ログを表示 |
triage webhook-add --url URL --events E | Webhookを登録 |
送信オプション
| オプション | 説明 | デフォルト値 |
|---|---|---|
--model MODEL | AIモデル: sonnet, opus-4.5, codex-5.2, codex-5.2-high | sonnet |
--timeout MINUTES | エージェントの最大作業時間 | 30 |
--test COMMAND | 自動承認前の検証コマンド | なし |
--no-dispatch | 自動起動を無効化 | False |
--context-file FILE | コンテキストファイルを添付（複数指定可） | なし |
--priority PRIORITY | low, normal, high, critical | normal |
--no-triage | AIトリアージをスキップ | False |
--dry-run | 送信せずにメッセージJSONを表示 | False |
モデル選択
| モデル | ユースケース |
|---|---|
sonnet | 簡単な修正、タイポ |
opus-4.5 | 複雑な分析、アーキテクチャ |
codex-5.2 | 標準的なバグ修正 |
codex-5.2-high | 深い推論、競合状態 |
AIトリアージ
メッセージは自動的に重要度で分類されます：
- critical: クラッシュ、データ損失、セキュリティ、本番停止 →
opus-4.5 - high: エラー、例外、障害、破損、リグレッション →
opus-4.5 - medium: バグ、問題、不正、予期しない動作 →
sonnet - low: タイポ、見た目、機能強化、軽微 →
sonnet
自動ルーティングはメッセージからファイルパスを抽出し、登録されたプロジェクトと照合します。
ステータス進行
pending → dispatched (25%) → in_progress (50%) → needs_verification (75%) → done (100%)
メモリプリフック
ディスパッチャは起動前に /memory を照会し、類似のバグや過去の解決策を検索します。
プロアクティブチェック
エージェントはセッション開始時、プロジェクト切り替え時、重要な作業前に、そしてユーザーが別のエージェントやプロジェクトに言及したときに受信箱を確認する必要があります。
ストレージ
~/.agent-inbox/
├── pending/ # 未処理メッセージ
├── done/ # 承認済みメッセージ
├── logs/ # ディスパッチログ
├── task_states/ # タスクモニターの状態ファイル
├── triage_logs/ # AIトリアージ決定ログ
├── webhooks.json # 登録済みWebhook
└── projects.json # プロジェクトレジストリ
使用例
# 検証付きバグ送信（ヘッドレスOpusエージェントを起動し、テストが通れば自動承認）
python inbox.py send --to scillm --type bug --model opus-4.5 \
--test "pytest tests/test_providers.py -x" \
"Race condition in provider initialization"
# コンテキストファイルを添付
python inbox.py send --to scillm --type bug --model opus-4.5 \
--context-file src/server.py --context-file /tmp/traceback.txt \
"Server crash on startup"
# 受信箱の確認と処理
python inbox.py check --all
python inbox.py read scillm_abc123
python inbox.py ack scillm_abc123 --note "Fixed in commit abc123"
# スレッド形式のやり取り
python inbox.py reply scillm_abc123 "Can you provide the stack trace?"
python inbox.py thread scillm_abc123
ディスパッチャデーモン
python dispatcher.py start # バックグラウンド実行
python dispatcher.py start --foreground # デバッグ用（フォアグラウンド）
python dispatcher.py status
python dispatcher.py stop
環境変数
| 変数 | 説明 | デフォルト値 |
|---|---|---|
AGENT_INBOX_DIR | 受信箱ディレクトリ | ~/.agent-inbox |
TASK_MONITOR_API_URL | タスクモニターURL | http://localhost:8765 |
CLAUDE_PROJECT | 現在のプロジェクト名 | 自動検出 |
Claude Codeフックとの統合
{
"hooks": {
"on_session_start": [
".pi/skills/agent-inbox/agent-inbox check --project $(basename $PWD) || true"
]
}
}