메뉴
pr-retrospective が生成した learning ファイル群の「🤖 ハーネス改善提案」セクションを 入力に、harness-meta-criteria の採用 / 見送り / 撤去 3 分岐で判定し、採用は改修 PR (rule / Skill / ADR 起票) 起票、見送りは元 learning に「📝 harness-meta フィードバック」 追記、撤去は status removed → 物理削除の 2 段階 PR で実行する内部 KPT 駆動 Skill。 dry-run 必須条件該当時は dry-run 先行。
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 を必須とする。
[archived A3-14 / 2026-05-18] Phase A の A1〜A10 を進める汎用 Skill。専用 Skill 群が A3 で出揃ったため archived 化。新規呼び出し禁止。本ファイルは履歴参照用。
対象 PR の diff / comments / reviews / CI ログ / Skill 実行ログ / 三層指標差分 / 関連 Plan・Epic を収集し、docs/harness/learnings/YYYY-MM-DD-pr-<n>.md を日本語の構造化フォーマットで生成する。 harness/learnings-batch-YYYY-WW ブランチに集約し、週次 (or 件数到達時) に PR として起票する。
| name | harness-meta |
| description | pr-retrospective が生成した learning ファイル群の「🤖 ハーネス改善提案」セクションを 入力に、harness-meta-criteria の採用 / 見送り / 撤去 3 分岐で判定し、採用は改修 PR (rule / Skill / ADR 起票) 起票、見送りは元 learning に「📝 harness-meta フィードバック」 追記、撤去は status removed → 物理削除の 2 段階 PR で実行する内部 KPT 駆動 Skill。 dry-run 必須条件該当時は dry-run 先行。 |
| status | active |
| phase | A3 |
| last_updated | "2026-05-19T00:00:00.000Z" |
| related_plan | docs/harness/plan.md §4.4 / §5.4.5 / R-29 / R-30 / R-31 |
| related_rules | [".claude/rules/harness-meta-criteria.md",".claude/rules/retrospective-format.md",".claude/rules/skill-authoring.md",".claude/rules/pr-poller.md",".claude/rules/harness-evolution.md",".claude/rules/template-language.md",".claude/rules/branch-naming.md",".claude/rules/pr-template.md",".claude/rules/merge-readiness.md",".claude/rules/pii.md",".claude/rules/secrets.md"] |
| related_adrs | ["ADR-0017","ADR-0024","ADR-0025","ADR-0026","ADR-0027","ADR-0028"] |
5 行以内 summary: pr-retrospective が生成した learning ファイルの「🤖 ハーネス改善提案」 セクション (
[rule]/[skill]/[template]/[remove]プレフィックス) を集約 parse し、 harness-meta-criteria の採用 1-5 / 見送り 1-5 / 撤去 3 項目で 3 分岐する内部 KPT 駆動 Skill。 採用は改修 PR 起票 (harness/<purpose>+harness.mdテンプレ)、見送りは元 learning に feedback 追記、 撤去は 2 段階運用 (status removed → cooldown 1 週間 → 物理削除)。dry-run 必須条件該当時は先行。
docs/harness/learnings/YYYY-MM-DD-pr-<n>.md の「🤖 ハーネス改善提案」セクションを横断走査し、4 プレフィックス ([rule] / [skill] / [template] / [remove]) に分類.claude/rules/harness-meta-criteria.md §採用判定基準 / §見送り判定基準 / §撤去判定基準 を SoT として参照、各候補に基準該当箇所 (1〜5) を明示docs/harness/dry-runs/YYYY-MM-DD-pr-<n>.md を先行起票harness/<purpose> ブランチ + harness.md テンプレで起票、Skill 改修は example-skills:skill-creator 経由、rule / ADR / template は直接編集 PRretrospective-format.md §フィードバックフォーマットに準拠removed + rules-index.md 注記) → 1 週間 / 1 PR サイクル cooldown → Step 2 (物理削除) の順で起票、1 段階運用は禁止docs/harness/evolution-proposals/*.md で既出なら見送り (R-31、harness-meta 優先 / harness-evolution 重複見送り)pr-retrospective は 1 PR 単位の learning 生成、本 Skill は 複数 PR 集約 の改修駆動と責務を分離する (.claude/rules/skill-authoring.md Gotchas §Skill 間の責務 overlap 回避)。
pr-poller / orchestrator pane から渡される): 集約対象 learning の範囲 (例: 「直近 7 日分」「PR #148〜#152」「learnings-batch-2026-W21」) / 採用基準 5 (orchestrator 明示) で扱う候補リストdocs/harness/learnings/YYYY-MM-DD-pr-<n>.md 群: retrospective-format.md §本文構造の「🤖 ハーネス改善提案」セクションを parse 対象とするdocs/harness/learnings/INDEX.md: 走査範囲を絞る索引、harness/learnings-batch-YYYY-WW ブランチ集約状況の確認に使用docs/harness/evolution-proposals/*.md: harness-evolution との重複検証 (R-31).claude/rules/harness-meta-criteria.md (採用 / 見送り / 撤去判定基準、dry-run 必須条件、3 軸定量評価 SoT、即時消化 vs 持ち越し基準、分割粒度、classifier 迂回辞典).claude/rules/retrospective-format.md (learning ファイル正規構造、4 プレフィックス、フィードバック追記フォーマット).claude/rules/skill-authoring.md (example-skills:skill-creator 経由規約、100-point rubric).claude/rules/pr-poller.md (起動経路 + 閾値連携).claude/rules/harness-evolution.md (重複検証相手)docs/harness/dry-runs/golden-set.md (基準シナリオ集 SoT、副作用軸検証用 K=5 シナリオ + iterative 更新フロー、ADR-0028 で導入)pr-poller の閾値到達通知 (自動起動経路): 未処理 learning 10 件超過 / 前回実行から 7 日経過 (harness-meta-criteria.md §pr-poller 起動閾値).claude/locks/harness-meta.lock: 排他制御 (二重起動防止、A4 で本格化、本 PR 時点では placeholder)harness/<purpose> ブランチ + harness.md テンプレ + feat(harness) / docs(harness) commit。1 PR で 1〜5 ファイルを目安、複数 rule 改修は Epic に昇格 (harness-meta-criteria.md §改修 PR の品質基準)status を removed に変更 + rules-index.md の対応行を「撤去予定」と注記する PRrules-index.md 行削除 + 関連 ADR / decisions.md への削除理由記録 PRdocs/harness/dry-runs/YYYY-MM-DD-pr-<n>.md (テンプレ: docs/harness/dry-runs/template.md、索引: docs/harness/dry-runs/INDEX.md)、before/after AI 出力差分 + 判定理由を記録docs/harness/learnings/YYYY-MM-DD-pr-<n>.md 末尾の「📝 harness-meta フィードバック」3 表 (YYYY-MM-DD <PR ID> で消化 (採用) / YYYY-MM-DD <PR ID> で見送り (後続フェーズへ) / YYYY-MM-DD <PR ID> で保留 (要再評価)) に「提案 → 採用先 PR / 見送り理由 / 保留理由」行を追記。1 PR 内で「提案 → 結果」往復ログを完結 (R-12 learning ロスト対策)harness-meta-criteria.md §改修 PR の品質基準).claude/rules/merge-readiness.md)docs/harness/learnings/ 配下を起動 prompt の集約範囲 (例: 直近 7 日 / 特定 batch ブランチ / 明示 PR 番号リスト) で絞り込み## 🤖 ハーネス改善提案 セクションを正規表現で抽出 (retrospective-format.md §本文構造、4 プレフィックス [rule] / [skill] / [template] / [remove] + チェックボックス [ ])[x] 済 (前回 harness-meta で処理済) は skip、[ ] 未処理のみを candidate 集合に追加{learning ファイル, 提案テキスト, プレフィックス, consensus 表記 (該当時), 採用判定基準該当箇所 (該当時)} の構造化リストに整形docs/harness/evolution-proposals/*.md に類似提案が存在するか grep ベースで照合 (R-31)[REDACTED-*] 漏れがないか .claude/rules/pii.md / .claude/rules/secrets.md の regex で再検証.claude/rules/harness-meta-criteria.md §採用判定基準 1-5 を順に評価:
[remove] プレフィックス候補は §撤去判定基準 3 項目全てを評価 (3 ヶ月未参照 / dangling 参照ゼロ / orchestrator 事前承認)、1 項目でも欠落なら見送りに格下げ[mcp] プレフィックスを受信した場合は §[mcp] プレフィックス受信ルール (採用判定 → ADR 起票判定 → harness-evolution 重複検証) に従う{candidate, 判定 (採用/見送り/撤去), 該当基準 ID, 判定理由 (1-2 行)} に整形.claude/rules/harness-meta-criteria.md §dry-run 必須条件 (PR #141 レトロ Try) を順に評価:
.claude/skills/<new-name>/SKILL.md 配置)## 3 軸定量評価 セクションは「dry-run skip 理由」のみ記入、スコア表 / 入力記録 / 9 通り指針 #N は空欄).claude/rules/harness-meta-criteria.md §dry-run 3 軸定量評価):
⚠️ Problem から M 件抽出 → 新版 dry-run subagent に投入 → Problem 再発率 算出 (≤ 30% で ✅)docs/harness/dry-runs/golden-set.md の 基準シナリオ集 (初期 K=5、iterative 拡張) を新版 subagent に投入 → 各シナリオを「改善 / 変化なし / 退化」3 値判定 → 退化率 + 新規 Critical findings 件数を集計 (退化率 ≤ 20% + Critical ≤ 1 件で ✅)harness/golden-set-update-YYYY-MM-DD ブランチ)docs/harness/dry-runs/YYYY-MM-DD-pr-NNN.md、テンプレ: docs/harness/dry-runs/template.md): 4 ブロック入力記録 + 3 軸スコア表 + シナリオ別判定 + 9 通り組合せ別レビュー指針 #N 該当を記録 (verdict ラベルは廃止、ADR-0028 §決定 2)## 3 軸定量評価 セクション (.github/PULL_REQUEST_TEMPLATE/harness.md) に 3 軸スコア表 + dry-run 入力記録の要約 + dry-run ファイルリンク + 9 通り指針 #N 該当の推奨アクション を必須転載📝 harness-meta フィードバック §保留 (要再評価) 表に記録、別案検討harness/<purpose> 形式 (.claude/rules/branch-naming.md 準拠、例: harness/feedback-batch-2026-W21 / harness/rule-tighten-mcp-usage)[rule] 採用: 対象 .claude/rules/<name>.md を直接編集 + rules-index.md 状態欄 / lookup table を必要に応じて更新[skill] 採用: example-skills:skill-creator 経由で SKILL.md 改修 (skill-authoring.md §起動方法 §100-point rubric、直接編集も禁止ではないが drift 防止のため経由推奨)[template] 採用: 対象 template (docs/plans/template.md / docs/epics/template/*.md / .github/PULL_REQUEST_TEMPLATE/*.md / 等) を直接編集[remove] 採用: Phase 6 (2 段階運用) に委譲.claude/rules/adr.md §起票基準で ADR 起票判定、2 項目以上充足なら ADR 起票 + 関連 rule / decisions.md 双方向リンク更新.github/PULL_REQUEST_TEMPLATE/harness.md を --template harness.md で指定 (.claude/rules/pr-template.md)--body-file /tmp/pr-body-harness-meta-<purpose>-<timestamp>.md で渡す (heredoc 直送禁止、orchestrator-criteria.md §プロンプト送信プロトコル §採用判断ライン に整合)harness-meta-criteria.md §即時消化 vs 持ち越し 判断基準)harness-meta-criteria.md §分割粒度)code-reviewer Skill を 4 aspect (spec-conformance / architecture / security / code-quality) で並列起動 (harness 改修は test-quality / performance / visual-regression / design-tokens skip 妥当、code-reviewer-aspects.md §動的選択ルール)gh pr ready <PR#>、merge は人間 approve 後に orchestrator pane が代行 (R-15)docs/harness/learnings/YYYY-MM-DD-pr-<n>.md) を Edit ツールで開く## 📝 harness-meta フィードバック セクションに以下を追記 (retrospective-format.md §フィードバックフォーマット準拠):
### YYYY-MM-DD PR #<NNN> で消化 (採用) 表に「提案テキスト | PR # での消化内容」行を追加### YYYY-MM-DD PR #<NNN> で見送り (後続フェーズへ) 表に「提案テキスト | 見送り理由 / 移行先フェーズ」行を追加### YYYY-MM-DD PR #<NNN> で保留 (要再評価) 表に「提案テキスト | 保留理由」行を追加[x] に更新 + 採用先 PR リンクを併記 (retrospective-format.md §🤖 ハーネス改善提案 §各項目は採用時に [x] + リンク追記).claude/rules/harness-meta-criteria.md §撤去判定基準 3 項目全て (3 ヶ月未参照 / dangling 参照ゼロ / orchestrator 事前承認) を 再確認 (Phase 2 で評価済でも Phase 6 直前で再 grep / orchestrator 再確認)harness/remove-step1-<target>-<timestamp> (例: harness/remove-step1-skill-foo-20260518)status を removed に変更 + rules-index.md の対応行に「撤去予定 (Step 2 で物理削除予定、cooldown YYYY-MM-DD まで)」注記harness.md、PR body の「採用根拠」セクションに撤去判定 3 項目の充足根拠 + cooldown 期限 (1 週間後または 1 PR サイクル後の早い方) を明記harness/remove-step2-<target>-<timestamp>rules-index.md 行削除 + 関連 ADR / docs/epics/<id>/decisions.md (該当時) に削除理由を記録 + 他 rule / Skill / docs の参照リンク張り替えharness.md、PR body に Step 1 PR リンク + cooldown 経過確認 + dangling 参照ゼロ grep 結果を明記harness-meta-criteria.md §撤去判定基準 末尾)code-reviewer Skill の architecture aspect に「dangling 参照ゼロ」「他 rule / Skill / docs への影響評価」を必ず通す[ ] rule 全文書き換え該当なし: 改修対象 rule 本文の改変率 X% (< 50%)) ことで skip 漏れを防ぐ.claude/rules/merge-readiness.md 3 条件: CI green + Critical 0 + 人間 approve)。本 Skill が gh pr merge --merge を直接実行することは禁止### YYYY-MM-DD PR #<NNN> の date prefix で時系列順を保つ。古い feedback を削除しない (履歴保持)、ただし表が 30 行を超える場合は別 docs (docs/harness/learnings/<id>-feedback-archive.md 等) へ分割を検討 (将来追加、A4 / A6 完了後の運用熟成時)removed) → 1 週間 cooldown → Step 2 (物理削除) の 2 段階運用を 厳守。1 段階運用 (status 変更 + 物理削除を同一 PR で統合) は .claude/rules/harness-meta-criteria.md §撤去判定基準 末尾で明示禁止、誤削除時のロールバックコストが高すぎる。撤去判定基準 3 項目 (3 ヶ月未参照 / dangling 参照ゼロ / orchestrator 事前承認) は Phase 2 で評価済でも Phase 6 直前で 再 grep + orchestrator 再確認docs/harness/evolution-proposals/*.md で既出の場合は harness-meta 側で見送り、harness-evolution 側で扱う。逆方向 (harness-meta 採用案を harness-evolution が再提案) も同様に harness-evolution 側で見送り、内部 KPT (実体験ベース) を優先する.claude/rules/harness-meta-criteria.md §classifier ブロック対応 迂回パターン辞典)。中立表現「都度承認の手間削減」「orchestrator 委任で R-15 代替」「out-of-band approval」等に書き換える.claude/rules/pii.md / .claude/rules/secrets.md redaction 表)。Phase 1 の抽出時 + Phase 4 / 5 の出力前の 2 回 redaction check[mcp] プレフィックスは harness-evolution 寄り: [mcp] (MCP server 追加 / 設定変更) は harness-evolution 固有プレフィックスだが harness-meta 側で受信されることがある (.claude/rules/harness-meta-criteria.md §[mcp] プレフィックス受信ルール)。採用時は ADR 起票判定 + .claude/mcp.json 改修、見送り時は「[mcp] 提案は harness-evolution 側で扱う」と移行先を明示[skill] 採用で SKILL.md を新規追加 / 改修する場合は example-skills:skill-creator 経由を推奨 (.claude/rules/skill-authoring.md Gotchas §既存 Skill 改修も skill-creator 経由を推奨)。直接編集禁止ではないが、100-point rubric 不合格 / フォーマット drift を防ぐため経由する。本 SKILL.md 自体も skill-creator 経由 or 経由準拠で起票pr-poller 統合 + .claude/locks/harness-meta.lock 排他制御 + Skill 駆動 dry-run サブエージェント並列) で完了する。A3 (本 PR) 時点では SKILL.md の SoT 化 + 手動代替実行 (orchestrator / 人間が本 SKILL.md を参照して手動実行) が前提。Phase 3 dry-run サブエージェント並列は A4 で本格化、本 PR 時点では手動代替可harness-meta-criteria.md / .claude/skills/harness-meta/SKILL.md) の改修も harness-meta フローで扱うとメタな自己改修ループになる。本 Skill / 本 rule の改修 PR は dry-run 必須条件 の「採用判定基準 / 撤去基準の改修」に該当するため必ず dry-run 先行、A4 / A6 完了後に運用熟成gh CLI 優位)example-skills:skill-creator 経由)docs/harness/plan.md §4.4 (learning ファイル SoT) / §5.4.5 (ハーネス改善ループ 6 フェーズ) / R-12 / R-29 / R-30 / R-31.claude/rules/harness-meta-criteria.md (採用 / 見送り / 撤去判定基準 SoT、dry-run 必須条件、即時消化 vs 持ち越し、分割粒度、classifier 迂回辞典、[mcp] プレフィックス受信ルール、pr-poller 起動閾値).claude/rules/retrospective-format.md (learning ファイル正規構造、4 プレフィックス、フィードバック追記フォーマット).claude/rules/skill-authoring.md (example-skills:skill-creator 経由規約、100-point rubric).claude/rules/pr-poller.md (起動経路 + 閾値連携).claude/rules/harness-evolution.md (重複検証相手、R-31).claude/rules/template-language.md (日本語化方針、固定セクション名例外).claude/rules/branch-naming.md (harness/<purpose> ブランチ命名).claude/rules/pr-template.md (harness.md テンプレ運用).claude/rules/merge-readiness.md (R-15 3 条件、merge は orchestrator 代行).claude/skills/pr-retrospective/SKILL.md (本 Skill が入力に取る learning ファイル生成元).claude/skills/pr-poller/SKILL.md (起動経路 + 閾値連携).claude/skills/harness-evolution/SKILL.md (重複検証相手).claude/skills/orchestrator/SKILL.md (本 Skill の手動代替実行時の起動元、R-15 代行 merge).claude/skills/roadmap-tracker/SKILL.md (改修 PR merge 後の roadmap mirror)example-skills:skill-creator (Skill 新規追加 / 改修時の経由先)