エンタープライズ向けスキル

このガイドは、組織全体でAgent Skillsを管理する必要があるエンタープライズ管理者およびアーキテクト向けです。スキルを大規模に審査、評価、展開、管理する方法について説明します。作成に関するガイダンスについては、ベストプラクティスを参照してください。アーキテクチャの詳細については、スキルの概要を参照してください。



セキュリティレビューと審査

エンタープライズでスキルを展開するには、2つの異なる問いに答える必要があります。

1. スキルは一般的に安全か？ プラットフォームレベルのセキュリティの詳細については、概要のセキュリティに関する考慮事項セクションを参照してください。
2. 特定のスキルをどのように審査するか？ 以下のリスク評価とレビューチェックリストを使用してください。



リスクティア評価

展開を承認する前に、各スキルを以下のリスク指標に照らして評価してください。



レビューチェックリスト

サードパーティまたは社内コントリビューターからのスキルを展開する前に、以下の手順を完了してください。

1. スキルディレクトリのすべてのコンテンツを読む。 SKILL.md、参照されているすべてのマークダウンファイル、およびバンドルされているスクリプトやリソースを確認します。
2. スクリプトの動作が記載された目的と一致していることを確認する。 サンドボックス環境でスクリプトを実行し、出力がスキルの説明と一致していることを確認します。
3. 敵対的な指示がないか確認する。 Claudeに安全ルールを無視する、ユーザーからアクションを隠す、レスポンスを通じてデータを流出させる、または特定の入力に基づいて動作を変更するよう指示するディレクティブを探します。
4. 外部URLの取得やネットワーク呼び出しがないか確認する。 スクリプトと指示内でネットワークアクセスパターン（http、requests.get、urllib、curl、fetch）を検索します。
5. ハードコードされた認証情報がないことを確認する。 スキルファイル内のAPIキー、トークン、またはパスワードを確認します。認証情報は環境変数または安全な認証情報ストアを使用すべきであり、スキルコンテンツに含めてはいけません。
6. スキルがClaudeに呼び出すよう指示するツールとコマンドを特定する。 すべてのbashコマンド、ファイル操作、およびツール参照をリストアップします。スキルがファイル読み取りツールとネットワークツールの両方を併用する場合の複合リスクを考慮してください。
7. リダイレクト先を確認する。 スキルが外部URLを参照している場合、それらが想定されるドメインを指していることを確認します。



展開前のスキル評価

スキルが誤ってトリガーされたり、他のスキルと競合したり、不適切な指示を提供したりすると、エージェントのパフォーマンスが低下する可能性があります。本番展開の前に必ず評価を実施してください。



評価すべき内容

スキルを展開する前に、以下の観点について承認ゲートを設けてください。



評価要件

スキル作成者に、スキルごとに3〜5個の代表的なクエリを含む評価スイートの提出を求めてください。これには、スキルがトリガーされるべきケース、トリガーされるべきでないケース、および曖昧なエッジケースを含めます。スキルの有効性はモデルによって異なるため、組織で使用しているモデル（Haiku、Sonnet、Opus）全体でのテストを求めてください。

評価の構築に関する詳細なガイダンスについては、ベストプラクティスの評価と反復を参照してください。一般的な評価方法論については、テストケースの開発を参照してください。



ライフサイクル判断への評価の活用

評価結果は、いつ対応すべきかを示します。

• トリガー精度の低下： スキルの説明または指示を更新する
• 共存性の競合： 重複するスキルを統合するか、説明を絞り込む
• 一貫して低い出力品質： 指示を書き直すか、検証ステップを追加する
• 更新を重ねても継続する失敗： スキルを廃止する



スキルのライフサイクル管理



大規模なスキルの整理



リコール制限

一般的なガイドラインとして、信頼性の高いリコール精度を維持するために、同時にロードするスキルの数を制限してください。各スキルのメタデータ（名前と説明）は、システムプロンプト内で注意を奪い合います。アクティブなスキルが多すぎると、Claudeが適切なスキルを選択できなかったり、関連するスキルを完全に見逃したりする可能性があります。スキルを追加する際は評価スイートを使用してリコール精度を測定し、パフォーマンスが低下したら追加を停止してください。

APIリクエストは、リクエストごとに最大8個のスキルをサポートしていることに注意してください（APIでのスキルの使用を参照）。ある役割が単一のリクエストでサポートされる数より多くのスキルを必要とする場合は、狭いスキルをより広いスキルに統合するか、タスクタイプに基づいてリクエストを異なるスキルセットにルーティングすることを検討してください。



具体的に始めて、後で統合する

チームには、広範で多目的なスキルではなく、狭くワークフローに特化したスキルから始めることを推奨してください。組織全体でパターンが明らかになったら、関連するスキルを役割ベースのバンドルに統合します。

進行例：

• 開始：formatting-sales-reports、querying-pipeline-data、updating-crm-records
• 統合：sales-operations（評価で同等のパフォーマンスが確認された場合）



命名とカタログ化

組織全体で一貫した命名規則を使用してください。ベストプラクティスの命名規則セクションでフォーマットのガイダンスを提供しています。

各スキルについて、以下を含む内部レジストリを維持してください。

• 目的：スキルがサポートするワークフロー
• 所有者：メンテナンスを担当するチームまたは個人
• バージョン：現在展開されているバージョン
• 依存関係：必要なMCPサーバー、パッケージ、または外部サービス
• 評価ステータス：最終評価日と結果



役割ベースのバンドル

各ユーザーのアクティブなスキルセットを集中させるために、組織の役割ごとにスキルをグループ化します。

• 営業チーム：CRM操作、パイプラインレポート、提案書生成
• エンジニアリング：コードレビュー、デプロイワークフロー、インシデント対応
• 財務：レポート生成、データ検証、監査準備

各役割ベースのバンドルには、その役割の日常的なワークフローに関連するスキルのみを含めるべきです。



配布とバージョン管理



ソース管理

履歴追跡、プルリクエストによるコードレビュー、およびロールバック機能のために、スキルディレクトリをGitに保存します。各スキルディレクトリ（SKILL.mdとバンドルされたファイルを含む）は、Gitで追跡されるフォルダに自然にマッピングされます。



APIベースの配布

Skills APIは、ワークスペースをスコープとした配布を提供します。API経由でアップロードされたスキルは、すべてのワークスペースメンバーが利用できます。アップロード、バージョニング、および管理エンドポイントについては、APIでのスキルの使用を参照してください。



バージョニング戦略

• 本番環境：スキルを特定のバージョンに固定します。新しいバージョンを昇格する前に、完全な評価スイートを実行します。すべての更新を、完全なセキュリティレビューを必要とする新しい展開として扱います。
• 開発およびテスト：本番昇格前に変更を検証するために、最新バージョンを使用します。
• ロールバック計画：フォールバックとして前のバージョンを維持します。新しいバージョンが本番環境で評価に失敗した場合は、直ちに最後の正常なバージョンに戻します。
• 整合性検証：レビュー済みスキルのチェックサムを計算し、展開時に検証します。スキルリポジトリで署名付きコミットを使用して、出所を保証します。



サーフェス間の考慮事項

スキルのソースファイルを唯一の信頼できる情報源としてGitで維持してください。組織が複数のサーフェスにスキルを展開する場合は、それらの一貫性を保つために独自の同期プロセスを実装してください。詳細については、サーフェス間の可用性を参照してください。



次のステップ