setup-delegation-policy について
エージェント環境のグローバルな指示ファイルに、委任とモデルルーティングのルールを導入するスキルです。環境の検出から設定、検証、削除までを案内します。
主な機能
- 01導入済み環境の検出
- 02共有ルールの追加・更新
- 03モデル階層とエージェントの紐付け
- 04ルール部分の検証・削除
活用シーン
- 01複数のエージェント環境で委任を設定
- 02モデル変更後の階層紐付けを再同期
- 03環境から導入済みルールを削除
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ dyrits/ skills --skill setup-delegation-policyインストール後、Claude Code で/setup-delegation-policyを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
apm.ymlagents/openai.yamlassets/policy.mdreferences/tier-agents.mdscripts/detect-harnesses.py詳細
委任ポリシーのセットアップ
委任は、作業単位の最初に行うと効果を発揮します。推論によって判断が傾く前に実行できるためです。スキルではその状態を保てません。エージェントがスキルを使うきっかけを得たときにしか起動されず、その時点ではすでに推論が始まっているからです。一方、常時読み込まれるステアリングファイルに記載した恒常的なルールは、すべてのターンで引き継がれます。そのため、このルールは呼び出すのではなく、インストールします。
policy.md がそのルールです。モデル名はあくまで例としてのみ記載し、階層に分けているため、どのハーネスでも利用できます。ファイル全体を、## Delegation and model routing 見出しからそのままコピーします。
特定のハーネスは前提にしません。ハーネスごとに、そのドキュメントやツールを参照してステアリングファイル、委任の仕組み、利用可能なモデルを確認してください。場所やスキーマはリリースごとに変わるためです。
手順
1. ハーネスと実行する操作を選択する
python3 -I scripts/detect-harnesses.py を実行します(構造化された出力を得るには --json を追加します)。事前にハーネス名を指定せずに、ディスク上で見つかった候補を一覧表示します。各行にはディレクトリ、PATH 上のコマンド、ステアリングファイル、委任セクションがすでに含まれているかどうか(policy=)、存在する階層エージェントが示されます。インストール済みのスキルしかないディレクトリは、skills-only の1行として表示されます。実行中のハーネスが一覧にない場合は追加し、一覧をユーザーに見せて、内容の確認と見落とされたハーネスの追加を依頼します。
各ハーネスの状態をスクリプトの結果に基づいて報告し、推奨する操作を尋ねます。
- 設定:何もインストールされていない場合。
- 再設定:すでに何かがインストールされており、ルールを再同期して階層を再割り当てする場合。
- 削除:このスキルがインストールしたものを削除する場合。
- スキップ。
完了条件:確認済みのすべてのハーネスに操作が割り当てられていること。
2. 各ハーネスを設定または再設定する
- ステアリングファイル。 ハーネスのグローバルステアリングファイル、つまり各ターンで読み込まれる常時適用の指示を探します。存在する空のファイルも対象として扱います。
## Delegation and model routing見出しのセクションがない場合は、空行の後にペイロードを追記します。セクションがある場合は、その見出しから次の##見出し、またはファイル末尾までを置き換えます。これにより、再同期の際に同じセクションが重複しません。ハーネスにグローバルステアリングファイルがない場合は、作成するかどうかを尋ねます。 - 階層の割り当て。 ハーネスの委任ツールを確認します。呼び出しごとにモデルを上書きできる場合は、階層別のファイルは不要です。ルールに従い、エージェントが呼び出し時に階層のモデルを指定します。モデルを名前付きエージェントに割り当てるハーネスでは、各階層に1つずつエージェントが必要です。階層名のエージェントがない階層には、ルールから到達できないためです。tier-agents.md に従って、ハーネスで実際に利用できるモデルをユーザーに提示し、ファイルを作成します。委任ツールがないハーネスでは、ルールの作業分割に関する部分のみが適用され、モデルのルーティングは行われません。
完了条件:各ハーネスに assets/policy.md と完全に一致するセクションが1つだけあり、割り当て可能な各階層にエージェントまたは呼び出しごとのモデル上書きがあること。
3. 各ハーネスから削除する
ステアリングファイルから ## Delegation and model routing セクションを削除します。削除範囲は見出しから次の ## 見出し、またはファイル末尾までとし、それ以外は変更しません。次に、階層エージェントのファイルについて、ファイル名を示したうえで削除するかどうかを別途尋ねます。ルールを削除すればエージェントは機能しなくなりますが、利用をやめるのではなく再同期するユーザーは、それらを残したい場合があります。
4. 検証する
- 書き込み先の各ステアリングファイルに
## Delegation and model routing見出しが1つだけあること(grep -cで確認)。操作が「削除」の場合は、見出しが残っていないこと。 - インストールしたセクションが
assets/policy.mdと完全に一致すること。各ファイルからセクションを抽出し、ソースと差分を比較します。セクションが存在するだけでは、古いコピーの可能性があります。 - 各ファイルが引き続き文書として正しく読めること。セクションがコードフェンス内や文の途中ではなく、セクションとして配置されていること。
- 階層エージェントを作成した場合、tier-agents.md の確認項目を満たしていること。
5. レポート
ハーネスごとに、書き込まれた内容、再同期された内容、削除された内容、スキップされた内容、およびポリシーでは把握できない内容を報告します。具体的には、各ティアのバインド方法(呼び出しごとのオーバーライドか、名前付きエージェントか)、各ティアが解決したモデルと公開時点の価格、assets/policy.md のモデルバージョンルールに基づいて確認した、選択された各モデルファミリーのバージョン、ハーネスが対応できないティアとその代わりとなる上限、そして組み込みエージェントに対するハーネス独自のバインド設定です。組み込みエージェントのバインド設定も、ハーネス内のその他すべての設定も、ユーザーのものです。報告するだけにとどめ、変更は加えません。
注意事項
- ステアリングファイルはターンごとに読み込まれるため、再起動は不要です。
assets/policy.mdが唯一の信頼できる情報源です。ルールを変更するには、インストール済みのコピーを修正するのではなく、そのファイルを編集してこのスキルを再実行してください。- リポジトリスコープのステアリングファイルには手を加えません。これはエージェントの動作に関するルールであり、特定のコードベースに関するものではありません。