skill-governance

スキルのガバナンス

ユーザーが実際に利用するスキルの範囲を管理します。意図したホットエントリーまたはルーターエントリーは、新しいホストで完全に表示され、コールド機能には引き続きアクセスでき、編集可能な動作には正規の所有者が一つだけ存在し、廃止したものはすべて復元可能である必要があります。ディレクトリ数を減らすことが目的ではありません。

必須の成果条件

作業を始める前に、次の内容を一文で述べます。

• モデルから見える必要があるエントリーまたはルーター
• コールド状態でも利用可能にしておく機能
• ユーザーが変更を許可したレイヤー
• 成功を証明する、新しいホストでのエビデンス

依頼が「数はいくつか／何が読み込まれているか／なぜか」だけの場合は、読み取り専用で対応します。

システムモデル

次のレイヤーを一つにまとめてはいけません。

1. 正規ソース — 所有する動作を編集できる場所です。
2. インストール済みインベントリー — ディスク上に存在するバンドルとバージョンです。
3. 検出ポリシー — Claude または Codex が検出できる対象です。
4. モデル可視カタログ — 新しいモデルプロンプトに含まれるメタデータです。
5. ランタイムリソース — ルーターが引き続き必要とする、非表示のスクリプト、リファレンス、アセットです。

インストール済みであってもアクティブとは限りません。アクティブであっても可視とは限りません。可視であっても使用可能とは限りません。件数やバイト数は診断値にすぎません。

権限の優先順位

記憶上の慣例ではなく、現在のランタイムの実態を基準にします。

• 編集可能なスキルの動作には、所有するソースリポジトリとそのマニフェストを使用します。
• 現在の Claude マーケットプレイス／インストール状態には、claude plugin ... --json を使用します。
• 管理対象の Daymade リンクには、明示的なソース同期アクティベーションマニフェストを使用します。
• Codex の現在のユーザースキルルートには、~/.agents/skills を使用します。
• Codex の検出無効化には、パスを明示した ~/.codex/config.toml ポリシーを使用します。
• 実際の新しい Codex カタログには、codex debug prompt-input を使用します。
• サードパーティのコールドリソースには、インストール済みのベンダーバンドルを使用します。

~/.codex/skills は、現在のローカル契約で別の役割が明示的に割り当てられていない限り、レガシー／システム互換用です。所有権を完全に見せかけるためだけに、サードパーティのインベントリーを所有ソースのアクティベーションマニフェストに移してはいけません。

依頼の振り分け

ワークフローを使用する前に、 references/skill-surface-governance.md の該当する節をすべて読んでください。

依頼	読んで使用する節
明示的な成果条件。ソースの所有者、登録、インストール済みルートを確認する	§16、続いて§14の指定された新規ホストでのゲート
Codex が実際に読み込む内容、件数、切り捨て、重複する識別情報、ルーターの欠落	§3–4、続いて§11
所有ソースリンクまたは ~/.agents/skills のアクティベーションを調整する	§2–5、続いて§11
gstack/Lark/IMA/UiPath または別のバンドルを、ルーターの背後でコールド状態に保つ	§2–4、§6、続いて§11
Claude マーケットプレイス／プラグインのソースまたはインストール状態の不整合	§2–3、§7、続いて§11
古いキャッシュバージョン	§2および§7「例外的な手動キャッシュ修復」
スイートに置き換えられたスタンドアロンプラグイン	§7–8、続いて§11
プロジェクトの .claude/skills と .agents/skills の不整合	§9、続いて§11
単独または重複したスキルディレクトリの廃止	§2–3、§10–11
モデル可視の状態にするスキルと、ユーザー呼び出し専用にするスキルを決める	§15、続いて§11

高速な読み取り専用 Codex 監査

ローカルでの使用が納品の一部となる新規登録 Skill については、準備完了と判断する前に references/skill-surface-governance.md §14 のターゲット名チェックを実行してください。 これには、Claude の最新コマンドカタログと Codex の最新プロンプトが含まれます。 名前は、アクティブなホワイトリストだけでなく、依頼された納品内容に基づいている必要があります。

この Skill バンドルから実行します。

python3 scripts/audit_codex_skill_surface.py --json

ユーザーまたはアクティベーション SSOT が実際に宣言したポリシーのみを追加してください。

python3 scripts/audit_codex_skill_surface.py \
  --require-visible gstack-router \
  --json

このスクリプトは、codex debug prompt-input と、Codex 独自の app-server skills/list によって解析された完全なメタデータ、および厳密なアクティベーション／検出ポリシーを比較します。 終了コード 0 は問題なし、1 は分類が必要な圧力または差異、2 は証拠が無効であることを示します。読み取り専用です。終了コード 1 を自動削除に結び付けないでください。

プロジェクトにルートが 2 つある場合：

python3 scripts/audit_project_skill_roots.py <project-root> --json

この監査では、フロントマターの name に基づいて直下のバンドルを対応付け、明示的に定められたフェイルビジブルな互換性ルーターの契約のみを認識し、共有ターゲット、同一コピー、実際の差異、無効な状態を区別します。

妥協できない安全上の境界

• 差異チェックは読み取り専用です。設定の編集、リンクの同期、インストール、アンインストール、移動、キャッシュの修復、マーケットプレイスソースの変更には、承認が必要です。
• Claude プラグインのスコープを維持してください。古い識別情報を廃止する前に、置き換えを検証してください。
• インストールやソース同期に、キャッシュを直接コピーする方法を決して使わないでください。
• 「キャッシュバージョンを 1 つにする」ことを強制しないでください。実行中のセッションに対する孤立バージョンの猶予期間は、現在の Claude Code が管理します。キャッシュを手動で削除できるのは、例外的な修復時のみです。
• マーケットプレイスを無条件に削除してから再追加しないでください。スコープ内で最後に残ったマーケットプレイスを削除すると、そのプラグインがアンインストールされる可能性があります。
• 冗長と判断する前に、候補ごとの固有の指示、スクリプト、参照資料、アセットをすべて確認してください。古い、または短いからといって、価値がないとは限りません。
• モデルから参照可能か、ユーザーのみが呼び出せるかは、説明やインストール場所だけで判断せず、使用状況の証拠（§15）に基づいて Skill ごとに判断してください。
• 使用頻度の低いサードパーティーのリソースもインストールしたままにしてください。非表示にするのは、該当する検出パスのみとし、代表的な機能を 1 つ使ってルーターが引き続き解決できることを確認してください。
• 廃止時は、復元可能な場所への移動と、ファイル／実行可能ファイル／ハッシュのマニフェストを使ってください。rm -rf は決して使わないでください。
• 既存のセッションには起動時のメタデータが保持されています。対話型カタログを検証と見なす前に、再起動してください。

ソースとアクティベーションの管理

Daymade のソースに基づく Codex アクティベーションでは、現在の claude-switch-models-setup の dry-run/apply ワークフローを利用してください。その明示的な codex-active-skills.json が管理するのは、宣言されたソースマーケットプレイスから作成されたリンクのみです。ここで競合、シンボリックリンク、削除のロジックを再実装しないでください。

Claude プラグインについては、現在のマーケットプレイスおよびインストール JSON を確認し、元のスコープで公式 CLI を使って更新または再インストールしてから、結果を別途読み戻して確認してください。キャッシュフォルダーは、派生したランタイムアーティファクトとして扱ってください。

スイートのトポロジーを変更する場合は、marketplace-dev を使ってソースマニフェストを編集してください。この Skill は、現在のホスト上で、すでに適用済みの移行を調整する場合にのみ使用してください。

読み取り専用の納品契約監査

納品レビューを明示的に行う場合は、§16 を読み、scripts/audit_skill_delivery.py <skill-path> --delivery-contract <private-contract.json> --json を実行してください。ソースの管理は skill-creator に委ねられます。ランタイムでの可視性と元の要件への忠実性は、別個の証拠として扱われます。Skill を実行できる場合でも、ソースにエラーがあれば納品は差し止められます。

完了の定義

該当する主張はすべて、個別に証明する必要があります。

• 正式なソースと現在の所有者を明記します。
• 選択した直接エントリ／ルーターが、指定された検出ポリシーのもと、新しいプロンプトに表示されることを確認します。インストールのみを対象とするゲートを通過した場合も含め、説明文の切り詰めは別途報告します。
• コールド状態にするエントリが、そのカタログに表示されないことを確認します。
• 代表的なコールド機能が引き続き解決され、動作することを確認します。
• ソースに基づくリンクまたは Claude のインストールを読み戻し、意図した ID、ソース／バージョン、スコープになっていることを確認します。
• 廃止されたバンドルとその復旧マニフェストが引き続き存在することを確認します。
• 所有者、ホストのバージョンによる挙動、意図的に残した例外について未解決の点があれば、明示します。

実際のタスク実行が納品物に含まれる場合に限り、参照先のタスク動作チェックを使用します。カタログに表示されるだけでは、その結果が証明されたことにはなりません。

そこで止めてください。依頼された結果にまだ証拠が不足している場合を除き、新しいフック、マニフェスト、レポート層、クリーンアッププロジェクトを作成しないでください。