메뉴
Issue 対応が完了し PR を作成した後に、実装精度を高めるための振り返りを行う。 実装中に踏んだ罠・判断のブレ・チェック漏れを特定し、instructions.md・SKILL.md・copilot-instructions.md への具体的な改善提案に落とし込む。「ふりかえり」「振り返り」「retro」「改善案」などのキーワードで起動する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Playwright MCP を使ってブラウザを起動し、実際の画面スクリーンショットを根拠にした UI/UX レビューを行う際の標準手順。UX Review・UI Review v2 エージェントが読み込む。
ランタイム動作の不具合（再生制御、状態遷移、イベントタイミングなど）を調査・修正する際の標準手順。 外部 API や非同期イベントが絡む不具合に使う。コードを読むだけで確証が出ない場面に適用する。
Add a new API resource end-to-end: types, composables, components, and pages. Use when adding a new backend resource, endpoint, or CRUD page set to the Nuxt frontend.
| name | issue-retrospective |
| description | Issue 対応が完了し PR を作成した後に、実装精度を高めるための振り返りを行う。 実装中に踏んだ罠・判断のブレ・チェック漏れを特定し、instructions.md・SKILL.md・copilot-instructions.md への具体的な改善提案に落とし込む。「ふりかえり」「振り返り」「retro」「改善案」などのキーワードで起動する。 |
PR 作成後、実装精度を上げるためのルーティン振り返り。
成果物は感想文ではなく「次回の実装ルールの改訂案」。
git log --oneline -5
git diff main...HEAD --stat
以下のカテゴリで確認する：
app/plugins/fontawesome.ts の library.add に追加済みかgit add -A や git add . を使った場合、意図しないファイル（worktrees/, _.png, _.log）が staging に混入していないかgit diff --stat で staging の中身を確認してからコミットしたかwatch(ref, callback) で ref を直接渡したとき、vue.instructions.md の composable 返却ルール（computed の auto-unwrap）に注意が必要か確認したかdefineExpose が必要なコンポーネントに追加できていたかimport.meta.client ガードを適切に入れていたか! 修飾子の記法（!h-5 → h-5!）を最初から使えていたか@mousedown.prevent を付けるべき場所に付けていたかoverscroll-contain による背面スクロール抑止が入っていたか| 分類 | 対応 |
|---|---|
| 毎回チェックすべき → チェックリスト追加 | 対象 instructions.md または SKILL.md に追記 |
| 特定ファイルを変更するときに気をつける → instructions.md の applyTo 強化 | 例: fontawesome.ts を変更するとき |
| プロセスの問題 → copilot-instructions.md のワークフロー修正 | 例: git add のルール |
| 一度きりの個別事情 → 記録不要 | — |
改善提案は必ず「どのファイルのどのセクションに何を追加/変更するか」まで具体化する。
### [対象ファイル: パス]
**追加/変更する場所**: セクション名または行の前後コンテキスト
**変更内容**:
（追加するルールや警告の文章）
**理由**: 今回どんな問題があったか（1行）
ユーザーに改善案を提示し、確認を得てから以下を実行：
/memories/ に書き込むcopilot-instructions.md のワークフロー変更は影響範囲が大きいため、ユーザーと合意してから行うファイル更新後、変更を commit して main への PR を作成する。
# まず main に切り替えて最新化する（Issue 対応直後は作業ブランチのままの可能性がある）
git checkout main && git pull
# 振り返り専用ブランチを切る
git checkout -b chore/retro-issue-<番号>
# 変更ファイルを明示的に add
git add .github/skills/... .github/instructions/... .github/copilot-instructions.md
# コミット
git commit -m "chore: update instructions/skills based on issue-<番号> retro"
# push
git push -u origin chore/retro-issue-<番号>
PR 本文には以下を含める：
## 振り返りで見つかった改善点
- （変更した指示・スキルの内容と理由を箇条書き）
Issue #<番号> の実装を通じて見つかった改善なので、関連 Issue を参照として記載。
main ブランチ向けに作成する.github/ 配下の指示・スキルファイルのみ（アプリコードは含めない）git diff --stat で staging を確認してからコミットしたfontawesome.ts に登録した! 修飾子の記法が正しい（h-5! など）