Copilot Memory とカスタム指示の違い：メモリの保存場所と削除方法

全 12 ステップ：ディスク上のフォルダーからコミットする指示テンプレートまで

Copilot が本当に必要とする 6 つを押さえるカスタム指示テンプレート

GitHub 自身の指針は、ファイルを短く具体的に保つことです。スタックは何か、どう実行するか、コードはどこにあるか、どの規約が必須か、何を避けるか。以下のブロックはコピーしてから削る前提で書いています——エージェントがリポジトリを読めば分かる行は削ってください。肥大化した指示ファイルは、本当に重要なルールを薄めてしまいます。リポジトリのルートに .github/copilot-instructions.md として保存します。

# .github/copilot-instructions.md

## Project and stack
- Next.js 15 app router, TypeScript strict, Node 22.
- Package manager: pnpm. Never run npm or yarn install.

## Commands
- Build: pnpm build
- Lint: pnpm lint
- Test everything: pnpm test
- Test one file: pnpm test -- path/to/file.test.ts

## Layout
- Routes: src/app/**
- UI components: src/components/**
- Data access: src/lib/db.ts and src/lib/repositories/**
- Tests live next to the file they cover: *.test.ts

## Conventions
- Named exports only; no default exports from src/lib.
- Handle errors at the boundary and return early instead of nesting.
- Import order: node builtins, external packages, then @/ aliases.

## Testing and review
- Every behaviour change ships with a test in the same pull request.
- Run the single-file test before requesting review.
- Commit messages follow Conventional Commits.

## Do not
- Do not edit files under src/generated/**.
- Do not add a dependency without calling it out in the pull request.
- Do not log secrets, tokens or full request bodies.

• 1プロジェクトとスタック——フレームワーク、言語モード、パッケージマネージャーを 1 行で明記します。npm・pnpm・yarn の間でエージェントが推測し、頼んでいない lockfile を生成するのを止めるブロックです。
• 2コマンド——ビルド、lint、テスト、単一ファイルのテストの正確なコマンド。記憶ではなく CI の設定からコピーしてください。テストコマンドの誤りは、最も高くつく一行です。
• 3レイアウト——ルート、コンポーネント、データアクセス、テストがどこにあるか。アーキテクチャを文章で説明せず、ディレクトリを指してください。パスは検証できますが、段落は検証できません。
• 4規約——命名、エラー処理、import の順序、チームが実際に守っているフォーマット規則。各ルールは二値で判定できる形にします。コードが従っているか、いないかです。
• 5テストとレビュー——テストが必須の変更は何か、レビューで何を確認するか、コミットやブランチの規約。本来メモリに頼るはずのものを保証に変えるブロックです。
• 6やってはいけないこと——アンチパターン。生成ファイル、無断の依存追加、無関係なリファクタリング、ログへのシークレット出力。悪い Pull Request をまとめて防ぐには、禁止ルールが最も安上がりです。

2 つ目のファイルで範囲を絞る

フォルダー固有のルールを .github/instructions/ 以下の別ファイルに移せば、リポジトリのファイルを短く保てます。効くのはフロントマターです。applyTo が一致するパスへ自動で添付し、description がエージェントに適切なタスクで読み込ませます。VS Code は対応フィールドとして name、description、applyTo を挙げています。

---
name: 'React components'
description: 'Use when creating or updating components under src/components.'
applyTo: 'src/components/**/*.tsx'
---

# React components
- One component per file, named after the file.
- Props are typed with an explicit interface; no React.FC.
- Colocate styles with the component; no global class names.

自分の好みはリポジトリのファイルに書かない

プロジェクトではなく自分に関するもの——回答の長さ、トーン、diff の説明の好み——は個人用の指示に置きます。Copilot CLI とエージェントホストは ~/.copilot/copilot-instructions.md を読み、github.com では Copilot Chat を開いてプロフィール画像をクリックし Personal instructions を選びます。GitHub は [format] のようなプレースホルダー付きのテンプレートも用意しています。個人用の指示はリポジトリと組織の指示より優先されるため、そこで設定した好みをリポジトリごとに繰り返す必要はありません。

すべてのブロックに共通する最後の 2 つのルールです。コミットする指示ファイルにシークレット・トークン・顧客データを入れないこと。リポジトリの指示とメモリに食い違いを作らないこと——衝突した場合、Copilot は両方のコンテキストにできる範囲で従おうとするため、結果は予測できません。メモリが書き込んだルールと矛盾し続けるなら、ルールを緩めるのではなくメモリを削除してください。