** GitHub Copilot の中央化されたコンテキスト管理は、Canonical エコシステムを渡します。**

このリポジトリは、標準化されたコピロカスタム指示、プロンプト、エージェント、スキルを配布するための「ツールキット」として機能します。 個々のリポジトリを「サブスクライブ」に特定のアセット(例えば、Python 規格、Juju/Ops Framework パターン)に割り当て、自動的に同期させることができます。

##コレクションとは?

ACollectionは、collections.yaml.で定義されたマークダウンファイル(指示、プロンプト、エージェント、スキル)の論理グループです。

特定の命令を手動で50の異なるリポジトリにコピーする代わりに、消費リポジトリは、必要なコレクションのリストの設定ファイルを定義します。

利用可能なコレクション(例):

*コア:すべてのリポジトリに共通するコアアセット。

• common-python:標準Pythonコーディングスタイル。
• 共通ドキュメント:レビュースキルを持つドキュメント規格。
• charm-python: Common-python + Juju Ops Framework の指定を含む。
• copilot-toolkit:Copilotアセット(エージェント、スキル、プロンプト、指示)の生成と管理のためのメタツール。
• pfe-charms:プラットフォームエンジニアリングの特定のコレクション。

##使用量:リポジトリに追加

Canonical Copilot Collections

Centralized context management for GitHub Copilot across the Canonical ecosystem.

This repository acts as a “Toolkit” to distribute standardized Copilot Custom Instructions, Prompts, Agents and Skills. It allows individual repositories to “subscribe” to specific sets of assets (e.g., Python standards, Juju/Ops Framework patterns) and keep them synchronized automatically.

What are Collections?

A Collection is a logical group of markdown files (instructions, prompts, agents, and skills) defined in collections.yaml.

Instead of copying specific instructions into 50 different repositories manually, the consuming repository defines a configuration file listing the collections it needs.

Available Collections (Examples):

• core: Core assets common to all repositories.
• common-python: Standard Python coding style.
• common-documentation: Documentation standards with review skill.
• charm-python: Includes common-python + Juju Ops Framework specifics.
• copilot-toolkit: Meta-tools for generating and managing Copilot assets (agents, skills, prompts, instructions).
• pfe-charms: Platform Engineering specific collection.

Usage: Adding to a Repository

To add Copilot collections to your repository, follow these three steps.

Note: These steps assume that if the yq tool is already installed, it was installed via snap not via apt. The install scripts rely on behavior from the snap version of yq. The apt offering of yq doesn’t have the behavior the scripts expect, and will fail. If yq is not installed, the script will automatically install it via snap.

1. Create the Configuration

Create a file named .copilot-collections.yaml in the .github folder of your repository (recommended) or in the repository root.

copilot:
  # The version of the toolkit to use (matches a Release Tag in this repo)
  version: "v1.0.0"

  # The collections you want to install
  collections:
    - charm-python
    - pfe-charms

Location Preference: The workflow and sync script will search for the config file in this order:

1. .github/.copilot-collections.yaml (recommended)
2. .copilot-collections.yaml (root, for backwards compatibility)

You can also specify a custom location - see below for details.

2. Run the Initial Sync (Local)

You can sync the instructions immediately to your local machine to verify them.

curl -sL https://raw.githubusercontent.com/canonical/copilot-collections/main/scripts/local_sync.sh | bash

To specify a custom config file location:

# Via command-line argument
curl -sL https://raw.githubusercontent.com/canonical/copilot-collections/main/scripts/local_sync.sh | bash -s -- custom/path/.copilot-collections.yaml

# Via environment variable