AIエージェントの協調作業を可能に：会話セッションを妨げない外部CLIによる開発ワークフローの構築
本記事は、AIエージェント（Claude Code、Codex、Cursorなど）が生成したコンテンツのレビューや修正作業を、既存の会話セッションを中断することなく外部から実行するためのCLI（コマンドラインインターフェース）ツール「Artifact Share」の仕組みを解説しています。このツールは、AIエージェントが生成したHTMLやMarkdownファイルをローカルでプレビューし、人間がブラウザ上で指摘を行うと、その指摘をエージェントが受け取り、修正を自動で行うという、高度な開発ワークフローを実現しています。
**【仕組みとプロセス】**
ユーザーは`npx @artifactshare/cli preview ./report.html`といったコマンドでローカルサーバーを起動し、ブラウザ上でファイルをプレビューします。人間側はブラウザ上で指摘を書き、エージェント側は「指摘を取りに行く（next）」→「編集・保存」→「結果を報告する（done）」という一連のバッチ処理を繰り返します。この際、指摘は本文やアンカー情報を含まず、「指摘が届いた」という合図のみが送信される点が重要です。
**【最大の課題と解決策】**
最も難しかった点は、「指摘が届くのを待つ間」に、AIエージェントの会話セッションをブロックしないことです。理想は、通常の会話を続けながら、指摘が届いた瞬間にエージェントが自律的に動き出す仕組みですが、エージェントごとに利用できる技術が異なるため、以下の3つの異なるアプローチを採用しています。
1. **Claude Code:** バックグラウンドタスクの完了を利用し、待機コマンドをバックグラウンドで実行することで、指摘到着時に自動で次のターンが開始される仕組みを利用。
2. **Codex:** 実行中のセッションに直接メッセージのキューを投入する仕組みを利用し、指摘を待機状態に積むことで、セッションが終了しても後から再開して受け取れるように工夫。
3. **Cursor:** ACP（Agent Client Protocol）という共通プロトコルを利用し、専用の常駐セッションを確保。外部から「バッチが届いた」という固定プロンプトを送り込むことで、エージェントを起動。
筆者は、これらの技術的な制約から、共通の「エージェント起動トリガー」の標準化は難しいと結論づけており、今後のAIエージェント連携の課題として提示しています。
背景
近年、AIエージェントの活用が進む中で、エージェントが生成した成果物（コードやドキュメント）を人間がレビューし、フィードバックを回す「人間とAIの協調作業」の効率化が求められています。しかし、既存のAIチャットインターフェースは、外部からのトリガーや非同期のフィードバックを受け付ける仕組みが未整備であり、ワークフローのボトルネックとなっていました。
重要用語解説
- CLI: Command Line Interfaceの略。コマンドライン上で実行されるインターフェースであり、本記事では、AIエージェントのワークフローを制御するためのローカルサーバー機能を持つツールを指します。
- AIエージェント: 特定のタスクを自律的に計画・実行し、目標達成を目指すAIシステム。本記事では、Claude Code、Codex、Cursorといった具体的なAIモデルを指します。
- ACP: Agent Client Protocolの略。エディタとAIエージェントを接続するための共通プロトコル。これにより、外部からエージェントの専用セッションに対してプロンプトを送信することが可能になります。
今後の影響
本技術は、AIエージェントによる開発サイクルを劇的に加速させる可能性を秘めています。指摘→修正→再レビューという反復的なプロセスを自動化することで、開発者の手動介入を最小限に抑え、AIを単なる「回答生成器」から「自律的な共同作業者」へと進化させる道筋を示しています。今後は、このトリガー機構の標準化が業界の鍵となります。