retrospective-codifylisted

# Retrospective Codify タスクの終盤で「最初にこれを知っていれば遠回りしなかった」知見を抽出し、静的ルール・skill・常時有効ルールのいずれかに固定する。プロンプトに頼らず再現可能な形に落とすことを優先する。 ## いつ使うか - タスク完了直前、またはユーザーから「学びを残して」「ルール化して」と指示されたとき - 試行錯誤の末に解にたどり着いたとき（初手で詰まった、誤った仮説を立てた、ドキュメント不足で時間を溶かした 等） - 同種のタスクを将来また行う可能性があるとき 使わない場面: - 一発で通った単純なタスク（抽出する学びがない） - プロジェクト固有の一回限りの対応（コミットメッセージで十分） ## ワークフロー 1. **失敗⇄成功の対応付け**: 今回のタスクから次の 3 点を書き出す。 - 最初の試行（何をした / どう失敗した） - 最終解（何が効いた） - 橋渡しになった気付き（なぜ最初の試行では届かなかったか） 2. **「最初に知るべきだったこと」の言語化**: 気付きを 1 〜 3 文で要約する。回顧でなく、未来の自分への指示形で書く（"〜するな" / "〜を先に確認せよ"）。 3. **分類**: 下の判定表に従って出力先を決める。 4. **重複チェック（必須）**: 提案前に既存の知見と照合する。重複や近接する規則があれば「新規追加」ではなく「既存への追記 / 更新」を選ぶ。これを怠ると skill / ルールが肥大化する。 検索キー候補は気付きから 2 〜 3 語抽出する（ツール名・API 名・症状語・対義語）。例: 気付きが「pnpm v10 を使う」なら `pnpm`, `packageManager`, `lockfile`。 照合先と最低限の検索: ``` # skill 重複（Claude global） ls ~/.claude/skills/ Grep "<キー>" ~/.claude/skills/*/SKILL.md # skill 重複（Codex global / project） ls ~/.codex/skills/ Grep "<キー>" ~/.codex/skills/*/SKILL.md Grep "<キー>" <project-root>/.agent/skills/*/SKILL.md # CLAUDE.md 重複 Grep "<キー>" ~/.claude/CLAUDE.md Grep "<キー>" <project-root>/CLAUDE.md # 該当プロジェクトがある場合 # AGENTS.md 重複（Codex / project） Grep "<キー>" ~/.codex/AGENTS.md Grep "<キー>" <project-root>/AGENTS.md # lint ルール重複 ls <project-root>/rules/ Grep "<キー>" <project-root>/rules/ ``` 結果を 4 段階に分類: - **新規**: ヒット無し → 通常の提案 - **既存追記**: 関連 skill/ルールが存在し、追加情報が補完的 → 「既存に追記」を提案 - 「部分重複」（学びの一部だけが既存カバー、残りが新規）も