GitHub Organizationで「組織標準のAI Agent」を共有する —— .github-private リポジトリ活用術

目次

こんにちは！ACS事業部の青木です。
みなさん、GitHub Copilot 使いこなしていますか？

GitHub Copilot は日々進化しており、IDE でのチャット（GitHub Copilot Chat）はもちろん、ターミナルから操作する GitHub Copilot CLI も、もはや手放せない強力な相棒になりつつあります。
（私はGitHub Copilot CLI派です）

しかし、現場で Copilot の利用状況を見渡してみると、ある「格差」を感じることはないでしょうか。

現状、AI Agent をどれだけ使いこなせるかは、個人の探求心や技術的な習熟度に大きく依存しています。 一部の「使いこなしが上手い人」が独自のカスタムエージェントやプロンプトを編み出して爆速で開発を進める一方で、組織全体としてはその知見が還元されていないケースが少なくありません。

「AI Agent をいかに組織の力に変えるか」という探求は、まだ個人の趣味の延長に留まっており、組織的な利活用へのステップが踏み出せていない……。そんな課題を打破する第一歩が、今回紹介する GitHub Organization でのカスタムエージェント共有 です。

「GitHub Organization でカスタムエージェントを使用する」について

これまで、GitHub Copilot の挙動をカスタマイズする設定は、個人のローカル環境や特定のプロジェクトリポジトリに閉じたものが中心でした。
しかし、GitHub Organization 内に .github-private という特別な名前のリポジトリを作成することで、そこを組織で利用するカスタムエージェントの管理場所として機能させることができます。

docs.github.com

ここに定義を置くだけで、組織内のメンバーは特別な設定をせずとも、GitHub Copilot を通じて「組織標準のエージェント」をすぐに呼び出せるようになります。

実際に試してみた

今回は、「ブログ記事の執筆をサポートしてくれる blog-writer エージェントを組織に展開する」という仮のテーマで触ってみました。

前提条件

• GitHub Enterprise または GitHub Copilot Business を利用していること
• Organization の Owner 権限、またはリポジトリ作成権限があること
• GitHub Copilot（Chat / CLI）が最新の状態であること

1. .github-private リポジトリを作成する

Organization 直下に .github-private という名前でプライベートリポジトリを作成します。

リポジトリ名を入力すると、説明が出てきましたね。
このリポジトリ名が特別であるということ、OrganizationのREADMEを使ってこのリポジトリの存在をアピールしましょう、と言っているのがわかります。

Special profile readme repository
<Organization名>/.github-private is a ✨special ✨ repository that you can use to add a to your organization member profile, visible only to organization members. Make sure it’s private and initialize it with a README in the profile directory to get started.README.md

リポジトリ作成後の画面でも、特別なリポジトリであるということが触れられています。

2. agents ディレクトリにカスタムエージェントを作成する

ここからはvscodeで操作を行っていきます。
.github-privateリポジトリをローカルにクローンしましょう。

リポジトリ内に agents ディレクトリを作り、Markdown 形式でエージェントの定義ファイルを作成します。
まずは.github-privateリポジトリをvscode上にクローンし、カスタムエージェントを作っていきましょう。

Copilot Chatの歯車マークからカスタムエージェントを作成します。

[新しいカスタム エージェントの作成]をクリックします。

続いてエージェントファイルを配置する場所ですが、agentsを指定しましょう。
（.github/agents ではないのでご注意ください）

最後にカスタムエージェント名の名前を入力します。
今回はエージェントの内容自体は重要ではないので、100文字の文章を出力するようなブログエージェントを作るということで"blog-writer"にしました。

エージェントファイルが作成されたら、以下のようにプロンプトを書いてみます。

---
name: blog-writer
description: This custom agent creates engaging and informative blog posts based on given topics.
argument-hint: The inputs this agent expects, e.g., "a topic to write about" or "a question to answer".
tools: [read, edit, search, todo]
---

# 役割

あなたはブログライターです。与えられたトピックに基づいて、魅力的で情報豊富なブログ記事を作成します。読者の関心を引き、理解しやすい内容を提供することが求められます。  
ユーザーから与えられたお題に対して、100文字以内のブログ文を考え、blog/ディレクトリにMarkdown形式で保存してください。  
ファイル名は、トピックを英語で表現したものにしてください。例えば、「AIの未来」というトピックなら、ファイル名は「the-future-of-ai.md」となります。

3. .github-private リポジトリに閲覧権限を付与する

組織のメンバーがこの定義を参照できるよう、リポジトリ設定から Organization メンバーに Read（読み取り）権限 を付与します。
実際に使う場合はリポジトリのVisibilityをinternalを指定すれば同じOrganization内のメンバー全員が参照できますが、一部のメンバーにのみ提供したい場合はprivateでリポジトリを作成し、必要に応じてメンバーやチームにRead権限を付与しましょう。

4. 別リポジトリから呼び出してみる

設定完了後、組織内の任意のリポジトリを作成し、リポジトリ内のカスタムエージェントの定義などが空っぽな状態で GitHub Copilot を開いてみます。

まずはGitHub Copilot CLIから /agent コマンドでカスタムエージェントを探してみると…

blog-writerがいましたね！"remote"と表示されていることがわかります。
試しにこのエージェントを使ってみます。

問題なく動作していることがわかりますね。

ちなみにCopilot Chatのほうでも、以下のように表示されます。

このように、.github-privateリポジトリの/agentディレクトリにカスタムエージェント定義を入れることで、組織的に同じカスタムエージェントが使えることが分かったかとも思います。便利ですね。

活用方法：AI Agent におけるプラットフォームエンジニアリング観点への応用

さて、この機能の真価は何か。
私はずばり、AI Agent における「プラットフォームエンジニアリング」を実現できる点にある、と思っています。

冒頭で触れた通り、AI の利活用が個人の習熟度に依存している現状は、組織としての大きな機会損失です。
また、プロダクトチームにとっては「AIツールに習熟して自分の業務に合うAI Agentを作ること」自体はコア業務ではありません。
AI Agentを効果的に活用するスキルは身に着ける必要がありますが、自分たちの管理しているプロダクトと組織標準に合うAI Agentがあったら迷わずそちらを使いたいはずです。

そこで、プラットフォームチームが組織で利用されている技術スタックを調べ、特定の領域に特化した「エキスパート・エージェント」を組織標準として提供することで、誰でも高い品質のアウトプットを安全に出せる環境を整えることができます。

例えば、以下のようなエージェントを共有できれば、開発体験は劇的に変わるはずです。

1. 組織標準を熟知した「Terraform エキスパート」

• 仕組み: HashiCorp が提供する Agent Skills を搭載し、さらに組織で整備したコーディングルールやセキュリティポリシーを学習させたエージェント。
• メリット: 「このリソースはこのタグ付けが必須」「この構成はセキュリティ上NG」といったルールを、エージェントがコード生成段階で自動適用。レビューの差し戻しが激減し、セキュアな構成を「当たり前」にデプロイできる Paved Road（舗装された道） が実現します。

2. 運用を自動化する「ドキュメント・コンシェルジュ」

• 仕組み: 作成したコードを解析し、組織で定義されたテンプレートに則って運用手順書（SOP）を自動作成するエージェント。
• メリット: 開発者が苦手としがちなドキュメント作成を AI が代行。組織標準のフォーマットを遵守してくれるため、誰が作成しても「読みやすく、そのまま運用に回せる」高品質な資料が手に入ります。

このように、「個人の探求」によって得られた知見を「組織の資産」へと昇華させる。
開発生産性の向上とガバナンスを両立することができることこそが、AI 時代のプラットフォームエンジニアリングの本質ではないでしょうか。

おわりに

.github-private を使ったカスタムエージェントの共有は、設定自体は非常にシンプルですが、その思想は「個の力」を「組織の力」へと変換する強力なものです。

「組織内のAI Agentの達人が作った便利なエージェントを、みんなが使える」

そんな環境が、これからのエンジニアリング組織における新しいスタンダードになっていくはずです。ぜひ、皆さんの Organization でも「組織の武器」となるエージェントを育ててみてください！

ACS事業部のご紹介

私達ACS事業部はクラウドネイティブ技術、Azure AI サービス、Platform Engineering、AI駆動開発支援などを通して、攻めのDX成功に向けた開発者体験・開発生産性の向上・内製化のご支援をしております。

www.ap-com.co.jp また、一緒に働いていただける仲間も募集中です！
今年もまだまだ組織規模拡大中なので、ご興味持っていただけましたらぜひお声がけください。 www.ap-com.co.jp

本記事の投稿者
青木平：柔道が趣味のエンジニアです。
Kubestronaut/Microsoft Top Partner Engineer 2025