| name | pr-retrospective |
| description | マージ済の 1 Pull Request から KPT（Keep / Problem / Try）レトロの learning ファイルを生成し、 ハーネス改善提案を起票する。「PR のレトロ」「KPT 振り返り」「PR #NNN の learning を作って」 「マージした PR を振り返って」と言われたとき、または finish-phase 後に PR が merge 済みのときに使う。 複数 PR を集約してハーネスへ書き戻すのは harness-meta skill を使う。 |
| allowed-tools | Bash(gh *) Bash(git *) Bash(pnpm *) Read Write Grep |
pr-retrospective — 1 PR = 1 learning 生成
マージ済 PR を 1 件取り、KPT 振り返りと 📊 指標、🤖 ハーネス改善提案を含む learning ファイルを
docs/harness/learnings/YYYY-MM-DD-pr-<n>.md に生成する。これが pokeform のハーネス自己改良ループの
入口（一段目）。複数 learning の集約・採用判定・書き戻しは harness-meta が担う。
なぜこの skill があるか
PR ごとに「何がうまくいき / 何に詰まり / 次どう改善するか」を構造化して残すと、harness-meta が
複数 PR で反復した課題を機械的に拾い、rule / skill / template / ADR の改修へ繋げられる。だから出力は
人間向けメッセージでなく正規フォーマットのファイル（見出しを harness-meta が parse する）。
前提と SoT
手順
1. 対象 PR を決める
2. idempotent チェック
docs/harness/learnings/ に対象 PR の learning（*-pr-<n>.md）が既にあれば生成せずに skipし、
その旨を報告する（二重生成を防ぐ）。Grep で related_pr: <n> を確認するのが確実。
3. 情報収集
- diff / レビュー / メタ情報:
gh pr view <n> --json number,title,url,mergeCommit,mergedAt,additions,deletions,changedFiles,body
gh pr diff <n>
gh pr view <n> --comments
- CI が失敗していた場合のみログを参照（成功時は不要）:
gh run view --log-failed
- 📊 指標は pokeform のゲート結果（型 / カバレッジ / Biome / CI / 差分 files・行数）を埋める。
ローカルで再確認が要るなら
pnpm verify を使う（機械ゲートの再実装はしない。結果を要約するだけ）。
4. KPT 分析
- diff・レビューコメント・CI 結果から ✅ Keep / ⚠️ Problem / 🚀 Try を各最低 3（推奨 5-10）抽出。
🚀 Try は抽象論で終えず、「どの rule / skill / template / ADR をどう変えるか」まで具体化する。
5. 🤖 ハーネス改善提案を起票
🚀 Try を 5 プレフィックス + [ ] チェックボックスに落とす:
[rule] / [skill] / [template] / [adr]（アーキ決定）/ [remove]。- このセクションは
harness-meta が parse する正規構造なので、プレフィックスと [ ] 形式を厳守する。
6. redaction（書き出し前）
redaction.md の正規表現で token / key / メール / PAT / JWT 等を
[REDACTED-*] 置換する。learning に生の Secret を絶対に残さない。- commit SHA（要約・指標の正規項目）は redact しない。
7. ファイル生成 + INDEX 追記
- 雛形をベースに
docs/harness/learnings/YYYY-MM-DD-pr-<n>.md を生成（YYYY-MM-DD は merge 日 mergedAt）。
frontmatter / 見出し構造の SoT は retrospective-format.md
（generator: pr-retrospective skill・📝 harness-meta フィードバック は空見出しのまま残す）。
learnings/INDEX.md に 1 行追記（同 PR 行があれば idempotent skip）。
8. commit / push（merge はしない）
出力
- 生成 / skip した learning のパスと、KPT・🤖 改善提案の件数を簡潔に報告する。
- redaction で置換した項目があればその種別数を報告（生値は出さない）。
Gotchas
- 二重生成: 必ず手順 2 の idempotent チェックを先に行う。
- 見出しを変えない:
harness-meta が文字列一致で section を特定する。絵文字・文言を保つ。
- merge しない / PR にコメントしない: SoT は learning ファイル。
- 機械ゲートを再実装しない: 型 / テスト / Biome の判定は
pnpm verify に委ね、結果を写すだけ。
- redaction を飛ばさない: 書き出し前に必ず適用。迷う高エントロピー文字列は redact 寄りに倒す。
関連
