skill-router

Skill Router

タスクで必要な場合に限り、ローカルのスキルインデックスを使って関連するスキルを選択し、読み込みます。

ディスパッチ

$ARGUMENTS	アクション	例
search <query>	関連度順に一致するスキルを一覧表示します	/skill-router search "fix Playwright test"
context <query>	上位の一致候補について、簡潔なコンテキストパケットを作成します	/skill-router context "write a release changelog"
read <skill>	正確な名前またはパスを指定してスキルを読み込みます	/skill-router read skill-creator
doctor	表示されているスキルルートと件数を診断します	/skill-router doctor
自然言語のタスク	自動で検索し、最適な候補のコンテキストを作成します	"which skill should handle docs generation?"
空	簡単な使い方を表示して、doctor を実行します	/skill-router

ワークフロー

1. 分類

1. 適用するスキルを判断するときは、search を使います。
2. 次の手順で選択したスキルの本文が必要なときは、context を使います。
3. スキル名またはパスがすでにわかっている場合に限り、read を使います。
4. スキルが見つからない、重複している、または起動時のコンテキスト警告で省略されている場合は、doctor を使います。

2. 取得

2. このスキルディレクトリまたはリポジトリのルートから、該当する CLI コマンドを実行します。

python scripts/skill_index.py search "$ARGUMENTS" --limit 5
python scripts/skill_index.py context "$ARGUMENTS" --limit 3
python scripts/skill_index.py read <skill-name>
python scripts/skill_index.py doctor

3. 選択

1. スコアが近い場合は、ランクが最も高いリポジトリまたは Codex ユーザーのスキルを優先します。
2. タスクに必要な最小限のスキル本文だけを読み込みます。通常は 1～3 件です。
3. 検索結果に警告がある場合は、実行可能なフックやスクリプトを実行する前に警告内容を確認します。

対象ソース

python scripts/skill_index.py は、次のルートを検索します。

ソース	ルート	信頼階層
repo	skills/	repo
project	現在のプロジェクトパスにある .agents/skills/	codex-user
codex	~/.codex/skills/	codex-user
global	~/.agents/skills/ および対応するエージェントストア	external-installed
plugin	~/.codex/plugins/cache/**/skills/	openai-plugin または plugin

必要に応じて、--source repo、--source codex、--source global、または --source plugin を使って検索範囲を絞り込みます。

正式な用語

用語	意味
skill index	既知のルートにある、表示可能な SKILL.md ファイルの解析済みメタデータ
skill context packet	検索後に読み込まれる、選択したスキル本文の小さなセット
source	repo、codex、global、plugin などのファイルシステム上の場所
trust tier	取得したスキルの順位付けと警告に使う安全性ラベル
warning	使用前の確認が必要な、パーサー、フック、スクリプト、またはメタデータに関するシグナル

分類ゲート

1. ユーザーからタスクが提示されたら、まず search を実行します。
2. ユーザーが選択したスキルの適用を依頼したら、上位の候補に対して context を実行します。
3. ユーザーがスキル名を正確に指定したら、read を実行します。
4. ユーザーがスキルの欠落または省略を報告したら、検索する前に doctor を実行します。
5. ユーザーがスキルのインストール、作成、または監査を依頼した場合は、対象範囲外として別の方法に案内します（以下の「対象外」を参照）。

選択ルール

1. 正確なスキル名または別名は、すべての語句による一致より優先されます。
2. 名前とタイトルの一致は、説明の一致より優先されます。
3. 説明の一致は、見出しと本文の一致より優先されます。
4. 関連度が同程度の場合は、ユーザーがインストールしたスキルよりリポジトリのスキルを優先します。
5. 不明、形式不正、フックを含む、またはスクリプトを含むスキルを使用する際は、注意が必要です。

重要なルール

1. コンテキスト予算に関する警告が表示された後は、起動時に表示されたスキルを完全な一覧として扱わないでください。
2. インストール済みのスキルをすべてコンテキストに貼り付けず、まず検索して、必要なものだけを少量読み込んでください。
3. 取得したという理由だけで、出所不明のサードパーティ製スキルのスクリプトを実行しないでください。
4. このスキルを使ってスキルをインストールまたは削除しないでください。skill-install-dry-run-planner など、利用可能なインストール計画ワークフローに引き継ぎ、メンテナーの明示的な承認を得てから、対象ハーネスがサポートするインストーラーを使用してください。ハーネス間の調整に Codex の .system/skill-installer を代用しないでください。
5. ここでスキルを作成または監査しないでください。スキルの定義作業には skill-creator を使用してください。
6. 「X に合うスキルを探して」といった個別の依頼では、ここでの search または npx skills find を優先してください。ハーネスを体系的に拡張する場合は、リポジトリスキルとしての旧式の find-skills ではなく、harness-master の discover を使用してください。
7. 明確な理由がない限り、ユーザーのタスクを検索クエリとしてそのまま保持してください。

対象外

依頼	代わりに使用
ハーネス間でのスキルのインストール／削除／同期	利用可能なインストール計画ワークフロー。存在する場合は skill-install-dry-run-planner と cross-agent-install-smoke を使用してください
スキルの作成または検証	skill-creator
ハーネス設定の監査またはエコシステムの不足の発見	harness-master
厳選された外部カタログのレコード	ホストリポジトリの、外部コンテンツの作成および信頼性確認ワークフローに従ってください

出力仕様

検索結果とコンテキスト結果には、次の項目が含まれます。

• name
• path
• source
• trust_tier
• description
• score
• matched_fields
• reason
• warnings

別のスクリプトまたはエージェントが結果を使用する場合は、--format json を使用してください。

参照ファイル一覧

ファイル	内容	読み込むタイミング
references/routing-guide.md	ランキング、信頼性、警告の解釈に関する詳細	検索結果が曖昧、同点、または警告が多い場合

検証仕様

変更の完了を宣言する前に、このスキルのディレクトリから次を実行してください。

python scripts/check.py
uv run pytest tests/test_skill_index.py -q

追加の検証に関する注意事項は、references/routing-guide.md を参照してください。

完了条件：

1. scripts/check.py が終了コード 0 で終了する。
2. このスキルのディレクトリにリポジトリ CLI への参照が残っていない。
3. 検索 CLI とコンテキスト CLI のテストが合格する。