git:20260809.21ece62 to git:20260820.6359bfc

---

name: retro-copilot

description: "Run a retro for ~/.copilot assets and turn incident learnings into updates for copilot-instructions, instructions, skills, agents, and hooks. Triggers on retro, retrospective, incident learning, error analysis, copilot setup, instructions update, インシデント, and 知見反映."

argument-hint: "エラーログ、diff、会話要約、既存 .copilot 資産、またはインシデント内容"

user-invocable: true

license: CC BY-NC-SA 4.0

metadata:

author: yamapan (https://github.com/aktsmm)

---

# Retro Copilot

インシデント・会話から再利用可能な知見を抽出し、`~/.copilot` 配下の instructions / skills / agents / hooks / related config へ反映するための変更案を作る。

## When to Use

- 使う: バグ解決後 / 再発発生時 / レビューで `.copilot` 配下の個人用資産の設計ギャップが見つかったとき

- 使う: `~/.copilot/copilot-instructions.md`、`~/.copilot/instructions/**`、`~/.copilot/skills/**`、`~/.copilot/agents/**`、`~/.copilot/hooks/**` へ反映すべき運用知見があるとき

- 使わない: typo など軽微修正のみ / 環境固有問題のみ

- 使わない: workspace / repository 固有の内容。代わりに `retro-workspace` を使う

- 使わない: VS Code User Data の内容。代わりに `retro-user` を使う

## Core Rules

- `memory` は反映先にしない

- `/memories/**`、user memory、session memory、repo memory を対象にしない

- 既定モードは `safe-auto`。`.copilot` scope が明確で、Safety & Scope Gate を通過し、既存資産への小〜中規模な統合・更新で済む場合は、確認なしで反映まで実行してよい

- `review-only` / `確認だけ` / `dry-run` / `プレビュー` が明示された場合だけ、変更案の提示で停止する

- 次の場合だけユーザー確認で停止する: scope 判断が曖昧、大規模削除、公開・同期範囲変更、hook / config の高リスク変更、既存 agent / skill の意味を大きく変える変更、secret / 個人情報 / 環境固有値の扱いに迷う場合

- 新規ファイル作成より既存ファイルへの統合を優先する

- 新しいルールを書く前に、同じ判断が scripts / 生成物 / 既存資産に実装済みでないか確認する。実装と矛盾するルールは、次の run に正しい資産を壊させる

- 他スコープの内容なら自分で編集せず handoff する

## Workflow

```text

Context -> Extract -> Safety & Scope Gate -> Decide Action & Target -> Validate & Output

```

## Phase 1: Context Collection

- 入力（1つ以上必須）

- エラーログ、diff/commit、会話履歴、ターミナル履歴、既存 `.copilot` 資産

- 既定の反映スコープ

- `~/.copilot` 配下の個人グローバルカスタマイズ資産を優先する

- memory 系スコープは反映先にしない

- ターミナル観点

- Exit Code != 0

- Ctrl+C（中断）

- 同コマンド反復

- 長時間実行

- Gate: 入力なしなら追加要求して停止

## Phase 2: Extract Learnings

- カテゴリ

- 設計原則（SRP/SSOT/idempotency）

- ワークフロー

- プロンプト設計

- コンテキスト設計

- エラーパターン

- 1件ごとに `Learning / Evidence / Impact` を作成

- Gate: actionable な知見がなければ停止

## Phase 2.5: Safety & Scope Gate

- 反映禁止または抽象化が必要な情報

- secret、認証情報、API キー、接続文字列

- 個人情報、顧客情報、個人アカウント値

- ローカル絶対パス、端末固有値、一時ディレクトリ

- 外部共有に不向きな会話本文やログ断片

- No Memory Targets Gate

- `/memories/**`、user memory、session memory、repo memory を反映先にしない

- memory に残す必要がある依頼は、この skill では実行せず別タスクとして明示確認する

- Scope Gate

- `~/.copilot` 配下の資産に置くべき内容か確認する

- workspace / repository や VS Code User Data に置くべき内容なら、この skill では反映せず handoff を提案する

- Gate（全必須）

- 永続化する知見は再利用可能なルールに抽象化されている

- 証拠は必要最小限で、機微情報を含まない

- `~/.copilot` 配下に置くべき内容か確認済み

- Self-Contained: 追加内容が他 file への hard reference や workspace 固有値に依存せず、`~/.copilot` 単体で機能する（ツール制約も尊重: 例 Copilot CLI は prompt 不可なので primitive は SKILL を選ぶ）

- No Memory Targets Gate を通過済み

## Refactor Context Rules

- SSOT を守る。重複定義は統合する

- 新規ファイル作成より既存ファイルへの統合を優先する

- 既存ファイルに 1 セクション追加や 1 ルール追記で済むなら、新規ファイルを作らない

- 単一ルール追加や導線追加は catch-all な既存ファイルを優先し、新規ファイルは最後の手段にする

- 新規ファイルは、既存ファイルの役割に収まらず `Target Rationale` で必要性を説明できる場合だけ許可する

- 50 行以下の小さいファイルは、明確な価値がない限り変更不要または最小差分とする

- 冗長説明は圧縮するが、根拠 URL・非自明な手順・運用メタコメントは消さない

- `Target Rationale` では「なぜ新規作成でなく既存統合か」を必ず説明する

## Phase 3: Decide Action & Target

- 優先度: Impact x Recurrence（P1/P2/P3）

- 反映先

- 共通原則 → `~/.copilot/copilot-instructions.md`

- domain instructions → `~/.copilot/instructions/**/*.instructions.md`

- skills → `~/.copilot/skills/**/SKILL.md`

- agents → `~/.copilot/agents/**/*.agent.md`

- hooks → `~/.copilot/hooks/**/*.json`

- related config → 次に限定する

- `~/.copilot/config.json`

- `~/.copilot/settings.json`

- `~/.copilot/permissions-config.json`

- `~/.copilot/mcp-config.json`

- `~/.copilot/mcp-oauth-config/**`（customization と直接整合するものだけ）

- 単一 vs 複数反映の判断

- 原則: 最も specific な 1 ファイルへ統合する

- 例外（複数反映を許可）: 複数 file が独立して owning すべき cross-cutting 原則（例: tool-platform 制約、Self-Contained gate、cwd discipline）は、該当する全 file に 1 行ずつ追加してよい。各コピーは独立 SSOT として、他 file への hard reference に依存せず単体で機能する形にする。同じ長いブロックをコピーせず、各 file には 1 行の判断だけを入れる

- 反映禁止

- workspace / repository の `AGENTS.md`、`.github/**`、workspace docs

- VS Code User Data の `*.prompt.md` / `*.instructions.md` / `*.agent.md`

- `/memories/**`、user memory、session memory、repo memory

- `command-history-state.json`、`session-store.db`、`vscode.session.metadata.cache.json`

- `session-state/**`、`logs/**`、`pkg/**`、`crash-context/**`、`restart/**` のようなランタイム生成物やキャッシュ

- 反映先ファイルが存在しない場合:

- safe-auto で新規作成してよい。ただし既存資産に統合できる場合は統合を優先する

- ディレクトリも不在なら、作成予定のパスと理由を示す

- scope や公開可否に迷う場合だけユーザー承認後に重複/矛盾チェックへ進む

## Decision Rules

- まず既存 `.copilot` 資産へ統合できないかを見る

- instructions は原則、skills はタスク手順、agents は役割分離、hooks は決定的自動化の棲み分けで選ぶ

- 新規作成は既存の役割に収まらない場合だけ

- workspace / repository へ反映すべき内容は `retro-workspace` に handoff する

- VS Code User Data へ反映すべき内容は `retro-user` に handoff する

- memory 系スコープは反映先にしない

- 最小差分で反映する

## Output Requirements

- `## Learnings`

- `## Changes`

- `## Target Rationale`

- `## Review Checkpoint`

`## Review Checkpoint` には最低限次を含める:

- [ ] safe-auto executed or user approval obtained when gated

- [ ] Copilot scope confirmed

- [ ] No duplicate rules verified

- [ ] Target files are writable

- [ ] Safety & Scope Gate passed

- [ ] No memory target selected