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

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

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

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

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

リスク階層評価

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

レビューチェックリスト

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

1. スキルディレクトリのすべてのコンテンツを読む。 SKILL.md、参照されているすべてのmarkdownファイル、およびバンドルされているスクリプトやリソースを確認してください。
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にスキルソースファイルを唯一の信頼できる情報源として維持してください。組織が複数のサーフェスにスキルを展開する場合は、それらを一貫して保つための独自の同期プロセスを実装してください。詳細については、クロスサーフェスの可用性を参照してください。

次のステップ