GitHub Copilot のエージェント スキルの作成

特定のタスクを実行する際に、Copilotの動作と機能を変更できます。

この記事で

メモ

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

エージェント スキルは、Copilot が関連する場合に読み込むことができる指示、スクリプト、およびリソースのフォルダーであり、特殊なタスクのパフォーマンスを向上させます。 詳しくは、「エージェントのスキルについて」をご覧ください。

スキルの作成と追加

エージェント スキルを作成するには、 SKILL.md ファイルと、必要に応じて、補助 Markdown ファイルやスクリプトなど、 SKILL.md の手順で参照するその他のリソースを記述します。

スキルを追加するには、SKILL.md ファイルとすべての付随リソースを、Copilot がスキルを検索できる場所に保存します。 これは、リポジトリ内でも、ホーム ディレクトリ内でもかまいません。

  1.        `skills`ディレクトリを作成して、スキルや将来作成する可能性のあるその他のディレクトリを格納します。

    1 つのリポジトリに固有の プロジェクト スキルの場合は、スキルを .github/skills または .claude/skillsに格納します。

           **個人のスキル**の場合は、プロジェクト間で共有し、スキルを`~/.copilot/skills`または`~/.claude/skills`の下に保存します。

  2. 新しいスキルのサブディレクトリを作成します。 各スキルには、独自のディレクトリ (たとえば、 .github/skills/webapp-testing) が必要です。

    スキルサブディレクトリ名は小文字で、スペースにはハイフンを使用する必要があります。

  3. スキルサブディレクトリで、スキルの指示を含む SKILL.md ファイルを作成します。

    重要

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

           `SKILL.md` ファイルは、YAML frontmatter を含む Markdown ファイルです。 最も単純な形式では、次のものが含まれます。
    • YAMLフロントマター * name (必須): スキルのユニークな識別子。 スペースにはハイフンを使用して、小文字にする必要があります。 通常、これはスキルのディレクトリの名前と一致します。 
      •           **説明** (必須): スキルが実行する内容の説明と、Copilot で使用すべきタイミング。

      •    **license** (省略可能): このスキルに適用されるライセンスの説明。
    • 従うべき Copilot の指示、例、ガイドラインが記載された Markdown 本文。

  4. 必要に応じて、スキルのディレクトリにスクリプト、例、またはその他のリソースを追加します。

    たとえば、異なる形式間で画像を変換するスキルを記述している場合は、SVG 画像を PNG に変換するためのスクリプトを含めることができます。 スキルの指示では、Copilot にこれらのリソースを使用するタイミングと方法を指定する必要があります。

          `SKILL.md` ファイルの例

          **プロジェクト スキル**の場合、このファイルはリポジトリの`.github/skills/github-actions-failure-debugging` ディレクトリにあります。

          **個人のスキル**の場合、このファイルは `~/.copilot/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 ファイルがエージェントのコンテキストに挿入され、エージェントが指示にアクセスできるようになります。 その後、これらの手順に従って、スキルのディレクトリに含めてきたスクリプトや例を使用できます。## スキルとカスタム命令

スキルとカスタム命令の両方を使用して、 Copilot をリポジトリで作業する方法と特定のタスクを実行する方法を教えることができます。

ほぼすべてのタスクに関連する簡単な手順 (リポジトリのコーディング標準に関する情報など) と、Copilot が関連する場合にのみアクセスする必要があるより詳細な手順のスキルには 、カスタム命令を使用することをお勧めします。

リポジトリのカスタム手順の詳細については、 GitHub Copilot用のリポジトリカスタム命令の追加 を参照してください。