開発者はその作業時間の多くをターミナルで費やしており、コマンドの生成、問題のデバッグ、システムに近い場所でのスクリプト実行などを日常的に行っています。ターミナル作業を繰り返していると、同じコマンドの再実行、コンテキストの再説明、ログをチームが活用できる形式への変換といった細かなステップが積み重なっていきます。GitHub Copilot CLIのカスタムエージェントは、こうした繰り返しタスクを再利用可能なワークフローへと変換することで、これらの課題に対応するものです。
「カスタムエージェントとは、Markdownファイルで定義できるCopilotエージェントです。汎用的な動作に頼るのではなく、エージェントがどのように動作すべきか、どのツールを使用できるか、どのような標準に従うべきか、どのような出力を生成すべきかを記述します。その結果、どこで実行しても動作が一貫したものになります」と、GitHubのコンテンツライターであるJacklyn Carroll氏は説明しています。
エージェントプロファイルの仕組み
カスタムエージェントはエージェントプロファイルを基盤としており、これはリポジトリ内に直接配置されるファイルです。YAMLフロントマターを含むMarkdownで記述され、各プロファイルにはエージェントの役割と専門領域、アクセス可能なツール、出力の一貫性を保つためのガードレールが定義されています。プロファイルファイルには.agent.mdという拡張子（例：accessibility.agent.md）が付き、対象リポジトリの.github/agentsディレクトリに配置されます。
プロファイルがリポジトリ内に存在するため、チームはそれをレビューし、バージョン管理し、共有することができます。同じ基準がCLIからIDEへ、さらにGitHub上のプルリクエストへと、作業全体を通じて適用されます。
CLIでのエージェントセットアップ
GitHub Copilot CLIはスクリプトの実行、APIの呼び出し、リポジトリとの直接的な連携が可能であり、エージェント主導の作業に適しています。ワークフローを一度定義しておけば、開発者はターミナルからそれを呼び出すことができ、エージェントは毎回同じ手順を実行します。開発者はCopilot CLIを起動し、/agentスラッシュコマンドを使用してエージェントを選択します。対応するプロファイルは、.github/agentsディレクトリに配置されたYAMLフロントマター付きのMarkdownファイルであり、エージェントの役割、スコープ、機能、ガードレールが定義されています。
自動化できるワークフロー
カスタムエージェントに適したワークフローパターンがいくつかあり、チームがすでに繰り返し行っているタスクから導き出されています。セキュリティ監査エージェントはリポジトリ全体で標準的なセキュリティチェックを実行し、重大度別に結果をグループ化した上で、担当者と次のステップを含むプルリクエスト対応のチェックリストを出力します。IaCコンプライアンスエージェントはTerraformのプランやKubernetesのマニフェストを組織のガードレールに照らしてレビューし、リスクのある変更をマークして、承認用のサマリーを生成します。
リリースドキュメントエージェントは前回リリース以降にマージされたプルリクエストを収集してカテゴリ分類し、チームのスタイルに合わせてリリースノートを下書きし、リポジトリのCHANGELOG.mdを更新した上で、テスト、マイグレーション、ロールアウト・ロールバックのメモをカバーするリリースチェックリストを追加します。インシデント対応エージェントはサービス名と時間帯を受け取り、直近のデプロイ、エラーレート、主要エンドポイント、関連ログといった初期調査データを収集し、インシデントレポートを下書きして次のステップを提案します。
既成品とカスタムの選択肢
GitHubはJFrog、Dynatrace、Octopus Deploy、Armなどのパートナーと共同で構築した既成エージェントを提供しており、オブザーバビリティ、IaC、セキュリティといった領域をカバーしています。これらのエージェントには設定済みのワークフローとツール固有の知識が備わっており、チームは自分たちのニーズに合わせてカスタマイズすることもできます。
カスタムエージェントは、独自の命名規則、レビュー基準、社内ツール、セキュリティチェックを毎回の実行に適用し、そのワークフローをコードと同様にバージョン管理したいチームに適しています。
まず始めるにはGitHub Copilot CLIをインストールします。一般的な出発点は、チームが毎週繰り返しているタスクをエージェントに変換し、同じチェックを実行して毎回レビュー可能な出力を生成させることです。パートナーが構築したエージェントの充実したセットがAwesome Copilotリストから利用可能であり、独自のエージェントを定義する前にワークフローをテストする手段として活用できます。
翻訳元: https://www.helpnetsecurity.com/2026/06/10/uilding-reusable-workflows-copilot-cli-custom-agents/
