# カスタマイズの検出先

GitHub Copilotは、バージョン付きのスキル、エージェント、指示、およびファイル フックを、パッケージのインストール、サブモジュール、およびベンダーのディレクトリから直接検出できます。 それらを従来のディレクトリにコピーする必要はありません。

<!-- markdownlint-disable GHD046 GHD005 -->
<!-- Suppressed: GHD046 (outdated release terminology), GHD005 (hardcoded data variable) -->

<!-- Copyright (c) Microsoft Corporation. All rights reserved. -->

## リポジトリ設定

`.github/copilot/settings.json`: チェックアウト相対ディレクトリを宣言

```json
{
  "skillDirectories": ["node_modules/@example/team/skills"],
  "agentDirectories": ["vendor/team/agents"],
  "instructionDirectories": ["vendor/team/instructions"],
  "hookDirectories": ["vendor/team/hooks"]
}
```

各リストは、独自のカスタマイズの種類の検索場所を追加します。 従来のロケーションは引き続き機能します。 
`.github/copilot/settings.local.json`のキーは、そのリポジトリリストのみを置き換えます。空のリストは、そのリポジトリへの追加分を削除します。 省略されたキーは、チェックイン済みのリストを継承します。 リポジトリ リストは、SDK の入力や既存のユーザー スキル ディレクトリに代わることはありません。

リポジトリ パスは、空でない、宣言するチェックアウト内のリテラル ディレクトリ パスである必要があります。 絶対パス、ホームまたは環境変数の拡張、glob、チェックアウト外のエスケープは拒否されます。 リンクとジャンクションは、解決されたルートと検出された子孫ノードがチェックアウト内に残っている場合にのみ許可されます。 不足しているディレクトリが報告され、インストールと明示的なカスタマイズの再読み込み後に検出されることがあります。 Copilot はパッケージをインストールしたり、これらのディレクトリを監視したりすることはありません。

リポジトリ定義の検出場所からのファイル コンテンツは、検証され、開かれたファイル ハンドルを介して読み取られます。 検出から実行までの間に、チェックアウト操作の外部でリンクの再ターゲットを行っても、新しいリンク先の読み取り権限は付与されません。

リポジトリの場所では、宣言されたチェックアウト ルートを対象とする信頼が必要であり、各カスタマイズ種別で既存の検出スイッチ、無効化されたエントリ、および管理ポリシーの適用対象のままです。 サブディレクトリのみの永続化された信頼では、親チェックアウトの設定を許可しません。 ロケーションを登録しても、無効になっているカスタマイズ タイプが有効になることはありません。また、ファイルシステムへのアクセス権が付与されることもありません。

CLI では、モデル カタログの初期化に失敗した場合でも、保存されたフォルダーの信頼により、現在のセッションでリポジトリのカスタマイズが更新されます。 
`/skills reload` また、永続化された信頼とリポジトリの検出設定も再確認します。

## SDK の入力

セッションの作成、再開、オプションの更新では、同じ 4 つのリストを受け入れます。 TypeScript とJavaでは、`skillDirectories`、`agentDirectories`、`instructionDirectories`、および`hookDirectories`を使用します。 PythonとRustはスネークケースを使用します。Goと.NETはパスカルケースを使用します。

SDK ディレクトリはチェックアウトした作業コピーの外部に存在できます。 先頭と末尾の空白はトリミングされ、空白のエントリは無視されます。 相対 SDK パスは、指定されると、要求の有効な作業ディレクトリに対して一度だけ解決されます。 作業ディレクトリを変更しても、保持されている SDK ルートは移動されません。 新しい相対パスの一覧を指定すると、新しい有効な作業ディレクトリが使用されます。 空のリストでは、明示的な SDK コントリビューションのみがクリアされ、省略または `null` の場合、更新中も変更されません。

新しいフック サービスが制御を引き継ぐ前に、`hookDirectories` 置換の採用が失敗した場合、または取り消された場合、以前のディレクトリ オプションとライブ フック サービスはそのまま残ります。 失敗した更新が重複すると、別の失敗した更新プログラムのディレクトリではなく、保持された値が復元されます。 失敗した更新プログラムは、新しく承認された更新プログラムをロールバックしません。

明示的なエージェントおよびファイル フック ディレクトリでは、アンビエント構成の検出は必要ありません。 
`enableFileHooks` は、従来の `.github/hooks`を含むリポジトリ由来のフックを制御しますが、明示的な SDK フック ディレクトリやコールバック `hooks`は制御しません。 管理対象の制限とフックの無効化は引き続き適用されます。

ディレクトリ入力は検出構成であり、一般的なファイルシステムアクセス権ではありません。 彼らは `additionalDirectories`を広くしません。 既存のファイル フック サンドボックス ルールは引き続き有効です。

アクティブなローカル スキルを読み込むと、ランタイムのスキル リソース ポリシーの下に、関連する SDK スキル ディレクトリに対する読み取り専用の許可が追加されます。 空、無視、無効のスキル ソースでは、これらの付与は追加されません。 リポジトリで定義されたスキル ディレクトリは追加しないでください。

## ファイル形式と優先順位

| タイプ | 検出されたコンテンツ |
| --- | --- |
| Skills | 直接 `SKILL.md` バンドルまたは再帰的に検出された最上位バンドル |
| Agents | 既存の Markdown エージェント定義 |
| リポジトリの手順 | 既存のフロントマッターと`*.instructions.md`一致する再帰的な`applyTo`ファイル |
| フック | 既存のフック JSON 構成 |

リポジトリの instruction ディレクトリは、パッケージ `AGENTS.md` 階層や `.claude/rules`をインポートしません。 既存の SDK instruction-directory 形式は引き続きサポートされます。 各サブシステムは、既存のソースの優先順位を保持します。 重複するフック ファイル参照は重複除去されます。個別に定義されたアクションは、コマンドが一致するという理由だけでは折りたたまれません。

ファイルベースのコマンド フックは、`COPILOT_HOOK_DIR`（構成ファイルを含むディレクトリ）を受け取ります。 これを使用して、隣接するスクリプトとリソースを見つけます。 フック作業ディレクトリセマンティクスは変更されません。これらは、使用しているワークスペースに固定されたままです。 
`COPILOT_HOOK_DIR` は実行環境の変数であり、JSON テンプレートの拡張ではありません。 `COPILOT_PLUGIN_ROOT` は、個別のプラグインルート動作を保持します。 インライン フックと SDK コールバックは、捏造された構成ディレクトリを取得しません。