| name | pr-ci-medic |
| description | 自分が author の open PR で CI が失敗しているものを巡回し、失敗ログを読んで原因と修正を特定する
Loop Engineering の自律 PR/CI 修繕ループ skill。既定は diagnose（原因＋修正案を ledger に記録、コード push なし）、
opt-in で propose（git worktree で修正→ローカル検証→PR ブランチに push、merge はしない）。
merge しない・main に push しない・force-push しない・他人の PR に触れない、が不変の安全境界。
「PR の CI 直して」「failing CI を修正」「pr ci medic」「open PR の赤を見て」でトリガー。
注: merge やリリースは絶対に自動でしない。修繕の提案までが本 skill の責務。
|
| user-invocable | true |
pr-ci-medic — 自律 PR/CI 修繕ループ
自分の open PR の失敗 CI を巡回し、原因を診断して（propose モードなら）修正を PR ブランチに push する。
Addy Osmani「無人ループは無人でミスするループ」への答えとして、既定は push しない diagnose モード、
コード変更は明示 opt-in、merge は常に人手。
不変の安全境界（モードに関わらず常に守る）
- 対象は自分が author の open PR のみ（
gh pr list --author @me --state open）。他人の PR には一切触れない。
- allowlist リポのみ（既定:
kouzoh/zp-SHIN, shin1ohno/setup）。リスト外は対象外。
- merge しない。
gh pr merge は本 skill では決して実行しない。
- main/master に push しない。push 先は常に PR の既存ブランチのみ。
- force-push しない（
--force/-f 禁止）。共有ブランチの履歴を壊さない。
- secret/認証/署名関連の失敗は自動修正しない — 必ず diagnose に留めて人にフラグ（誤修正が漏洩・権限事故になる）。
- 曖昧な失敗は diagnose 止まり: 原因が複数候補に割れる、または修正がスコープ外に波及するなら push せず人にフラグ。
- 試行上限: 1 PR あたり 1 回の実行で最大 2 修正試行。green にならなければ diagnose にフォールバックして次へ（fix-loop を回し続けない）。
モード
- diagnose（既定）: 失敗ログを読み、原因＋具体的な修正案をローカル ledger に書く。コードは触らない・push しない。
- propose（opt-in）: 上記に加え、
git worktree で隔離して修正を適用し、そのリポのローカル検証（test/lint/build）を
通してから PR の既存ブランチに通常コミットを push する。merge は依然しない。
起動プロンプトに "propose mode" の語が無ければ diagnose。
手順
Step 0. 対象 PR 列挙
allowlist 各リポで gh pr list --repo <r> --author @me --state open --json number,headRefName,title。
各 PR の gh pr checks <n> --repo <r> で失敗チェックを抽出。失敗ゼロなら "no failing PRs — skipped" で STOP。
Step 1. 失敗ログ取得
失敗 PR ごとに gh run view <run-id> --repo <r> --log-failed（または失敗 job の log）で実エラーを読む。
Step 2. 原因診断
失敗の class を分類: lint/format / type / test / build / flaky(再実行で直る) / secret・auth(自動修正禁止) / config。
flaky 疑いは gh run rerun <id> --failed を 1 回だけ試す（コード変更でない）。
Step 3. 修正
- diagnose: ledger に
repo / PR# / 失敗 class / 根本原因 / 提案修正（具体的 diff か手順） を記録。push しない。
- propose:
git worktree add で隔離 → 修正適用 → ローカル検証（リポの test/lint コマンド。Rust は ~/.claude/rules/rust.md の 4 チェック、JS は build、cookbook は mitamae dry-run / bin/lint-cookbooks）→ 通れば PR ブランチに push → git worktree remove → gh pr checks <n> を再確認。検証が通らない修正は push しない。
Step 4. サマリ
処理した PR ごとに diagnosed / fixed-pushed / flaky-rerun / flagged-for-human / skipped を ledger に記録して報告。
検証ゲート（propose のみ）
push 前に必ずローカル検証を通す。「CI が言う修正」を当てずっぽうで push しない — ローカルで同じ失敗を
再現・解消してから push する（observe→fix→re-observe）。検証コマンドが不明なリポは propose せず diagnose に留める。
ループ化（substrate B / 半自動）
morning-triage から呼ばれるのが主。単独 cron も可だが、自律コード push は同席運用を推奨:
CronCreate(cron="23 9 * * 1-5", durable=true,
prompt="Follow ~/ManagedProjects/setup/cookbooks/claude-code/files/skills/pr-ci-medic/SKILL.md in DIAGNOSE mode for repos kouzoh/zp-SHIN and shin1ohno/setup. Report the ledger.")
propose モードを無人で回さない（CronCreate は 7 日失効・同席承認前提）。恒久・無人は本 skill の設計外
（自律コード push は人の監督下に置く）。検証後に default.rb 登録で /pr-ci-medic 化。
