| name | inko |
| description | Akaghef inko 通信スキル（Claude Director 版）。 Mac/Windows 間のエージェント通信を行うときに使う。 以下の場面でトリガーする: - 「Windows Codex に送って」「Win に伝えて」「a2a で投げて」と言われたとき - 「inko で送って」「メッセージ送って」「依頼を投げて」と言われたとき - Bridge の inbox/pending を確認・処理するとき - エージェント間の同期待ち・返信確認をするとき - a2a や inko の層の使い分けを判断するとき
|
inko — Claude Director 版
Claude（Director）が Akaghef-Bridge 経由で Windows Codex（または他エージェント）と
通信するためのスキル。
層モデル
ユーザー意図 / Director 判断
→ inko 会話契約（call / message / handoff）
→ a2a 低レイヤー輸送（Bridge filesystem への JSON 配置）
→ ~/Akaghef-Bridge/pending/mac_to_windows/
- inko = 会話の意味を持つ上位レイヤー（call か message か handoff かを決める）
- a2a = Bridge への JSON 配置だけを担う低レイヤー輸送（意味を持たない）
- 「a2a で送って」と言われても、会話意味は inko で決定してから a2a で配送する
操作の選択
| 状況 | 使うもの |
|---|
| 返信を待たず非同期に依頼・通知 | inko message |
| 同期的に返答を待つ（このターンで close まで保持） | inko call |
| 人間への引き継ぎ | human handoff |
| Bridge queue の掃除・ルーティングデバッグのみ | raw a2a |
通常の Director→Windows Codex 依頼はほぼ inko message。
true call は Claude がそのターンで call.close まで待機する場合のみ。
Inko Message の送り方
1. ファイル名を決める
{UTC timestamp}Z-mac-claude-inko-message-{topic}-{seq}.json
例: 20260615T120000Z-mac-claude-inko-message-data-sync-verify-001.json
タイムスタンプ生成:
date -u +%Y%m%dT%H%M%SZ
2. パケットを作る
{
"schema": "akaghef.inko.message.v1",
"kind": "request.inko.message",
"id": "{ファイル名から拡張子を除いたもの}",
"thread": "{テーマを表すスラッグ}",
"from": "mac-claude",
"to": "windows-codex",
"created_at_utc": "{UTC ISO8601}",
"priority": "normal",
"reply_to": [],
"title": "{件名}",
"basis": "DP2 / async inko message",
"summary": "{1行要約}",
"body": "{本文}",
"request": {
"operation": "{操作名}",
"reply_required": true
},
"transport": {
"layer": "a2a",
"route": "Akaghef-Bridge pending/mac_to_windows"
}
}
kind の使い分け:
request.inko.message — 依頼・確認要求result.inko.message — 結果報告（返信）notify.inko.message — 通知のみ（返信不要）
3. Bridge に配置する
cp /tmp/{packet}.json ~/Akaghef-Bridge/pending/mac_to_windows/{filename}.json
Claude は直接 Bash で書く（Codex 経由不要）。
Inko Call の送り方
同期呼び出し。Claude がこのターンで返答を待って call.close まで処理する場合のみ使う。
call.open パケット
{
"schema": "akaghef.inko.call.v1",
"kind": "call.open",
"id": "{id}",
"call_id": "inko-{UTC timestamp}-{topic}",
"thread": "{thread}",
"from": "mac-claude",
"to": "windows-codex",
"created_at_utc": "{UTC ISO8601}",
"priority": "normal",
"title": "{件名}",
"goal": "{達成条件}",
"done_when": "{完了判定}",
"max_rounds": 3,
"timeout_seconds": 300,
"basis": "DP2 / inko call"
}
call.close パケット
{
"schema": "akaghef.inko.call.v1",
"kind": "call.close",
"call_id": "{同じ call_id}",
"thread": "{thread}",
"from": "mac-claude",
"to": "windows-codex",
"status": "done",
"summary": "{結果要約}"
}
True call は call.open → 返答待ち → call.close のサイクルを守る。
返答を待たずに終わるなら inko message を使うこと。
Bridge の確認・受信
ls ~/Akaghef-Bridge/pending/windows_to_mac/
cat ~/Akaghef-Bridge/pending/windows_to_mac/{file}.json | python3 -m json.tool
mv ~/Akaghef-Bridge/pending/windows_to_mac/{file}.json \
~/Akaghef-Bridge/done/windows_to_mac/
DP ルーター
- DP0: inko プロトコル自体の設計・修正。実際には送らない。
- DP1: 初回実地送信。スモークテスト。thread・goal・timeout を明示する。
- DP2: 通常運用。既存ルートを使い、結果を append で記録する。
注意事項
