Skip to main content

エージェントスキルについて

エージェント スキルは、Copilot コーディング エージェント、GitHub Copilot CLI(コマンドラインインターフェース) および Visual Studio Code Insider が特殊なタスクを実行する能力を強化します。

この機能を使用できるユーザーについて

Copilot コーディング エージェント は、GitHub Copilot Pro、GitHub Copilot Pro+、GitHub Copilot Business、GitHub Copilot Enterprise プランで使用できます。 エージェントは、マネージド ユーザー アカウント によって所有されて明示的に無効になっているリポジトリを除き、GitHub に格納されているすべてのリポジトリで使用できます。

GitHub Copilot CLI(コマンドラインインターフェース) は、GitHub Copilot Pro、GitHub Copilot Pro+、GitHub Copilot Business、GitHub Copilot Enterprise プランで使用できます。 Copilot を organization から受け取る場合は、organization の設定で Copilot CLI ポリシーを有効にする必要があります。
Sign up for Copilot

エージェントスキルについて

エージェント スキルは、Copilot が関連する場合に読み込むことができる命令、スクリプト、およびリソースのフォルダーであり、特殊なタスクのパフォーマンスを向上させます。 エージェント スキルは、さまざまなエージェントで使用される オープン標準です。

エージェント スキルは、Copilot コーディング エージェント 、GitHub Copilot CLI(コマンドラインインターフェース)、および Visual Studio Code Insider のエージェント モードで動作します。 安定版 VS Code のサポートは近日公開予定です。

Copilot に特定かつ反復可能な方法でタスクを実行させるために、独自のスキルを作成することができます。また、オンラインで共有されているスキルを使用することも可能です。例えば、anthropics/skills リポジトリや、GitHub のコミュニティが作成した github/awesome-copilot コレクションにあります。

現時点では、スキルはリポジトリ レベルでのみ作成できます。 組織レベルとエンタープライズ レベルのスキルのサポートは近日公開予定です。

スキルとカスタム命令の両方を使用して、 Copilot をリポジトリで作業する方法と特定のタスクを実行する方法を教えることができます。 ほぼすべてのタスクに関連する簡単な手順 (リポジトリのコーディング標準に関する情報など) と、関連する場合に Copilot がアクセスする必要があるより詳細な手順のスキルには、カスタム命令を使用することをお勧めします。 リポジトリのカスタム手順の詳細については、 GitHub Copilot のリポジトリ カスタム命令を追加する を参照してください。

メモ

GitHub Copilot CLI(コマンドラインインターフェース) は データ保護を使用したパブリック プレビュー にあり、変更される可能性があります。

リポジトリへのスキルの追加

  1. スキルを格納する .github/skills ディレクトリを作成します。

    メモ

           `.claude/skills` ディレクトリに格納されているスキルもサポートされています。
    
  2. 新しいスキルのサブディレクトリを作成します。 各スキルには、独自のディレクトリ (たとえば、 .github/skills/webapp-testing) が必要です。 スキル ディレクトリ名は小文字で、スペースにはハイフンを使用し、通常は name frontmatter 内のSKILL.mdと一致する必要があります。

  3. スキルの指示に従って SKILL.md ファイルを作成します。

    メモ

    スキル ファイルには、 SKILL.mdという名前を付ける必要があります。

           `SKILL.md` ファイルは、YAML frontmatter を含む Markdown ファイルです。 最も単純な形式では、次のものが含まれます。
    
    • YAML フロントマター * name (必須): スキルのユニークな識別子。 スペースにはハイフンを使用して、小文字にする必要があります。 * description (必須): スキルが実行する内容の説明と、Copilot で使用する必要があるタイミング。 * license (省略可能): このスキルに適用されるライセンスの説明。
    • Copilot の指示、例、ガイドラインが記載された Markdown 本文。
  4. 必要に応じて、スキルのディレクトリにスクリプト、例、またはその他のリソースを追加します。 たとえば、異なる形式間で画像を変換するスキルを記述している場合は、SVG 画像を PNG に変換するためのスクリプトを含めることができます。

          `SKILL.md` ファイルの例

このファイルは、 .github/skills/github-actions-failure-debugging ディレクトリにあります。

Markdown
---
name: github-actions-failure-debugging
description: Guide for debugging failing GitHub Actions workflows. Use this when asked to debug failing GitHub Actions workflows.
---

To debug failing GitHub Actions workflows in a pull request, follow this process, using tools provided from the GitHub MCP Server:

1. Use the `list_workflow_runs` tool to look up recent workflow runs for the pull request and their status
2. Use the `summarize_job_log_failures` tool to get an AI summary of the logs for failed jobs, to understand what went wrong without filling your context windows with thousands of lines of logs
3. If you still need more information, use the `get_job_logs` or `get_workflow_run_logs` tool to get the full, detailed failure logs
4. Try to reproduce the failure yourself in your own environment.
5. Fix the failing build. If you were able to reproduce the failure yourself, make sure it is fixed before committing your changes.

Copilot がスキルを使用する方法

タスクを実行する場合、Copilot は、プロンプトとスキルの説明に基づいて、スキルを使用するタイミングを決定します。

Copilot がスキルの使用を選択すると、 SKILL.md ファイルがエージェントのコンテキストに挿入され、エージェントが指示にアクセスできるようになります。 その後、これらの手順に従って、スキルのディレクトリに含めてきたスクリプトや例を使用できます。