Messagesスキル

エンタープライズ向けSkills

Copy page



エンタープライズ規模でAgent Skillsをデプロイするためのガバナンス、セキュリティレビュー、評価、および組織向けガイダンス。

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

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

エンタープライズでSkillsをデプロイするには、2つの異なる問いに答える必要があります。

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

リスク階層の評価

デプロイを承認する前に、各Skillを以下のリスク指標に照らして評価してください。

レビューチェックリスト

サードパーティまたは社内のコントリビューターによるSkillをデプロイする前に、以下の手順を完了してください。

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

Skillコンテンツのスキャン

Claude Enterpriseの組織は、claude.aiおよびClaude CoworkでカスタムSkillsの自動セキュリティスキャンを有効にできます。claude.ai > 組織設定 > SkillsでSkillおよびプラグインのセキュリティスキャンを有効にすると、その後メンバーがclaude.aiまたはCoworkでアップロードまたは編集したSkillsは、隠れたコード実行、外部サービスへのデータ送信、Claudeの安全対策を改ざんする指示など、悪意のある動作の兆候がないかスキャンされます。スキャンに不合格となったSkill、またはスキャンが完了していないSkillは使用がブロックされます。警告付きで合格したSkillは、注意喚起の表示とともに引き続き使用できます。組織でスキャンが利用可能な場合は、有効にしてください。これはレビューチェックリストを補完するものであり、置き換えるものではありません。

スキャンはClaude APIを対象としていません。Claude Consoleからのものを含め、Skills API（/v1/skills）を通じてアップロードしたSkillsはスキャンされないため、APIでのデプロイについてはレビューチェックリストとバージョン固定に依拠してください。また、スキャンを有効にした時点ですでに組織内に存在していたSkillsや、顧客管理の暗号化キー（CMEK）、ゼロデータ保持（ZDR）、HIPAA対応など、特定のデータ処理構成を持つ組織にもスキャンは適用されません。セットアップ手順、除外事項、結果の種類については、ClaudeヘルプセンターのGet started with skill and plugin scanningを参照してください。

デプロイ前のSkillsの評価

Skillsは、誤ってトリガーされたり、他のSkillsと競合したり、質の低い指示を提供したりすると、エージェントのパフォーマンスを低下させる可能性があります。本番デプロイの前には必ず評価を義務付けてください。

評価すべき項目

Skillをデプロイする前に、以下の観点について承認ゲートを設けてください。

評価の要件

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

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

ライフサイクルの判断に評価を活用する

評価結果は、いつ行動すべきかを示すシグナルとなります。

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

Skillのライフサイクル管理

1. 1

   計画

   反復的、エラーが発生しやすい、または専門知識を必要とするワークフローを特定します。これらを組織内の役割にマッピングし、どれがSkillsの候補となるかを判断します。

2. 2

   作成とレビュー

   Skillの作成者がベストプラクティスに従っていることを確認します。レビューチェックリストを使用したセキュリティレビューを義務付けます。承認前に評価スイートを義務付けます。職務の分離を確立してください。Skillの作成者が自身のレビュアーになるべきではありません。

3. 3

   テスト

   単独（Skillのみ）での評価と、既存のSkillsと併用した評価（共存性テスト）を義務付けます。本番向けに承認する前に、トリガー精度、出力品質、およびアクティブなSkillセット全体でリグレッションがないことを確認します。

4. 4

   デプロイ

   ワークスペース全体でアクセスできるよう、Skills APIを通じてアップロードします。アップロードとバージョン管理については、APIでのSkillsの使用を参照してください。目的、オーナー、バージョンとともに、Skillを社内レジストリに記録します。

5. 5

   監視

   使用パターンを追跡し、ユーザーからフィードバックを収集します。ワークフローやモデルの進化に伴うドリフトやリグレッションを検出するため、定期的に評価を再実行します。使用状況の分析は現在Skills APIでは利用できません。どのSkillsがリクエストに含まれているかを追跡するため、アプリケーションレベルのロギングを実装してください。

6. 6

   反復または非推奨化

   新しいバージョンを昇格させる前に、評価スイート全体に合格することを義務付けます。ワークフローが変更された場合や評価スコアが低下した場合は、Skillsを更新します。評価が一貫して失敗する場合やワークフローが廃止された場合は、Skillsを非推奨にします。

大規模なSkillsの整理

再現率の限界

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

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

具体的なものから始め、後で統合する

広範で多目的なSkillsではなく、範囲の狭いワークフロー固有のSkillsから始めるようチームに奨励してください。組織全体でパターンが見えてきたら、関連するSkillsを役割ベースのバンドルに統合します。

進行の例：

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

命名とカタログ化

組織全体で一貫した命名規則を使用してください。ベストプラクティスの命名規則セクションに書式のガイダンスがあります。

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

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

役割ベースのバンドル

各ユーザーのアクティブなSkillセットを絞り込むため、組織内の役割ごとにSkillsをグループ化してください。

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

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

配布とバージョン管理

ソース管理

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

APIベースの配布

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

バージョン管理戦略

• 本番環境： Skillsを特定のバージョンに固定してください。versionを省略すると、リクエストは最新バージョンを使用するため、ワークスペース内の誰かが新しいバージョンをアップロードすると、本番エージェントが実行する内容が即座に変わります。新しいバージョンを昇格させる前に、評価スイート全体を実行してください。すべての更新を、完全なセキュリティレビューを必要とする新規デプロイとして扱ってください。
• 開発とテスト： 本番への昇格前に変更を検証するため、最新バージョンを使用します。
• ロールバック計画： 以前のバージョンをフォールバックとして維持してください。新しいバージョンが本番環境で評価に失敗した場合は、直ちに最後の正常なバージョンに戻してください。
• 完全性の検証： レビュー済みのSkillsのチェックサムを計算し、デプロイ時に検証してください。出所を保証するため、Skillリポジトリでは署名付きコミットを使用してください。

サーフェス間の考慮事項

Skillのソースファイルは、信頼できる唯一の情報源としてGitで管理してください。組織が複数のサーフェスにわたってSkillsをデプロイする場合は、一貫性を保つために独自の同期プロセスを実装してください。詳細については、サーフェス間の利用可能性を参照してください。

次のステップ