Copilot Spaces

Copilot Spaces を使用して、キュレーションされたプロジェクト固有のコンテキストを会話に組み込みます。Space は、リポジトリ、ファイル、ドキュメント、および指示の共有コレクションであり、Copilot の応答をチームの実際のコードと知識に基づかせます。

利用可能なツール

MCP ツール (読み取り専用)

ツール	目的
mcp__github__list_copilot_spaces	現在のユーザーがアクセス可能なすべての Space を一覧表示
mcp__github__get_copilot_space	所有者と名前で Space の完全なコンテキストを読み込む

REST API (gh api 経由) (完全な CRUD)

Spaces REST API は、Space の作成、更新、削除、およびコラボレーターの管理をサポートしています。MCP サーバーは読み取り操作のみを公開しているため、書き込みには gh api を使用してください。

ユーザー Space:

メソッド	エンドポイント	目的
POST	/users/{username}/copilot-spaces	Space を作成
GET	/users/{username}/copilot-spaces	Space を一覧表示
GET	/users/{username}/copilot-spaces/{number}	Space を取得
PUT	/users/{username}/copilot-spaces/{number}	Space を更新
DELETE	/users/{username}/copilot-spaces/{number}	Space を削除

Organization Space: /orgs/{org}/copilot-spaces/... 配下で同じパターン

コラボレーター: .../collaborators でコラボレーターを追加、一覧表示、更新、削除

スコープ要件: PAT は読み取りに read:user、書き込みに user が必要です。gh auth refresh -h github.com -s user で追加してください。

注: この API は機能していますが、まだ公開 REST API ドキュメントには含まれていません。copilot_spaces_api フィーチャーフラグが必要な場合があります。

Space を使用する場合

• ユーザーが「Copilot space」に言及したり、「space を読み込む」よう求めたとき
• ユーザーが特定のプロジェクトドキュメント、コード、または基準に基づいた回答を望むとき
• ユーザーが「どのような space が利用可能か?」または「X の space を探して」と尋ねるとき
• ユーザーがオンボーディングコンテキスト、アーキテクチャドキュメント、またはチーム固有のガイダンスが必要なとき
• ユーザーが Space で定義された構造化ワークフロー (テンプレート、チェックリスト、複数ステップのプロセス) に従いたいとき

ワークフロー

1. Space を発見する

ユーザーがどの space が利用可能かを尋ねたり、適切な space を見つける必要がある場合:

mcp__github__list_copilot_spaces を呼び出す

これにより、ユーザーがアクセス可能なすべての space が返されます。各 space には name と owner_login があります。関連するマッチをユーザーに提示します。

特定のユーザーの space をフィルタリングするには、owner_login をユーザー名と照合します (例: 「私の space を表示して」)。

2. Space を読み込む

ユーザーが特定の space に言及したり、適切な space を特定した場合:

mcp__github__get_copilot_space を以下で呼び出す:
  owner: "org-or-user"    (リストから取得した owner_login)
  name: "Space Name"      (完全な space 名、大文字小文字を区別)

これにより space の完全なコンテンツが返されます: 添付されたドキュメント、コードコンテキスト、カスタム指示、およびその他のキュレーションされた資料。このコンテキストを使用して応答に反映させます。

3. パンくずをたどる

Space のコンテンツは外部リソースを参照することが多いです: GitHub の Issue、ダッシュボード、リポジトリ、ディスカッション、またはその他のツール。これらを他の MCP ツールを使用して積極的に取得し、完全なコンテキストを収集してください。例:

• space が主要なトラッキング Issue を参照している。issue_read を使用して最新のコメントを取得します。
• space がプロジェクトボードにリンクしている。プロジェクトツールを使用して現在のステータスを確認します。
• space がリポジトリのマスタープランに言及している。get_file_contents を使用してそれを読みます。

4. 回答または実行する

読み込まれたら、コンテンツに基づいて space コンテンツを使用します:

space に参考資料 (ドキュメント、コード、基準) が含まれている場合:

• プロジェクトのアーキテクチャ、パターン、または基準に関する質問に答える
• チームの規約に従うコードを生成する
• プロジェクト固有の知識を使用して問題をデバッグする

space にワークフロー指示 (テンプレート、ステップバイステップのプロセス) が含まれている場合:

• ワークフローを定義に従ってステップバイステップで実行する
• ワークフローが指定するソースからデータを収集する
• ワークフローが定義する形式で出力を生成する
• 各ステップの後に進行状況を表示し、ユーザーが方向を決められるようにする

5. Space を管理する (gh api 経由)

ユーザーが space を作成、更新、または削除したい場合は gh api を使用します。まず、リストエンドポイントから space 番号を見つけます。

space の指示を更新:

gh api users/{username}/copilot-spaces/{number} \
  -X PUT \
  -f general_instructions="ここに新しい指示"

名前、説明、指示をまとめて更新:

gh api users/{username}/copilot-spaces/{number} \
  -X PUT \
  -f name="更新された名前" \
  -f description="更新された説明" \
  -f general_instructions="更新された指示"

新しい space を作成:

gh api users/{username}/copilot-spaces \
  -X POST \
  -f name="My New Space" \
  -f general_instructions="...の手助けをしてください" \
  -f visibility="private"

リソースを追加 (リソース一覧全体を置き換える):

{
  "resources_attributes": [
    { "resource_type": "free_text", "metadata": { "name": "Notes", "text": "ここにコンテンツ" } },
    { "resource_type": "github_issue", "metadata": { "repository_id": 12345, "number": 42 } },
    { "resource_type": "github_file", "metadata": { "repository_id": 12345, "file_path": "docs/guide.md" } }
  ]
}

space を削除:

gh api users/{username}/copilot-spaces/{number} -X DELETE

更新可能なフィールド: name、description、general_instructions、icon_type、icon_color、visibility ("private"/"public")、base_role ("no_access"/"reader")、resources_attributes

例

例 1: ユーザーが Space を要求する

ユーザー: 「Accessibility copilot space を読み込んで」

アクション:

1. mcp__github__get_copilot_space を所有者 "github"、名前 "Accessibility" で呼び出す
2. 返されたコンテキストを使用して、アクセシビリティ基準、MAS グレード、コンプライアンスプロセスなどについての質問に答える

例 2: ユーザーが Space を探したい

ユーザー: 「チームで利用可能な copilot space は何ですか?」

アクション:

1. mcp__github__list_copilot_spaces を呼び出す
2. ユーザーの組織または関心に関連する space をフィルタリング/提示する
3. 関心のある space を読み込むことを提案する

例 3: コンテキストに基づいた質問

ユーザー: 「セキュリティ space を使用して、秘密スキャンに関する私たちのポリシーは何ですか?」

アクション:

1. 適切な所有者と名前で mcp__github__get_copilot_space を呼び出す
2. space コンテンツ内の関連するポリシーを見つける
3. 実際の内部ドキュメントに基づいて答える

例 4: Space をワークフローエンジンとして

ユーザー: 「PM Weekly Updates space を使用して週間アップデートを作成して」

アクション:

1. mcp__github__get_copilot_space を呼び出して space を読み込む。テンプレート形式とステップバイステップの指示が含まれています。
2. space のワークフローに従う: 添付された主要 Issue からデータを取得し、メトリクスを収集し、各セクションをドラフトします。
3. space が参照する外部リソース (トラッキング Issue、ダッシュボード) を他の MCP ツールを使用して取得します。
4. 各セクションの後にドラフトを表示し、ユーザーがレビューしてギャップを埋められるようにします。
5. space が定義する形式で最終出力を生成します。

例 5: Space の指示をプログラムで更新

ユーザー: 「PM Weekly Updates space を更新して、新しい執筆ガイドラインを含める」

アクション:

1. mcp__github__list_copilot_spaces を呼び出して space 番号を見つける (例: 19)。
2. mcp__github__get_copilot_space を呼び出して現在の指示を読む。
3. リクエストに従って指示テキストを変更します。
4. 更新をプッシュします:

gh api users/labudis/copilot-spaces/19 -X PUT -f general_instructions="更新された指示..."

ヒント

• Space 名は 大文字小文字を区別します。list_copilot_spaces からの完全な名前を使用してください。
• Space はユーザーまたは組織が所有できます。常に owner と name の両方を提供してください。
• Space コンテンツは大きい場合があります (20KB+)。一時ファイルとして返されている場合は、grep や view_range を使用して関連するセクションを見つけ、すべてを一度に読むのではなく対応してください。
• space が見つからない場合は、利用可能な space を一覧表示して正しい名前を見つけることを提案します。
• Space は基盤となるリポジトリの変更に応じて自動的に更新されるため、コンテキストは常に最新です。
• いくつかの space には、あなたの動作をガイドするカスタム指示が含まれています (コード基準、優先されるパターン、ワークフロー)。これらを提案ではなくディレクティブとして扱います。
• 書き込み操作 (作成/更新/削除用の gh api) には user PAT スコープが必要です。書き込み操作で 404 エラーが発生した場合は、gh auth refresh -h github.com -s user を実行してください。
• リソース更新は 配列全体を置き換えます。リソースを追加するには、すべての既存リソースと新しいリソースを含めます。削除するには、配列に { "id": 123, "_destroy": true } を含めます。