AI Agent Manager と仕事をする

昔いろいろおもしろ動画でみた気がするが、Coding Agent 同士を通信させるとか、AI Agent を束ねる AI Manager がいて数十人の部下を動かしているとかとか。。。そういうのはやったよね。今それをやっている。

多分技術的には当時と同じだと思う。あんまり新しいことはない。ただ、Claude Code の remote-control と、SKILL、そして Agent そのものの賢さがあがったこともあり格段にやりやすくなったので今やってみたらそこそこワークしている。

環境

自宅の Mac Studio 上ですべてが動いている。

Mac Studio 上で Zellij のセッションが複数立ち上がっていて、それぞれに Claude Code が動いている。AI Manager もその中の 1 セッションで、他のセッションに指示を出す。外出先からはスマホアプリ(remote control)から AI Manager に話しかけるだけでいい。「状況どう？」って聞くと全セッションの進捗をまとめて報告してくれる。便利。

技術的にやっていること

正直、技術的にはそんなに大したことはやっていない。

Zellij: ターミナルマルチプレクサ。tmux でもいいけど Zellij を使っている。各セッションが独立したターミナルで、それぞれ Claude Code が動いている。Zellij のほうがやりたいことがすぐやれるので普通に使う場合も馴染みやすかった。
agents-manager: Go で書いた薄いラッパー CLI。Zellij のセッションに対してキーストロークを送ったり、Claude Code のセッションログ（JSONL）を読んで最新の応答を取得したりする
Claude Code の SKILL: AI Manager の振る舞いを定義するプロンプト群。「定期的にセッション一覧を確認して報告しろ」「タスクが完了したセッションには次の仕事を提案しろ」みたいなルールを書いている
git worktree: 同じリポジトリで複数ブランチの作業を並列に走らせるために使っている

つまり構成要素は全部既存のもので、新しいものは何もない。Claude Code の write-chars アクション（Zellij にキーストロークを送る）でセッション間通信をしているだけ。

agents-manager（Go CLI）

agents-manager はセッション管理の道具箱みたいなもので、以下のコマンドがある。

やることはシンプルで、

list で「今どのセッションが生きてるか」を見る
read で「あのセッション何してる？」を確認する
send で「これやっといて」と指示を送る
spawn で新しいセッションを立ち上げる
kill で終わったセッションを片付ける

これだけ。CLI は意図的に薄く・単純にしている。

仕組み

send の仕組みを例にすると、やっていることは本当にシンプルで：

Zellij の write-chars アクションでテキストを打ち込む（人間がキーボードで打つのと同じ）
Claude Code のセッションログ（~/.claude/projects/ 以下の JSONL ファイル）を poll する
ファイルサイズが増えて、最終ロールが assistant になったら「返事が来た」と判断
応答を出力して終了

書いてみても特に普通の話である。

SKILL との棲み分け

最初悩みながら走り出したのが、CLI と SKILL の役割分担。今の AI は十分に賢いので、ツール（スクリプト。決定的な操作）と指示に分ける感じ。

CLI（agents-manager）がやること: - セッションの一覧取得 - セッションへのキーストローク送信 - セッションログの読み取り - セッションの起動・終了 - Rate limit の確認

SKILL がやること: - 「15分おきに全セッションの状態を確認して報告しろ」 - 「作業が完了したセッションには次のタスクを提案しろ」 - 「破壊的な操作は必ず承認を取れ」 - 「放置されているセッションがあったら原因を聞き出せ」

SKILL というかたまりで AI への指示を再現性高くできるようになって便利になった。

SKILL の例：status

こっちからつっつかなくても勝手に動いてほしい。AI Manager の session 自体にも外部から指示を送ることで、15分ごとにポーリングさせることができる。

新規のタスクを指示するか、状況をみて承認するか、追加の指示をするかって感じ。「承認します。」って言ってる。これが Senior Approve Engineer である（社内で流行った）

おしまい

便利