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 固有の内容（workspace/repository assets 向けの retro workflow へ渡す）
• 使わない: private skills repository の .github/skills/**（private skills repository 向けの retro workflow へ渡す）

Core Rules

• memory は反映先にしない
  • /memories/**、user memory、session memory、repo memory を対象にしない
• 既定モードは safe-auto。.copilot scope が明確で、Safety & Scope Gate を通過し、既存資産への小〜中規模な統合・更新で済む場合は、確認なしで反映まで実行してよい
• review-only / 確認だけ / dry-run / プレビュー が明示された場合だけ、変更案の提示で停止する
• Confirm only unclear scope, new privileges/destinations/visibility/defaults, destructive deletion or uncertain sensitive data; otherwise use safe-auto without reapproval. Read-only and holds take precedence.
• Match committed implementation, not local drafts; defer unsupported operations rather than inventing capabilities.
• List up to three scoped read-only follow-ups: authoring/private-push/distribution gaps. Honor holds and visibility; never widen actions or audits from a suggestion.
• 他スコープの内容なら自分で編集せず handoff する
• ~/.copilot は作業コピーなので直接編集してよい。ただし正本（skills は private skills repository、instructions は公開 instructions repository）へ戻す同期は別途必要で、managed な skill は更新で上書きされ得る。反映後の Review Checkpoint で同期要否を示す

Workflow

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

Phase 1: Context Collection

• 入力（1つ以上必須）
  • エラーログ、diff/commit、会話履歴、ターミナル履歴、既存 .copilot 資産
• 既定の反映スコープ
  • ~/.copilot 配下の個人グローバルカスタマイズ資産を優先する
  • workspace / repository へ反映すべき知見はこの skill では扱わず、handoff を提案する。workspace handoff は host が提供する active workspace を指定し、外部の新規プロジェクトフォルダを作成・提案しない
• ターミナル観点
  • 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 に置くべき内容なら、この skill では反映せず handoff を提案する
• Gate（全必須）
  • 永続化する知見は再利用可能なルールに抽象化されている
  • 証拠は必要最小限で、機微情報を含まない
  • ~/.copilot 配下に置くべき内容か確認済み
  • Self-Contained: 追加内容が他 file への hard reference や workspace 固有値に依存せず、~/.copilot 単体で機能する（ツール制約も尊重: 例 Agent Host は *.prompt.md を読まないので 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
  • /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

• instructions は原則、skills はタスク手順、agents は役割分離、hooks は決定的自動化の棲み分けで選ぶ
• handoff 先: workspace / repository、private skills repository の知見は、そのスコープ向けの retro workflow へ渡す（このスキルでは編集しない）
• 最小差分で反映する

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