スキルを構築または再利用する

反復可能なタスクとターゲットとする Microsoft の経験がある場合は、この記事を使用して、スキルを構築するか、既存のスキル コンテンツを適応させるかを決定します。 次に、製品の作成手順を選択します。 ビルド または再利用中です。 成果は、依存関係とテスト証拠を含むスキルの実装であり、 パッケージ & テストの前に統合の準備が整っています。

スキルの再利用または拡張

宣言型エージェントの場合、Agent Builder と Agents Toolkit はエージェント間での再利用をサポートしていません。 宣言型エージェントのスキルのサポート マトリックスに従います。あるエージェントにアタッチされたスキルを別のエージェントと共有できると想定しないでください。

スキルを作成する前に:

  1. 必要なジョブを既に実行している承認済みスキルを確認します。
  2. ターゲット エージェントまたは Microsoft エクスペリエンスがスキルの形式と機能をサポートしていることを確認します。
  3. 命令、リソース、スクリプト、ツール、データ アクセスを確認します。
  4. 既存のスキル コンテンツを適応させる前に、ターゲット エクスペリエンスの文書化された再利用制限を確認してください。
  5. 所有権、バージョン管理、共有、サポート、更新の期待を確認します。
  6. 代表的な入力と期待される出力を使用してスキルをテストします。

既存の承認済みスキルが要件を満たしていない場合、またはターゲット エクスペリエンスが再利用をサポートしていない場合は、新しいスキルを作成します。

実装パスを選択する

専門能力開発のための Work IQ Dev Tools から始めましょう。 ターゲット エクスペリエンスとプロジェクト タイプのルートを選択します。共有 SKILL.md 形式では、エージェント間の再利用または公開の適格性は確立されません。

開発アプローチ スキルの成果物とスコープ 次から始める
Work IQ 開発ツール スタンドアロン プラグインの最上位スキル フォルダー、または既存の宣言型エージェント プロジェクトに追加されたスキル。 これらは個別の作成ルートです。 Work IQ Dev Tools と以下のルートの詳細を使用してプラグインをビルド します
Copilot Chat スキルの作成とプラグインの配布 製品固有の作成と配布のガイダンスに従います。 Copilot Chat のスキルを身につける
エージェント ビルダー 宣言型エージェントにアップロードされた完全なスキル ZIP、またはエージェント ビルダーの説明から作成されたスキル。 エージェント ビルダーを使用してスキルを追加する
Microsoft 365 Agents Toolkit スタンドアロンのスキル ZIP ではなく、既存の宣言型エージェント プロジェクトに追加されたスキル ディレクトリ。 エージェント ツールキットを使用してスキルを追加する
Copilot Cowork Microsoft 365 アプリ パッケージに登録されているスキル フォルダー。 Cowork パッケージの要件と制限を使用します。 Copilot Cowork 用のプラグインをビルドする

アーティファクトを発行ルートと一致させる

成果物の公開ガイダンスに従います。

1 つの成果物のサポートでは、すべてのプラグイン パッケージの公開適格性が確立されるわけではありません。 公開では、ユーザー アクセス、同意、または接続のセットアップは完了しません。

GitHub Copilot は、スクリプト、リソース、テスト、リポジトリの変更をサポートするスキルの指示を支援できます。 ターゲット エクスペリエンスと作成ツールによって、サポートされるスキルの形式とランタイムが決まります。

Work IQ 開発ツール

WIQD には、2 つの異なるスキル作成ルートが用意されています。

  • wiqd plugin add skill スタンドアロン プラグイン プロジェクトに最上位レベルのスキルを追加します。 プラグインはスキル専用にすることも、サポートされているエージェントまたはリモート MCP コネクタとスキルを組み合わせることもできます。 対象製品のサポートを個別に確認します。
  • wiqd agent add skill 既存の宣言型エージェント プロジェクトにスキルを追加します。 このルートでは、既定でオフになっている agent-skills 機能フラグが使用されます。

どちらのルートでも SKILL.mdベースの機能が作成されますが、異なるプロジェクト タイプで動作します。 WIQD プラグイン形式では、スキル名はフォルダー名と一致する必要があり、その説明にはそれをアクティブにする語句が含まれている必要があります。 プラグインとは ? および プラグイン作成リファレンスを参照してください。

WIQD ソース検証 (wiqd plugin validate --mode source) では、スキル コンテンツは検査されません。 パッケージ化した後、実際の ZIP パスで wiqd plugin validate --mode package --package-file "<path-to-existing-zip>" を実行します。 パッケージ検証では、その ZIP のキャプチャされたコピーが Microsoft 365 検証サービスにアップロードされ、認証が必要になる場合があります。 返された結果を確認します。パスではランタイム動作は確立されません。 「検証と MVL」を参照してください。

スキルを実装する

該当する作業を完了します。

  1. ジョブ、インプット、期待されるアウトプット、境界、サクセス基準を定義します。
  2. スキルの指示を作成またはインポートします。
  3. 必要なサポート リソースとスクリプトを追加します。
  4. 必要なツール、リモート MCP サーバー、API、ID、アクセス許可、またはデータ依存関係を構成します。
  5. サポートされているファイルの種類、スクリプトの種類、サンドボックスの動作、ストレージ、秘密度の要件を確認します。
  6. 予期されるシナリオ、あいまいなシナリオ、サポートされていないシナリオ、障害のシナリオをテストします。
  7. スキル バージョン、所有者、依存関係、既知の制限事項、サポート プロセスを記録します。

Copilot Chat で直接使用されるスキルについては、「Copilot Chat のスキルを構築する」を参照してください。 宣言型エージェントの現在のサポートとランタイムの制約については、 宣言型エージェントのスキルを参照してください。 Copilot Cowork については、「コンパニオン ファイルの制限」を参照してください。 スキルを複数のエクスペリエンスに配布する場合は、すべてのターゲット ホストの要件を適用します。

スキルが機能していることを確認する

スキルは、次の場合に統合の準備が整います。

  • ターゲット エージェントまたはエクスペリエンスは、それを読み込んで使用できます。
  • その命令は、定義されたジョブを一貫して実行します。
  • 必要なリソース、スクリプト、ツール、およびデータを利用できます。
  • アクセス許可と外部依存関係は、開発環境またはテスト環境で機能します。
  • サポートされていない操作や失敗した操作では、理解可能な動作が生成されます。
  • 所有権、バージョン管理、制限事項、およびテスト証拠が記録されます。

プラン内の他のコンポーネントを続行します。 コンポーネントが完成したら、 コンポーネントを統合してテストし、 パッケージ & テスト に移動して プラグイン パッケージを作成します。