エージェントスキルファイル

Preview docs describe unreleased preview builds. Stable docs remain at /docs/.

Nagi は再利用可能なエージェントスキルファイルを SKILL.md として提供しています。

このファイルを、再利用可能なスキルやカスタム指示に対応した任意のコーディングエージェントにインストールしてください。このスキルは、Nagi のペイン内から Nagi を制御する方法をエージェントに教えます。

Nagi は別の用途向けに Nagi agent guide というガイドも提供しています。こちらは、人間が Nagi を学習・セットアップ・トラブルシューティングするのをエージェントが手伝うためのものです。スキルは Nagi を操作するエージェントのため、ガイドは人間に教えるエージェントのためのものです。

スキルがすること

このスキルは、NAGI_ENV=1 が設定されているときに nagi CLI を使うようエージェントに指示します。これは、エージェントが Nagi 管理下のペイン内で動作しており、ローカルの Nagi ソケットと安全に通信できることを意味します。

スキルをインストールすると、エージェントは次のことができます:

• ワークスペース、タブ、ペイン、隣のエージェントを調べる
• フォーカスを奪わずにペインを分割してコマンドを実行する
• ペインの出力と最近のログを読む
• サーバー、テスト、別のエージェントの完了を待つ
• 隣のペインでヘルパーエージェントを起動する

このスキルは独立したアプリやサービスではありません。エージェント向けの markdown 指示ファイルです。

インストールする

npx skills でスキルをインストールします:

npx skills add Cod-Hash-Studios/nagi --skill nagi -g

-g フラグは、対応エージェントにグローバルインストールします。現在のプロジェクトにインストールする場合は -g を省略してください。

手動でのフォールバックおよび信頼できるソースとしては、リポジトリのコピーを使ってください:

https://github.com/Cod-Hash-Studios/nagi/blob/main/SKILL.md

スキルシステムを持つエージェントには、このファイルを nagi という名前のスキルとしてインストールしてください。スキルシステムを持たないエージェントには、ファイルの内容をプロジェクト指示またはユーザー指示に貼り付けてください。

インストール後、Nagi の中でエージェントを起動します:

nagi
claude

他のコーディングエージェントを Nagi のペインで使っても構いません。重要なのは、エージェントのプロセスが Nagi 内で動作していて NAGI_ENV=1 が利用できることです。

安全ルール

このスキルはひとつのガードレールから始まります: NAGI_ENV=1 が設定されていない場合、エージェントは停止して、Nagi 管理下のペイン内で動作していないと伝えるべきです。

これにより、Nagi の外にいるエージェントが自分のものではないセッションを制御しようとするのを防ぎます。

エージェント向けリファレンス

コマンドの完全なガイドはスキルファイル自体にあります。ペイン ID、pane split、pane run、pane read、wait output、wait agent-status、ワークスペースとタブのコマンド、協調動作のレシピを扱っています。

ソースファイルはこちら:

GitHub で SKILL.md を開く →