mcpField
S
setup-delegation-policy

setup-delegation-policy

github.com/dyritsエージェントワークフロー040 回インストール1 日前に更新
リポジトリ

setup-delegation-policy について

エージェント環境のグローバルな指示ファイルに、委任とモデルルーティングのルールを導入するスキルです。環境の検出から設定、検証、削除までを案内します。

主な機能

  1. 01導入済み環境の検出
  2. 02共有ルールの追加・更新
  3. 03モデル階層とエージェントの紐付け
  4. 04ルール部分の検証・削除

活用シーン

  1. 01複数のエージェント環境で委任を設定
  2. 02モデル変更後の階層紐付けを再同期
  3. 03環境から導入済みルールを削除

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/dyrits/skills --skill setup-delegation-policy

インストール後、Claude Code で/setup-delegation-policyを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

apm.yml
agents/
openai.yaml
assets/
policy.md
references/
tier-agents.md
scripts/
detect-harnesses.py

詳細

委任ポリシーのセットアップ

委任は、作業単位の最初に行うと効果を発揮します。推論によって判断が傾く前に実行できるためです。スキルではその状態を保てません。エージェントがスキルを使うきっかけを得たときにしか起動されず、その時点ではすでに推論が始まっているからです。一方、常時読み込まれるステアリングファイルに記載した恒常的なルールは、すべてのターンで引き継がれます。そのため、このルールは呼び出すのではなく、インストールします。

policy.md がそのルールです。モデル名はあくまで例としてのみ記載し、階層に分けているため、どのハーネスでも利用できます。ファイル全体を、## Delegation and model routing 見出しからそのままコピーします。

特定のハーネスは前提にしません。ハーネスごとに、そのドキュメントやツールを参照してステアリングファイル、委任の仕組み、利用可能なモデルを確認してください。場所やスキーマはリリースごとに変わるためです。

手順

1. ハーネスと実行する操作を選択する

python3 -I scripts/detect-harnesses.py を実行します(構造化された出力を得るには --json を追加します)。事前にハーネス名を指定せずに、ディスク上で見つかった候補を一覧表示します。各行にはディレクトリ、PATH 上のコマンド、ステアリングファイル、委任セクションがすでに含まれているかどうか(policy=)、存在する階層エージェントが示されます。インストール済みのスキルしかないディレクトリは、skills-only の1行として表示されます。実行中のハーネスが一覧にない場合は追加し、一覧をユーザーに見せて、内容の確認と見落とされたハーネスの追加を依頼します。

各ハーネスの状態をスクリプトの結果に基づいて報告し、推奨する操作を尋ねます。

  • 設定:何もインストールされていない場合。
  • 再設定:すでに何かがインストールされており、ルールを再同期して階層を再割り当てする場合。
  • 削除:このスキルがインストールしたものを削除する場合。
  • スキップ。

完了条件:確認済みのすべてのハーネスに操作が割り当てられていること。

2. 各ハーネスを設定または再設定する
  1. ステアリングファイル。 ハーネスのグローバルステアリングファイル、つまり各ターンで読み込まれる常時適用の指示を探します。存在する空のファイルも対象として扱います。## Delegation and model routing 見出しのセクションがない場合は、空行の後にペイロードを追記します。セクションがある場合は、その見出しから次の ## 見出し、またはファイル末尾までを置き換えます。これにより、再同期の際に同じセクションが重複しません。ハーネスにグローバルステアリングファイルがない場合は、作成するかどうかを尋ねます。
  2. 階層の割り当て。 ハーネスの委任ツールを確認します。呼び出しごとにモデルを上書きできる場合は、階層別のファイルは不要です。ルールに従い、エージェントが呼び出し時に階層のモデルを指定します。モデルを名前付きエージェントに割り当てるハーネスでは、各階層に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 が唯一の信頼できる情報源です。ルールを変更するには、インストール済みのコピーを修正するのではなく、そのファイルを編集してこのスキルを再実行してください。
  • リポジトリスコープのステアリングファイルには手を加えません。これはエージェントの動作に関するルールであり、特定のコードベースに関するものではありません。

コメント