메뉴
対象 PR の diff / comments / reviews / CI ログ / Skill 実行ログ / 三層指標差分 / 関連 Plan・Epic を収集し、docs/harness/learnings/YYYY-MM-DD-pr-<n>.md を日本語の構造化フォーマットで生成する。 harness/learnings-batch-YYYY-WW ブランチに集約し、週次 (or 件数到達時) に PR として起票する。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Plan / Epic 確定後の実装着手 → Lint/Test → AI Review → マージ → レトロ起動 → worktree クリーンアップを 10 フェーズ (Phase 0-9) で統合管理するオーケストレーター。 Phase 0 で git worktree を作成し、Phase 9 で削除することで複数 Claude Code セッションの 並行実装を物理分離する。`feature-request` / `bug-fix` / `refactor` / `dependency-upgrade` が起票した Plan / Epic 確定後の実装着手指示を受けたとき、または orchestrator skill が per-task pane に Phase 0-9 自走を委譲したときに本 Skill に従って動作する。
ローカル Claude Code 内でポーリング起動し、gh CLI で merged/closed PR を取得 → 未処理 PR があれば pr-retrospective を起動、Renovate ラベル PR があれば dependency-upgrade を起動するハーネスループ起点 Skill。3 系統の起動経路 (起動時 + CronCreate + ScheduleWakeup) に対応するため .claude/locks/pr-poller.lock で排他制御し、 pending-fetch 項目の再走査と harness-meta 自動起動の閾値判定も担当する。
アーキテクチャ決定の ADR 起票を担当する Skill。起票基準判定 + 採番 + テンプレ起草 + 関連 ADR 双方向リンク + INDEX 更新を実施。起票基準を満たさない決定は rules / epic decisions.md / learning への記録を推奨し、本 Skill は起草で完了する。 議論 / approve / merge は人間レビューに委ねる (Skill は merge を実行しない)。
外部研究 / ベストプラクティス駆動の改善ループを担う Skill。手動起動のみで cron 不採用 (ADR 0026)。 WebSearch / WebFetch + Context7 MCP でホワイトリスト外部情報源を取得し、既存ハーネス (`.claude/skills/` / `.claude/rules/` / `docs/`) と gap 分析を行い、 `docs/harness/evolution-proposals/YYYY-MM-DD.md` を出力する。重要案は `example-skills:skill-creator` 経由で Skill scaffold / Plan / EPIC 起票し、人間 approve を必須とする。
pr-retrospective が生成した learning ファイル群の「🤖 ハーネス改善提案」セクションを 入力に、harness-meta-criteria の採用 / 見送り / 撤去 3 分岐で判定し、採用は改修 PR (rule / Skill / ADR 起票) 起票、見送りは元 learning に「📝 harness-meta フィードバック」 追記、撤去は status removed → 物理削除の 2 段階 PR で実行する内部 KPT 駆動 Skill。 dry-run 必須条件該当時は dry-run 先行。
[archived A3-14 / 2026-05-18] Phase A の A1〜A10 を進める汎用 Skill。専用 Skill 群が A3 で出揃ったため archived 化。新規呼び出し禁止。本ファイルは履歴参照用。
| name | pr-retrospective |
| description | 対象 PR の diff / comments / reviews / CI ログ / Skill 実行ログ / 三層指標差分 / 関連 Plan・Epic を収集し、docs/harness/learnings/YYYY-MM-DD-pr-<n>.md を日本語の構造化フォーマットで生成する。 harness/learnings-batch-YYYY-WW ブランチに集約し、週次 (or 件数到達時) に PR として起票する。 |
| status | active |
| phase | A3 |
| last_updated | "2026-05-18T00:00:00.000Z" |
| related_plan | docs/harness/plan.md §4.4 / §5.3 / §5.4.5 / R-12 |
| related_rules | [".claude/rules/retrospective-format.md",".claude/rules/pii.md",".claude/rules/secrets.md",".claude/rules/skill-authoring.md",".claude/rules/template-language.md",".claude/rules/docs-structure.md",".claude/rules/pr-poller.md",".claude/rules/harness-meta-criteria.md",".claude/rules/branch-naming.md",".claude/rules/pr-template.md",".claude/rules/merge-readiness.md"] |
| related_adrs | ["ADR-0017","ADR-0018","ADR-0026","ADR-0027"] |
5 行以内 summary: マージ済 PR 1 件を入力に diff / comments / reviews / CI ログ / Skill 実行 ログ / 三層指標差分 / 関連 Plan・Epic を収集し、
docs/harness/learnings/YYYY-MM-DD-pr-<n>.mdをretrospective-format.mdの日本語構造化フォーマットで生成する Retrospection Skill。 生成した learning はharness/learnings-batch-YYYY-WWブランチに集約 push し、件数閾値到達 または週次で PR 起票判定する。PR コメント post は禁止、SoT は learning ファイル (§4.4)。
docs/harness/learnings/YYYY-MM-DD-pr-<n>.md) を retrospective-format.md §本文構造 の日本語見出しで生成gh CLI と JetBrains MCP / Read で収集[rule] / [skill] / [template] / [remove] プレフィックス + チェックボックス [ ] で起票し、後段の harness-meta が parse する正規構造を満たすharness-meta が後追記する場所を確保 (R-12 learning ロスト対策).claude/rules/pii.md / .claude/rules/secrets.md の正規表現で PII / Secrets を [REDACTED-*] に置換harness/learnings-batch-YYYY-WW (ISO 週番号) に commit + push、件数閾値到達 (デフォルト 10 件) または週次 (ISO 週終端、日曜深夜) で PR 起票pr-retrospective は 1 PR 単位、harness-meta は複数 PR 集約と責務を分離する (.claude/rules/skill-authoring.md Gotchas §Skill 間の責務 overlap 回避)。merge 自体は人間 approve 後に orchestrator pane が代行 (R-15)、本 Skill は merge を行わない。
pr-poller / 人間 / orchestrator から渡される):
#NNN、明示時): 単一 PR の learning 生成gh pr list --state merged --search "merged:>=<last-run-timestamp>" --json number,mergedAt,labels,headRefName,baseRefName,title,url で未処理 PR を列挙harness/learnings-batch-YYYY-WW を明示指定、未指定なら現在の ISO 週番号で自動算出gh CLI で取得、.claude/rules/mcp-usage.md §gh CLI 優位):
gh pr view <N> --json number,title,body,state,author,mergedAt,mergeCommit,baseRefName,headRefName,labels,additions,deletions,changedFiles,commits,urlgh pr diff <N> (差分本文)gh pr view <N> --comments (comments / reviews / review comments)gh run list --branch <head> --json conclusion,name,url,databaseId,headSha + gh run view <id> --log-failed (CI ログ、失敗時のみ抜粋).claude/locks/*.lock / docs/harness/dry-runs/*.md / 関連 Skill が PR description / commit body に残したログ抜粋@Spec / PITest の出力ファイル (現時点は N/A 必須、空欄禁止、retrospective-format.md §📊 指標)PLAN-NNN / EPIC-NNN / ADR-NNNN を抽出して該当ファイルを Readdocs/harness/learnings/INDEX.md を Read して同 PR の learning が既存なら skip (idempotent).claude/locks/pr-retrospective.lock (A4 で本格化): 排他制御 placeholder、本 PR 時点では pr-poller 側の lock に乗るdocs/harness/learnings/YYYY-MM-DD-pr-<n>.md (1 PR = 1 ファイル):
retrospective-format.md §frontmatter 必須キー準拠 (block 形式、id / title / type: learning / status: draft / related_pr / related_plan / related_epic / generated_at / generator)> **5 行以内 summary**: ... で必置## ✅ Keep / ## ⚠️ Problem / ## 🚀 Try / ## 📊 指標 / ## 🤖 ハーネス改善提案 / ## 📝 harness-meta フィードバック (空でも見出し残す)retrospective-format.md §本文構造 例)docs/harness/learnings/INDEX.md 追記: 索引行を 1 行追加 (PR 番号 / タイトル / 生成日 / 関連 Plan / Epic)harness/learnings-batch-YYYY-WW ブランチへの commit + push:
docs(harness): PR #NNN レトロ起票)git switch -c harness/learnings-batch-YYYY-WW で新規作成 (.claude/rules/branch-naming.md §harness/)gh pr create --base master --template harness.md --title "docs(harness): learnings batch YYYY-WW (N 件)" --body-file /tmp/pr-body-retro-batch-YYYY-WW-<timestamp>.md で Draft 起票 → Ready 化は gh pr ready <PR#>retrospective-format.md §PR コメント post の禁止)、gh pr merge は実行禁止 (R-15、merge は orchestrator 代行)gh pr list --state merged --search "merged:>=<last>") を確定gh pr view <N> --json ... で PR メタ (title / body / mergedAt / mergeCommit / baseRefName / headRefName / labels / additions / deletions / changedFiles / commits / url) を取得PLAN-NNN / EPIC-NNN / ADR-NNNN ID を抽出 (regex (PLAN|EPIC)-\d{3} / ADR-\d{4})docs/harness/learnings/INDEX.md を Read して同 PR の learning ファイル既存有無を確認 (related_pr: NNN の行があるか grep)YYYY-MM-DD 形式に変換、ファイル名 docs/harness/learnings/YYYY-MM-DD-pr-<n>.md を確定gh pr diff <N> で差分本文を取得 (additions / deletions / changedFiles 合計を blockquote 用に保持)gh pr view <N> --comments で comments / reviews / review comments を JSON 取得code-reviewer Skill が post した Coordinator コメントがあれば 8 aspect (該当時は 4 aspect) の Critical / High 件数 + binary checklist 通過率を抽出{aspect: spec-conformance, severity: Critical, location: file:line, note: ...})gh run list --branch <headRefName> --json conclusion,name,url,databaseId,headSha,workflowName で対象 PR の CI run を取得gh run view <id> --log-failed でログ抜粋 (成功 run はメタ情報のみ)、失敗箇所を 10-30 行抜粋.claude/locks/*.lock (pr-poller / harness-meta 等の起動履歴、A4 以降)docs/harness/dry-runs/*.md (該当 PR で dry-run 実施有)N/A 明示@Spec (Spec coverage): 同上retrospective-format.md §📊 指標 表に整形N/Agit fetch origin master を実行することで stale base 問題を回避できた」)retrospective-format.md §各セクションの規約)consensus: spec-conformance + architecture、Phase 2 で抽出した構造化リストを使用).claude/rules/ / .claude/skills/ / templates) で改善可能な項目 を抽出し、4 プレフィックスで起票:
[rule]: .claude/rules/*.md の新規追加 / 改修 (例「[rule] pii.md の redaction 表に GIS avatar URL パターンを追加」)[skill]: .claude/skills/*/SKILL.md の新規追加 / 改修 (例「[skill] code-reviewer Phase 4 fix loop 上限を 3 → 2 に絞る dry-run」)[template]: テンプレート Markdown 改修 (例「[template] docs/plans/template.md の §Open Questions セクションに保留理由列を追加」)[remove]: 未使用 rule / dormant Skill の撤去候補 (例「[remove] .claude/rules/foo.md は 3 ヶ月未参照 + dangling 参照ゼロ」)[ ] で起票 (harness-meta 採用時に [x] + 採用先 PR リンク追記、retrospective-format.md §🤖 ハーネス改善提案)harness-meta-criteria.md) を併記推奨 (例: [rule] ... (採用判定基準 1: 複数 PR で反復))[mcp] プレフィックス (MCP server 追加 / 設定変更) は harness-evolution 側で扱う領域だが、PR 内で発生したら本セクションに記載しておく (harness-meta-criteria.md §[mcp] プレフィックス受信ルール で振り分け).claude/rules/pii.md §redaction 強制 表): メールアドレス (@example.com 以外) / GIS avatar URL / sub claim (21 桁数字) / IPv4 / IPv6 を [REDACTED-EMAIL] / [REDACTED-AVATAR-URL] / [REDACTED-UID] / [REDACTED-IP] に置換.claude/rules/secrets.md §redaction 強制 表): API key / token / password (regex (?i)(api[-_]?key|token|secret|password)\s*[:=]\s*["']?\S+) / AWS key (AKIA[0-9A-Z]{16}) / GitHub PAT (ghp_[0-9A-Za-z]{36}) / Bearer JWT (eyJ...) を [REDACTED-SECRET] / [REDACTED-AWS-KEY] / [REDACTED-GH-PAT] / [REDACTED-JWT] に置換sub claim 値 / 環境変数値 / アクセストークンが混入していないか確認retrospective-format.md §redaction チェックポイント) を逐次評価:
[ ] frontmatter 配列が block 形式[ ] 5 行 summary が冒頭 blockquote (>) に存在[ ] 「📝 harness-meta フィードバック」セクションは空でも見出しを残すdocs/harness/learnings/YYYY-MM-DD-pr-<n>.md を Write で生成docs/harness/learnings/INDEX.md に索引行を追記 (Edit)date +%G-W%V、例: 2026-W21) → harness/learnings-batch-YYYY-WWgit fetch origin && git switch -c harness/learnings-batch-YYYY-WW origin/master、既存なら git switch harness/learnings-batch-YYYY-WW && git pull --rebase origin <branch> で同期docs(harness): PR #NNN レトロ起票 で commit、.claude/rules/commit-message.md 準拠) → git push origin harness/learnings-batch-YYYY-WWharness-meta-criteria.md §pr-poller 起動閾値と連動)/tmp/pr-body-retro-batch-YYYY-WW-<timestamp>.md に書き出し (heredoc 直送禁止、.claude/rules/orchestrator-criteria.md §プロンプト送信プロトコル と整合)gh pr create --base master --draft --template harness.md --title "docs(harness): learnings batch YYYY-WW (N 件)" --body-file <path> で Draft 起票code-reviewer Skill を 2 aspect (spec-conformance / architecture、harness 系のため test-quality / performance / security / visual-regression / design-tokens skip 妥当) で並列起動、Critical 0 / High 0 まで fix loop (上限 3)gh pr ready <PR#> で Ready 化、merge は人間 approve 後に orchestrator pane が代行 (R-15、本 Skill は gh pr merge 禁止)retrospective-format.md §PR コメント post の禁止 / §4.4 で明示禁止。Single Source of Truth は learning ファイル。code-reviewer の Coordinator コメントは別運用 (merge 前)、retrospective は merge 後 に生成.claude/rules/pii.md / secrets.md の正規表現を全て適用し、検出時は [REDACTED-*] プレースホルダに置換。1 段階だけでは GIS avatar URL や sub claim の漏れリスクが残るharness/learnings-batch-YYYY-WW を更新すると push 競合が起こる。Phase 7 で git pull --rebase origin <branch> を必ず通し、競合検出時は (a) 別 learning なら rebase 続行、(b) 同 learning なら idempotent skip。.claude/locks/pr-retrospective.lock 排他制御は A4 で本格化harness-meta は複数 PR 集約と責務分離。本 Skill は「🤖 ハーネス改善提案」を起票するのみで採用 / 見送り判定は行わない。[x] 化と feedback 追記は harness-meta の責務。本 Skill が直接 rule / Skill / template を改修する PR を起票してはいけない採用 / 見送り / 保留) を必ず残す (retrospective-format.md §フィードバックフォーマット)N/A 明示 (空欄禁止)。A6 完了前は Lint 違反数も N/A。空欄にすると機械検証 (A6 で Gradle カスタムタスク) で rejectgenerated_at で明示) / 差分ファイル数 + 行数 / commits 数 (初回 + fix loop) を必ず記載 (retrospective-format.md §本文構造 例)。欠落は A1 レトロ Problem 級generator 値: A3 本格化前 (手動代替実行) は pr-retrospective (skeleton、本ペインで手動代替実行)、A3 本格化後 (本 Skill 駆動) は pr-retrospective Skill (vX.Y.Z) で明示 (retrospective-format.md §frontmatter)--force フラグ追加予定).claude/rules/harness-meta-criteria.md §classifier ブロック対応 迂回パターン辞典)。中立表現「orchestrator 委任で R-15 代替」「out-of-band approval」等に書き換えるpr-poller 自動起動 / 手動「PR #N のレトロ起票」/ orchestrator pane 委譲。本 PR 時点では pr-poller が skeleton (A4 で本格化) のため、当面は手動起動が主、pr-poller 完了後に自動経路が enable されるpr-poller 統合 + .claude/locks/pr-retrospective.lock 排他制御 + 三層指標自動取得は A4 / A6 / A7 で順次本格化。本 PR 時点では「手動起動 + 三層指標 N/A + lock placeholder」前提docs/harness/plan.md §4.4 (learning ファイル SoT) / §5.3 (Skill 責務一覧) / §5.4.5 (ハーネス改善ループ 6 フェーズ Retrospection) / R-12 (learning ロスト対策).claude/rules/retrospective-format.md (learning ファイル正規構造、4 プレフィックス、フィードバック追記フォーマット、redaction チェックポイント).claude/rules/pii.md (PII redaction 強制、Skill 出力前チェックリスト).claude/rules/secrets.md (Secrets redaction 強制、*.pem / *.key 等の禁止).claude/rules/skill-authoring.md (example-skills:skill-creator 経由規約、100-point rubric).claude/rules/template-language.md (日本語化方針、固定セクション名例外).claude/rules/docs-structure.md (frontmatter block 形式 / 5 行 summary / 命名規約).claude/rules/pr-poller.md (起動経路 + 閾値連携、3 系統対応).claude/rules/harness-meta-criteria.md (採用 / 見送り / 撤去判定基準、[mcp] プレフィックス受信ルール、pr-poller 起動閾値).claude/rules/branch-naming.md (harness/<purpose> / harness/learnings-batch-YYYY-WW).claude/rules/pr-template.md (harness.md テンプレ運用).claude/rules/merge-readiness.md (R-15 3 条件、merge は orchestrator 代行).claude/skills/pr-poller/SKILL.md (起動経路 + 閾値連携).claude/skills/harness-meta/SKILL.md (本 Skill が入力を渡す対向、R-12 共有、📝 フィードバック追記の主体).claude/skills/code-reviewer/SKILL.md (Coordinator コメントを Phase 2 で参照、本 Skill が batch PR 起票時にも呼び出す).claude/skills/orchestrator/SKILL.md (R-15 代行 merge、手動代替実行時の起動元).claude/skills/implementation-workflow/SKILL.md (Phase 8 で本 Skill を起動するバトンタッチ元)docs/harness/learnings/{INDEX,flaky-tests}.md (補助ファイル)