エージェントスキルファイル
Herdr は再利用可能なエージェントスキルファイルを skills/herdr/SKILL.md として提供しています。
このファイルを、再利用可能なスキルやカスタム指示に対応した任意のコーディングエージェントにインストールしてください。このスキルは、Herdr のペイン内から Herdr を制御する方法をエージェントに教えます。
Herdr は別の用途向けに herdr.dev/agent-guide.md というガイドも提供しています。こちらは、人間が Herdr を学習・セットアップ・トラブルシューティングするのをエージェントが手伝うためのものです。スキルは Herdr を操作するエージェントのため、ガイドは人間に教えるエージェントのためのものです。
スキルがすること
Section titled “スキルがすること”このスキルは、HERDR_ENV=1 が設定されているときに herdr CLI を使うようエージェントに指示します。これは、エージェントが Herdr 管理下のペイン内で動作しており、ローカルの Herdr ソケットと安全に通信できることを意味します。
スキルをインストールすると、エージェントは次のことができます:
- ワークスペース、タブ、ペイン、隣のエージェントを調べる
- フォーカスを奪わずにペインを分割してコマンドを実行する
- ペインの出力と最近のログを読む
- サーバー、テスト、別のエージェントの完了を待つ
- 隣のペインでヘルパーエージェントを起動する
このスキルは独立したアプリやサービスではありません。エージェント向けの markdown 指示ファイルです。Herdr がすでにインストールされている場合は、herdr --skill を実行すると、そのバイナリのリリースと一致する同梱コピーを表示できます。
インストールする
Section titled “インストールする”npx skills でスキルをインストールします:
npx skills add herdrdev/herdr --skill herdr -gスキルがリポジトリのルートにあったときにインストールした場合は、skills update ではなく、この add コマンドを一度再実行してください。大きすぎる既存のコピーが置き換えられ、新しい場所が記録されます。
-g フラグは、対応エージェントにグローバルインストールします。現在のプロジェクトにインストールする場合は -g を省略してください。
手動でのフォールバックおよび信頼できるソースとしては、リポジトリのコピーを使ってください:
https://github.com/herdrdev/herdr/blob/v0.8.0/skills/herdr/SKILL.mdスキルシステムを持つエージェントには、このファイルを herdr という名前のスキルとしてインストールしてください。スキルシステムを持たないエージェントには、ファイルの内容をプロジェクト指示またはユーザー指示に貼り付けてください。
インストール後、Herdr の中でエージェントを起動します:
herdrclaude他のコーディングエージェントを Herdr のペインで使っても構いません。重要なのは、エージェントのプロセスが Herdr 内で動作していて HERDR_ENV=1 が利用できることです。
このスキルはひとつのガードレールから始まります: HERDR_ENV=1 が設定されていない場合、エージェントは停止して、Herdr 管理下のペイン内で動作していないと伝えるべきです。
これにより、Herdr の外にいるエージェントが自分のものではないセッションを制御しようとするのを防ぎます。
エージェント向けリファレンス
Section titled “エージェント向けリファレンス”コマンドの完全なガイドはスキルファイル自体にあります。ペイン ID、pane split、pane run、pane read、pane wait-output、agent wait、ワークスペースとタブのコマンド、協調動作のレシピを扱っています。
ソースファイルはこちら: