エージェントに YOU を使わせる方法

同梱の you-agent-factory エージェント向けオリエンテーショントピックを AI エージェントに読ませ、you CLI を自分で使わせます。MCP と ACP はより踏み込んだ統合手段です。

これは何か

インストールされたバイナリは自分自身のリファレンス文書を同梱しており、そのうち 1 つのトピックは AI エージェント専用に書かれています。you-agent-factory とは何か、どのコマンドが存在するか、どれを使うべきかを説明するオリエンテーションとコマンド一覧です。装飾のないプレーンなマークダウンとして出力され、これはまさにエージェントが読みたい形です。

you docs agents

エージェントに渡す前に、一度自分で実行してみてください。エージェントが何を学ぶことになるかが正確に分かりますし、既存のどの手段より速くコマンド全体を把握できます。

使いどころ

コマンドを実行できるエージェントと、再利用する価値のあるファクトリーがそろった時点で使ってください。毎セッションでレビューループをゼロから作り直すエージェントと、すでにインストール済みのパッケージ済みレビューファクトリーに手を伸ばすエージェントの違いになります。

手順

起動するサーバーも、登録する統合もありません。設定はすべて、エージェントがすでにプロジェクトの指示を読み込んでいる場所に、指示を 1 つ書き足すだけです。

ステップ 1 — バイナリがそこにあることを確かめる

エージェントが動作するマシンで you-agent-factory をインストールし、プロバイダーを設定します。PATH にないバイナリはエージェントには使えませんし、プロバイダーのないファクトリーは何も実行しません。

ステップ 2 — エージェントのプロジェクト指示に 1 行加える

Before using you-agent-factory, run `you docs agents` and read the output.
It is the agent orientation topic and command matrix for the installed binary.
Then use the `you` CLI directly for anything it covers — prefer `you run --named`
against an installed packaged factory over reimplementing a workflow yourself.
Run `you docs` for the full topic index, and `you docs <topic>` for depth.

その指示を、エージェントが自動的に読み込むファイル、つまり AGENTS.md、CLAUDE.md、Cursor のルールファイルなど、あなたのハーネスが読む場所に置きます。要点は、エージェントがコマンドの全体像を、古くなりうるドキュメントの写しではなく、実際に手元にあるバイナリから学ぶことです。

ステップ 3 — 残りのトピックは自分で見つけさせる

you docs

21 のトピックが利用でき、ファクトリーの作成、実行、設定、モックワーカー、記録と再生、ガード、関係、作業、セッション、オーケストレーター、JavaScript ワークフロー、MCP、ワークステーション、ワーカー、リソース、モデル、バッチ入力、テンプレートを網羅しています。ある主題を深く知りたいエージェントは、その部分だけを取得できます。

ステップ 4 — 実際に 1 回動かして確認する

you factory list --dir ~/.you-agent-factory/factories
you run --named @you/subagent --output primary "Summarise the working tree"

小さなことを最後までやらせて、ループが機能することを確認します。インストール済みのものを一覧させ、それからパッケージ済みファクトリーを 1 つ実行して結果を報告させます。最終結果だけを出力させると、エージェントのコンテキストがきれいに保てます。

エージェントが届く範囲

CLI だけでも、エージェントはファクトリーのインストールと一覧表示、依頼に対する実行、稼働中セッションへの作業投入、作業項目とセッションの調査、発見されたモデルの一覧と詳細確認、そして同梱リファレンストピックの閲覧ができます。運用者が手作業で行うことのほぼすべてが含まれます。

より踏み込んだ統合

シェルではなく構造化されたツールを求めるホスト向けに、2 つのプロトコルサーバーがあります。Model Context Protocol サーバーは Factory Session のツールを stdio 上に提示し、MCP ホストが名前付きツールとして呼び出せるようにします。Agent Client Protocol サーバーは、you-agent-factory 自体をエディターから操作できるエージェントとしてホストします。

Model Context Protocol で Factory Session のツールを提供する

you mcp serve

you-agent-factory を Agent Client Protocol エージェントとしてホストする

you serve acp

この 3 つの面は混同しやすいので注意してください。Agent Client Protocol エージェントとしてホストするのは、外部のエディターに対して you-agent-factory を提供することです。Agent Client Protocol プロバイダーを追加するのは、you-agent-factory 自身が作業をディスパッチする外部エージェントを設定することです。Model Context Protocol での提供はまったく別のツールサーバーであり、HTTP やダッシュボードのリスナーは一切起動しません。

よくある落とし穴

最も多い失敗は、エージェントがオリエンテーショントピックを一度も読まず、フラグを推測してしまうことです。指示は、エージェントが実際に見る場所、つまり毎セッション読み込むプロジェクト指示ファイルに置いてください。単発のメッセージではいけません。2 つ目は、プロトコルサーバーが必須だと思い込むことです。ほとんどのエージェントにとって、CLI のほうが単純で、できることも多いのです。自律エージェントは CLI 経由で作業を投入します。ダッシュボードの投入フォームと HTTP の work エンドポイントは運用者向けの経路のままであり、エージェント用の並行制御チャネルではありません。

セキュリティ / 信頼境界