比較
Apothem と素の GitHub Copilot 構成の比較
GitHub Copilot の copilot-instructions.md を手作業で保守するのと、Apothem の共有プロファイルからレンダリングするのとの比較。
GitHub Copilot は .github/copilot-instructions.md から指示を読み込みます。
Apothem の github-copilot アダプターは、そのファイルを共有プロファイルから
レンダリングします。このページでは、その構成を手作業で保守する場合と Apothem で
管理する場合を対比します。
手間の比較
| タスク | 手作業の構成 | Apothem 管理 |
|---|---|---|
| 指示を書く | .github/copilot-instructions.md を手で編集 | レンダリング：共有ルールをファイルに埋め込み |
| 指示を他のハーネスと揃えて保つ | 手作業、ツールごと | apothem update で自動 |
| 構成をインストール・削除する | ファイルを手で書き・削除 | apothem install / apothem uninstall |
| 再利用可能なスキルとコマンドを共有する | 各スキルフォルダーを ~/.agents/skills/ へ手でコピーし、コピーを最新に保つ | アダプターが ~/.agents/skills/ に書き込み、すべてのプロジェクトで 1 つのコピーを共有し、apothem update で更新 |
| 構成が正しいか検証する | 手作業での確認 | apothem verify --harness github-copilot --project <path> |
Apothem が管理するもの
github-copilot アダプターは共有ルールを .github/copilot-instructions.md に
埋め込みます。Copilot はフックを .github/hooks/*.json で文書化していますが、
アダプターはこれを書き込まないため、ガードレールの意図はレンダリングされた指示の中で
完全に担われます。
共有ルールへの変更はすべて、次の apothem update でファイルを再レンダリング
します。
移行パス
- まだ共有プロファイルを作成していなければ、
apothem profile initを実行します。 - 既存の
.github/copilot-instructions.mdの内容を、共有コーパスへ移します。 apothem install --harness github-copilot --project <path>を実行して、指示ファイルをレンダリングします。apothem verify --harness github-copilot --project <path>を実行して、構成が配置されたことを確認します。- 以降の変更には毎回
apothem update --harness github-copilot --project <path>を使います。