TrueFoundry Skills Registry の解説：エージェント間における手順知識のバージョン管理

スキルは指示、リファレンス、スクリプト、アセットを再利用可能な手順へとパッケージ化します。レジストリによって、それらのバンドルは発見可能となりバージョン管理されますが、自動的に信頼できるものになるわけではありません。

スキルとは手順のパッケージであり、新しい権限ではありません

エージェントスキルは、反復的なタスクの実行方法を記述したものです。ルートにある SKILL.md には、名前、アクション指向の説明、手順が含まれます。より充実したバンドルには、リファレンス資料、スクリプト、アセットを含めることができます。この構造により、手順知識がモノリシックなシステムプロンプトから分離され、スキルが関連する場合にのみランタイムが詳細をロードできるようになります。

知識と権限の区別は重要です。スキルは、ウェアハウスへのクエリ方法、インシデントのファースト対応、リリースノートの作成方法などをエージェントに指示できます。ただし、スキル自体がデータベースアクセスを付与したり、インシデント対応を承認したり、生成されたリリースノートを正しいものにしたりするわけではありません。ツール、資格情報、ゲートウェイポリシー、およびダウンストリームシステムが引き続き権限の伝播ルートとなります。

TrueFoundry の Skills Registry は、パッケージに共通のアイデンティティを提供します。スキルは Repositories 内に存在し、リポジトリアクセス権とバージョン履歴を継承し、番号付きの完全修飾名（FQN）によってアドレス指定されます。チームは一度パブリッシュすれば、そのバンドルを TrueFoundry Agents、Claude Code、または Cursor で再利用できます。

プログレッシブディスクロージャーは、選択メタデータのみを提示することで初期コンテキストを削減します。ただし、選択された手順自体が安全になるわけではないため、バンドル全体は管理対象のアーティファクトとして残ります。

プログレッシブディスクロージャーはランタイム設計そのものです

TrueForge のドキュメントによると、アタッチされたスキルは初期モデルコンテキストに対してその名前と説明のみを提供します。エージェントがそのスキルを関連性があると判断した場合、SKILL.md の本文全体がサンドボックスからオンデマンドで読み込まれます。これにより、手順を利用可能な状態に保ちながら初期コンテキストを削減できます。

したがって、説明はルーティングの役割を果たします。説明があいまいな場合、エージェントはスキルを選択できなかったり、誤ったタスクに対して選択してしまったりする可能性があります。説明はアクション指向にし、スキルを使用すべきタイミングを明記し、選択があいまいになるような重複した説明を避けてください。選択挙動は、類似した要求を含めた現実的なユーザー要求を用いて評価する必要があります。

プログレッシブロードはコンテキストサイズを制御しますが、信頼できないコンテンツを分離するわけではありません。選択されると、スキルの本文とサポートファイルがエージェントに影響を与えます。スクリプトは設定されたサンドボックス内で実行でき、リファレンスはツール使用に影響を与える可能性があります。複数ファイルで構成されるスキルは、サプライチェーンを持つソフトウェアアーティファクトとして扱ってください。

3つのパブリッシュルート、1つのバージョン管理されたアーティファクト

TrueFoundry のドキュメントには3つのパブリッシュルートが記載されています。UI は、エディタで作成された SKILL.md のコンテンツを本文とする単一ファイルスキルを作成します。複数ファイルバンドルは、CLI のアップロードコマンド、または GitOps を介して適用される宣言型マニフェストを使用します。すべてのルートは Repository の下にバージョン管理された Skill を作成し、リポジトリ修飾されたバージョン1のスキルといった FQN を生成します。

UI は現在、単一の SKILL.md ファイルのみをサポートしています。リファレンス、スクリプト、アセットには CLI または GitOps ルートが必要です。UI での複数ファイルサポートはロードマップとして記載されています。CLI はフロントマターを検証し、バンドルをアップロードします。GitOps はローカルのスキルディレクトリをマニフェストで指し示し、他の TrueFoundry リソースで使用されるのと同じ apply ワークフローを通じてパブリッシュします。

パブリッシュルートは運用上異なりますが、同じリポジトリおよびバージョンアイデンティティに収束します。そのアイデンティティにより、エージェントやローカルの開発環境は非公式なコピーではなく具体的なバンドルを使用できるようになります。

リポジトリアクセスは継承されます

ドキュメント化されているモデルでは、スキルに個別のスキルごとの権限はありません。検出、編集、および使用の権利は、親となる Repository から継承されます。そのため、実質的なガバナンスの単位はリポジトリの境界となります。すべての手順を広範なアクセス権を持つ1つのカタログに配置するのではなく、互換性のある所有権と機密性に基づいてスキルをグループ化してください。

リポジトリアクセス権は、誰がバンドルを取得または使用できるかを制御します。スキルが推奨するすべてのアクションを制限するわけではありません。データベーススキルを使用できるユーザーであっても、データベースツールおよびビジネスリソースのレイヤーでの承認が引き続き必要です。逆に、スキルのアクセス権を取り消しても、基盤となるツールへのアクセス権が必ずしも取り消されるわけではありません。

バージョンの固定は再現性の基礎です

Skills CLI のドキュメントでは、ダウンロード時に正の整数バージョンが必須とされており、latest エイリアスはサポートされていないと述べられています。これは有用な運用上の特性であり、利用者は具体的なバンドルを指定することになります。比較可能な動作が必要な場合は、エージェント設定やローカル開発環境でも同じ具体的なバージョンを固定してください。

バージョンには依然としてプロベナンス（由来・トレーサビリティ）が必要です。ソースリポジトリのコミット、パブリッシャー、ビルドまたはパッケージングプロセス、ファイルダイジェスト、依存関係、レビュー結果を記録してください。スクリプトについては、外部パッケージを固定し、実行環境を記録します。番号付きの FQN はレジストリが何を保存したかを特定し、プロベナンスはそのバンドルがどのように作成されたかを説明します。

スクリプトとリファレンスがもたらす異なるリスク

リファレンスファイルは、古くなっていたり、不完全であったり、悪意をもって改ざんされていたりする可能性があります。スクリプトは、データの読み取りと変換、ローカルコマンドの呼び出し、利用可能なインターフェースを介したサービスの呼び出しを行うことができます。アセットには、アクティブまたは不適切な形式のコンテンツが含まれている可能性があります。ディレクトリを区別のない Markdown として扱うのではなく、適切な管理制御を用いて各クラスを評価してください。

静的チェックにより、フロントマター、パス移動（パストラバーサル）、アーカイブ構造、ファイルサイズ、禁止されたバイナリ、依存関係の宣言、既知の危険なパターンを検証できます。サンドボックス化されたテストにより、合成入力と拒否されたネットワークアクセスを用いてスクリプトを実行できます。タスク評価により、エージェントがスキルを選択し、その制約に従っているかを測定できます。人間によるレビューは、特権的な手順や不可逆的なアクションに集中させる必要があります。

承認パイプラインは、保存、検査、タスクパフォーマンス、ランタイム認可を分離します。単一のチェックでスキルのすべてのプロパティを検証できるわけではありません。

プロモーションは消費者を意識して行うべきです

同じスキルを TrueFoundry Agent、Claude Code、Cursor で使用できますが、これらの環境が同じモデル、ツール、サンドボックス化、またはユーザーアイデンティティを共有しているとは限りません。フォーマットの移植性は、ランタイム動作の同等性を意味しません。サポートされている各環境でスキルをテストし、結果に環境を記録してください。

読み取り専用の MCP ツールと組み合わせた場合には安全なスキルであっても、ローカルの開発環境で書き込みアクセスやシェルコマンドが公開されている場合は危険になる可能性があります。リリース用メタデータには、想定されるツール依存関係、必要な権限、互換性のあるランタイムバージョン、および禁止されている環境を指定する必要があります。

規律あるスキルライフサイクル

明確なタスクと、選択結果をテスト可能にする説明から始めてください。前提条件、許可されたツール、証拠要件、エラーハンドリング、終了ルールを明示して手順を作成します。候補バージョンをパブリッシュします。静的テスト、サンドボックステスト、行動テストを実行します。指定された利用者のために承認します。選択、ツール使用、失敗、結果を観察します。利用者とアクセス権を削除してバージョンを退役させ、ポリシーで要求される証拠を保持します。

非公式なファイル配布によって、広く使用されているスキルをその場で直接変更しないでください。新しいバージョンをパブリッシュし、完全なバンドルの差分を確認し、計画的に利用者の移行を行ってください。スクリプトやリファレンスで脆弱性が見つかった場合は、バージョンインベントリを通じて、それを使用しているすべてのエージェントと開発環境を特定してください。

番号付きバージョンはアイデンティティであり、互換性の保証ではありません

バージョン番号は、利用者にどのバンドルを受け取ったかを伝えます。それ自体が、アップデートの後方互換性を伝えるわけではありません。ツールの名称、ファイルパス、出力スキーマ、または必要な権限の変更は、手順の読み心地が似ていてもエージェントを破損させる可能性があります。

バンドルとともに互換性メタデータ（想定されるランタイム、必要なツール、サポートされる入力および出力のコントラクト、依存関係のバージョン、データ分類、既知の移行手順）をパブリッシュしてください。破壊的変更については、利用者が計画的に移行できるよう、前のバージョンを十分な期間利用可能にしておきます。ランタイム時に変動する「latest」バンドルをダウンロードするようにエージェントに教えることは避け、リリース時に承認された番号を決定してください。

インベントリはインシデント対応に不可欠です

リファレンスに誤りが発覚したり、スクリプトの依存関係が侵害されたりした場合、対応者は「どのバージョンに問題が含まれているか」「それらのバージョンはどこで使用されているか」という2つの質問に迅速に答える必要があります。レジストリのアイデンティティは最初の情報を提供しますが、消費者のインベントリには TrueFoundry Agents と、レジストリから同期されたローカルの Claude Code または Cursor のインストール環境を含める必要があります。

ローカルコピーは、リポジトリアクセス権の変更後も存続する可能性があります。使用権限を取り消すと将来の取得は防止されますが、すでに開発者マシンにダウンロードされたバンドルが削除されるわけではありません。インシデント計画では、レジストリの封じ込め、ランタイムからの切り離し、ローカルでの修正、ツール資格情報の取り消し、およびダウンストリームの調整を区別する必要があります。リスクのある権限と影響を受けるコピーの両方が処理されて初めて、退役が完了します。

成果の評価は手順に従うべきです

スキルの評価には、単なる選択テスト以上のものが必要です。エージェントが前提条件に従い、意図したツールを使用し、行数やコストの制限を遵守し、欠損データを処理し、正しいリファレンスを引用し、未承認の影響が発生する前に停止することを確認してください。その上で、信頼できるタスク成果をチェックします。構文的に正しいツールの実行軌跡であっても、不適切なビジネス結果をもたらすことがあります。

評価およびランタイムトレースごとにスキルの FQN を保存してください。これにより、チームはバージョンを比較し、デグレ（性能劣化）を検出し、失敗の原因がスキル、モデル、ツール、データ、または周辺のポリシーのどれにあるかを判断できます。バージョンのリンクがなければ、共有された手順を大規模に管理することは不可能になります。

維持すべき失敗テスト

• スキルを選択すべきプロンプトと選択すべきでないプロンプトを使用し、誤選択と選択漏れを測定する。
• 予期しないパス、シンボリックリンク、サイズオーバーのファイル、未宣言の依存関係を含む複数ファイルバンドルをパブリッシュする。
• サポートスクリプトまたはリファレンスのみを変更し、バンドルの差分とバージョンの変更によってそれが露出することを確認する。
• サポートされている環境全体で同じバージョンを実行し、ツールの適用範囲と動作を比較する。
• リポジトリの使用アクセス権を取り消し、利用者が新しいコピーを取得できないことを確認する。
• ツールのアクセス権は維持したままエージェントからスキルを削除し、その違いが理解されていることを確認する。
• 脆弱性のあるバージョンを退役させ、修正の完了を宣言する前に、すべての固定された利用者のインベントリを確認する。

Skills Registry と TrueForge の関係

Skills Registry は、バージョン管理された手順バンドルの配布およびガバナンス環境です。TrueForge は、アタッチされたスキルのメタデータを公開し、要求に応じて完全な手順をロードし、そのサンドボックスとツールを介してサポート作業を実行するランタイムです。AI Gateway と MCP Gateway は、そのランタイム周辺のモデルおよびツールのトラフィックを管理します。

これらのレイヤーのいずれも、単体で手順を保証するものではありません。価値のあるプラットフォーム設計は構成的です。つまり、レジストリアイデンティティとリポジトリアクセス権、ランタイムコンテキスト管理、ツール認可、および証拠が、同一の固定されたスキルバージョンの周りに整列できることです。

運用上のルール

スキルをコードに準ずるリリースアーティファクトとして扱ってください。説明を正確に保ち、番号付きバージョンを固定し、完全なバンドルをレビューし、選択と実行をテストし、実効的な所有権の境界に合わせてリポジトリのスコープを設定してください。

TrueFoundry のレジストリにより、手順知識はエージェントや開発環境全体で再利用可能になります。TrueForge は、その知識をランタイムで経済的にロードできるようにします。バージョン管理が承認、最小権限、サンドボックス化、および成果の証拠と結びついて初めて、システムは信頼できるものになります。

参考文献

1. TrueFoundry — AI Gateway Skills Registry.
2. TrueFoundry — Create, Manage, and Use Skills.
3. TrueForge — Skills.
4. TrueForge — Harness Capabilities.

編集上の開示。 本記事は、2026年9月19日時点の引用された公開資料に対する TrueFoundry のエンジニアリング上の解釈を反映しています。製品の機能はリンクされたドキュメントの範囲に限られます。例および運用のデフォルト設定は例示であり、法的アドバイス、監査意見、独立したベンチマーク、あるいはセキュリティ、安全性、コンプライアンスを保証するものではありません。

‍