amq-cli

AMQ CLI

すべてのキュー操作には amq CLI を使用してください。Maildir ファイルを直接編集しないでください。 AMQ は連携のための通信を担いますが、タスクの計画、ワークツリー、承認、成果物の引き渡しは、引き続き呼び出し元またはオーケストレーターが管理します。

正しいコンテキストで開始する

coop exec の内部では、提供された環境をそのまま使い、amq コマンドをそのまま実行してください。 --me を上書きしたり、ルートを再構築したりしないでください。外部で実行する場合は、読み取りや送信の前に完全なコンテキストを解決してエクスポートします。

amq_context="$(amq env --me "<handle>" --export)" && eval "$amq_context" &&
  amq drain --include-body

名前付きセッションの場合は、amq env に --session <name> を追加します。評価済みのコンテキストは、1 つのセッションに紐付いた 1 つのターミナルとして扱ってください。意図的にルーティングする場合は --session または --project を使用し、参加中のコマンドを生の --root で別のキューに向けないでください。

起動中のウェイクで受信する

セッション開始時のコンテキストに wake=live(...) と記載されている場合、または amq wake check --me <handle> --json が injection mode として none 以外を示す live_wake: true を報告する場合、ウェイクが通知を届けます。 通知が届いたら amq drain --include-body を実行し、メッセージに対応してください。

デフォルトの drain は、保留中のメールを含め、ファイル名順に最大 20 件のメッセージを読み取ります。1 回の処理で全件を取得した後は、amq list --new --limit 1 を確認し、必要に応じて上限付きの drain を続けてください。受信箱が空だと決めつけないでください。既知の処理可能な件数に限り、--limit 0 を使用してください。緊急の保留回避を行っても、drain の順序は変わりません。

起動中のウェイクのもとでは、amq watch、amq monitor、スリープを挟んだポーリングを実行したり、別の受信箱ウォッチャーを起動したりしないでください。ブロッキング待機を行うと、通知がその後ろに滞留する間、あなたのターンが保持されます。作業が完了したらターンを終了してください。メールを待つだけのためにツールを実行し続けたり、何もせず定期的に確認を送ったりしないでください。

ウェイクでは、hold_normal および hold_low の設定により、通常メールの最初の通知を保留できます。5m / 30m はオプトインの設定例です。設定された再試行ポリシーは、最初の試行後に適用されます。 緊急の優先度では保留が適用されません。通常の緊急メールでも、デバウンスと入力延期を経由します。設定された割り込みラベルが付いた緊急メールは、割り込み経路に従います。 時間的制約のある判定やブロック解除の依頼には、send または reply で --priority urgent を使用してください。その他のレビューへの返信は、デフォルトで通常の優先度のままです。

Claude Code では、amq wake install-dialog-hook を実行すると、AskUserQuestion、ExitPlanMode、または権限ダイアログが開いている間、ウェイクが通知を保留します。保留された通知は、回答後、またはそのターンが終了したときに届きます。

ウェイクの実行中でも、ウェイク設定（保留、デバウンス、プレビュー、ベル、入力延期、割り込み通知）は再起動せずに適用できます。amq wake config --me <handle> で設定を表示し、--hold-normal 5m --wait で設定を指定してウェイクへの適用を待ちます。--unset <key> でデフォルトに戻し、--machine でこのユーザーのデフォルトを設定します。 実行中のウェイクでは、注入フラグは変更できません。終了コードと復旧方法については、ウェイクの操作を参照してください。

注入を行うウェイクがない場合は、操作ガイドに記載された受信方法を使用してください。通知のみのウェイク（--inject-mode none）とスーパーバイザーの monitor サービスを組み合わせる構成も、サポート対象です。

有用な引き継ぎを送る

関連する一連の作業については、成果物のパス、該当するソースまたはダイジェスト、チェック内容、失敗した部分や保留中の部分、次のアクションまたは担当者を記載した完了時の引き継ぎを 1 件送信してください。独立したブロッカーは速やかに送信し、受信者が残りの完了前に対応できる場合は、部分的な結果を送信してください。

作業の開始時、状態・判断・結果が変わったとき、または合意済みのエスカレーション時に、状況を送信してください。ファイルごとの完了通知や、変化のない定期報告は避けてください。 自動化された呼び出し元は、項目、リビジョン、イベントごとの重複抑制を担います。AMQ のスレッドはメッセージを関連付けますが、繰り返し送信されたメッセージを重複排除するものではありません。

タスクの振り分け

必要なこと	読むもの、または実行するもの
送信、返信、受信箱の処理、受領確認の調査、または診断	運用ガイドを使用します。
2 エージェントによる調査と設計、または workflow:spec とラベル付けされた受信メッセージ	amq-spec スキルを使用します。パートナーの内容を読む前に独自に調査し、その後 spec/<topic> スレッドに従います。
協力時の役割と段階的な連携	協力モードを読みます。
Claude Code Agent Teams	スウォームモードを読みます。
プロジェクト横断の成果物提供や意思決定のスレッド	プロジェクト横断のルーティングを読みます。
登録済みの Mac 上の Grok Bot	登録済みマシンでの実行を読みます。プロジェクトやセッションを特定する前に、マシンを選択してください。
2 つの個別のホストキュー、または amq-bridge	コンパニオンの amq-bridge を使用し、別の環境の --root は使用しないでください。2 ホストのフリートを読みます。
Symphony または Kanban アダプター	インテグレーションを読みます。
メッセージのスキーマと種類	メッセージ形式を読みます。
複数ラウンドにわたるバックグラウンドレビュー	レビューのループを読みます。
Buzz、ACP、または amq-acp	コンパニオンの amq-acp は AMQ_ACP_TO にキューイングします。プールワーカーは受信箱を処理してはいけません。チャットでは --root、受信者、または argv を渡してはいけません。また、[Context] はルーティングではありません。amq-acpを読みます。
実行中のハーネスセッションへの接続（amq-remote up、submit、share）	amq-remote リファレンスを読みます。
Buzz からこのセッションに接続（/amq-remote）	amq-remote スキルを使用します。

現在のフラグを確認するには、amq <command> --help を使用します。リポジトリの README が正式なセットアップ手順です。

安全性と配信のルール

• ウェイク通知は注意を促すものであり、消費されたことの証明ではありません。配信の証明が必要な場合は、受領確認を使うか、--wait-for drained を指定します。drained の受領確認が証明するのは取り込みであり、依頼された作業が完了したことではありません。
• 返信時は既存のスレッドを維持します。ドアベルの後は再度受信箱を処理してください。最新の完全なメッセージ本文が正となります。
• クリーンアップは amq cleanup で明示的に行います。自動削除を追加してはいけません。
• ウェイクに関する変更を行う前に、amq wake check --me "<handle>" --json を実行します。restart_capability=agent_safe の場合に限り操作してください。それ以外の場合は状態を保持し、必要なオペレーターの操作を報告します。
• ホスト間のペイロードは、設定済みのブリッジが認証して適用するまで、特権付き受信箱の外に保持します。ルーティングの代わりに、別の Maildir をコピーしたりリモートで受信処理したりしてはいけません。
• Windows ネイティブのインジェクションを Unix の wake や coop exec に置き換えてはいけません。Windows が関係する場合は、運用ガイドのプラットフォームのセクションを読みます。
• 危険なプロバイダーのバイパスフラグは、オペレーターが管理する coop exec の直接コマンドでのみ使用します。コミット済みの起動設定には記載しないでください。

コマンドの完全な一覧、環境変数の優先順位、セットアップ手順、プラットフォームに関する注意事項、オペレーターの承認条件、使用例は運用ガイドに記載されています。