triage-pr

name	triage-pr
description	Triage a single GitHub PR by PR number. Check out the PR's branch, detect conflicts with the target branch via `gh pr status` (and label the PR with `cc-resolve-conflict` if any are found), generate and evaluate a fix plan via create-review-fix-plan, then take action (add cc-fix-onetime label if fixes are needed, or merge the PR if it's ready).
argument-hint	[pr-number]
hooks	{"Stop":[{"matcher":"","hooks":[{"type":"command","command":"docker compose down --volumes --remove-orphans"}]}]}

Triage PR

指定されたPR番号のPRに対して、コンフリクト検知から修正プランの評価、最終アクション（ラベル付与またはマージ）までを一貫して実行するスキルです。Instructionsに従って、PRの状態を確認し、適切なアクションを実行してください。

このスキルがやること・やらないこと

やること:

• ステップ1のコンフリクト検知（gh pr statusで確認し、コンフリクトがあればcc-resolve-conflictラベル付与のみで終了）
• ステップ2の修正プラン生成と評価（プランの分析・判定のみ）
• ステップ3のラベル付与（cc-fix-onetime）またはマージ

絶対にやらないこと:

• PRのコード修正・実装: 修正プランで「対応すべき」と判定された項目があっても、このスキル内では一切コードを変更しない。修正の実行はcc-fix-onetimeラベル付与後に別スキル（fix-review-pointなど）の責務
• コンフリクト解消の直接実行: rebase・コンフリクトファイルの編集・force-pushは行わない。検知したらcc-resolve-conflictラベルを付けて終了し、実際の解消は同ラベルをトリガーに別スキル（resolve-pr-conflict等）が担当する
• create-review-fix-planが返したプランの実行: プランは判定材料として読むだけで、ファイルを変更してはならない
• 新規コミットの作成: コミット・push・commit amendを行わない
• テスト追加・Lint修正・リファクタリング: 評価対象であっても、実行せずラベル付与にとどめる

ファイル編集ツール（Edit / Write / MultiEdit / NotebookEdit）はこのスキルの本文では一切呼び出さない。コードを触る作業はすべて「ラベル付与 → 別スキルが拾って実行」の流れに委ねる（ステップ1のcc-resolve-conflict、ステップ3パターンAのcc-fix-onetime）。

Instructions

!git fetch -p >/dev/null 2>&1 !gh pr checkout $ARGUMENTS >/dev/null 2>&1

実行モードの制約: サブエージェント・サブスキル・Bashをバックグラウンド実行しないこと

本スキルは claude-task-worker の triage-pr ワーカー（cc-triage-scope ラベル）から自動起動される想定。ワーカーはスキルプロセスの同期完了を根拠に cc-fix-onetime の付与やマージ、cc-triage-scope の除去を進めるため、バックグラウンド化すると判定未確定のまま cc-fix-onetime が付かず fix-review-point ワーカーへの引き継ぎが空振りしたり、マージ判定前にラベルが外れてPRが放置される状態壊れが起きる。内部処理はすべて同期実行で完結させること。

• Agent ツールは既定が run_in_background: true（バックグラウンド）。呼び出しごとに 必ず run_in_background: false を明示指定 し、フォアグラウンドで同期的に結果を受け取ってから次の処理に進む。指定を省略した場合はバックグラウンドで走り、本スキルが未完のまま終了する
• Skill / Bash ツール呼び出し時に run_in_background: true を指定しない（既定は同期）。特に create-review-fix-plan は、返却された修正プランの構造化サマリを受け取ってから判定・ラベル付与に進む
• シェルコマンド末尾に & を付けない。nohup / disown / setsid でのデタッチ、ScheduleWakeup 等での後回しも禁止
• 同一メッセージ内で複数の Agent / Skill を並列に投げるのは「並列実行」であって「バックグラウンド実行」ではないため許容される（各完了はその場で同期的に待つ）

実行内容

ステップ1: コンフリクト検知とラベル付与

gh pr status でPRのstatus（mergeable / コンフリクト有無）を取得する。

gh pr status

出力から #$ARGUMENTS の行を特定し、コンフリクト表示（"Conflict" / 衝突マーク等）があるかを判定する。gh pr status は現在のユーザーに関連するPR（作成者・レビュアー・assignee）のみ表示するため、対象PRが出力に含まれない場合はフォールバックとして以下で同じ情報を取得する。

gh pr view $ARGUMENTS --json mergeable -q .mergeable

返却値 MERGEABLE / CONFLICTING / UNKNOWN のうち CONFLICTING のときコンフリクトありと判定する。UNKNOWN の場合はGitHub側で判定中のため、数秒のスリープ後に1回だけリトライし、それでも UNKNOWN ならコンフリクトなし扱いで先に進む。

判定に応じて分岐する。

• コンフリクトあり（CONFLICTING）: cc-resolve-conflict ラベルを付与してこのスキルを終了する。ステップ2・ステップ3には進まない（コンフリクト解消前に修正プラン評価やマージを行っても意味がないため）

  gh pr edit $ARGUMENTS --add-label "cc-resolve-conflict"
  

• コンフリクトなし（MERGEABLE または UNKNOWN のリトライ後も判定不能）: ステップ2に進む

ステップ2: 修正プランの生成と評価（判定のみ・実行禁止）

create-review-fix-plan skillを用いてPRの修正プランを生成する。

重要: プランは「PRをマージ可能か」を判定する材料に過ぎない。プランに含まれるタスクをこのスキル内で実装してはならない。対応すべき項目があると判断したら コードに手を加えず ステップ3のパターンA（ラベル付与）へ進むこと。判定は内部的な思考にとどめ、ファイルの編集・コマンドの実行は行わない（参照のためのRead/Grepは許容）。

修正プランの各項目を以下の評価基準で分析し、対応要否を判定する。

対応すべき

• バグ・正確性の問題: ロジックエラー、不正な動作、欠落したエッジケース
• セキュリティ脆弱性: SQLインジェクション、XSS、認証バイパス、データ漏洩
• 破壊的変更: APIコントラクト違反、マイグレーションなしの後方互換性の破壊
• 型安全性の違反: TypeScript型エラー、ランタイム障害を引き起こす可能性のある安全でないキャスト
• テスト失敗: 壊れたテスト、新しいロジックに対する重要なテストカバレッジの欠如
• Lintエラー: パイプラインをブロックする違反
• データ整合性リスク: レースコンディション、重要なデータに対するバリデーションの欠如
• CIがオールグリーンになっていない: CIが失敗している

対応不要の可能性あり

• 純粋なスタイル好み: コードベースパターンと一貫性のあるフォーマット選択
• 主観的な命名提案: 既存の名前が明確で規約に従っている場合
• 過剰設計の提案: まだ必要のないコードに対する抽象化の追加
• スコープクリープ: PR範囲外の無関係なコードのリファクタリングや機能追加の提案
• 既存パターンとの冗長: 確立されたコードベース規約と矛盾する提案
• 非クリティカルパスへの指摘: 正確性や保守性に影響しない軽微な改善

ステップ3: 判定に基づくアクション

評価結果に基づき、以下の2パターンで判定し、必ずどちらかのアクションを実行する。判定のみで終了せず、コマンドの実行まで確実に行う。

パターンA: 修正が必要な場合

「対応すべき」と判定された項目が1つでもある場合、以下を実行してcc-fix-onetimeラベルを追加する。ラベル付与のみで終了し、コード修正は行わない。たとえ修正項目が明確で実装が容易に見えても、コード変更・コミット・pushを行ってはならない（実際の修正はcc-fix-onetimeラベルをトリガーに別スキルが担当する）。

gh pr edit $ARGUMENTS --add-label "cc-fix-onetime"

パターンB: マージ可能な場合

すべての項目が「対応不要」、または修正プランに項目がない場合、以下の手順でマージし、必要に応じて関連Issueを明示的にクローズする。判定だけで終了しないこと。

1. マージ前に、PRのbaseブランチとデフォルトブランチ名を取得する。

BASE_BRANCH=$(gh pr view $ARGUMENTS --json baseRefName -q .baseRefName)
DEFAULT_BRANCH=$(gh repo view --json defaultBranchRef -q .defaultBranchRef.name)

2. 必ず以下のコマンドを実行してマージする。

gh pr merge $ARGUMENTS --merge --delete-branch

マージコマンドが失敗した場合は、エラー内容を記録して報告し、以降の手順に進まない。

3. マージ成功後、BASE_BRANCH が DEFAULT_BRANCH と 一致しない（cc-epic-<N> のような非デフォルトブランチへのマージ）場合のみ、関連Issueを明示的にクローズする。GitHubのCloses #<issue番号>記法によるIssue自動クローズはPRがデフォルトブランチへマージされた場合にのみ発動し、非デフォルトブランチへのマージでは発動しないため、EpicフローでサブIssueが閉じられずEpic PR作成が止まるのを防ぐ必要がある。BASE_BRANCH が DEFAULT_BRANCH と一致する場合はGitHubが自動でクローズするため、この手順はスキップする。

   3-1. PR本文から関連Issueの番号を抽出する（「PRクローズ時のIssue連動Close」と同じ抽出コマンドを流用）。

   gh pr view $ARGUMENTS --json body --jq '.body' | grep -ioE '(close[sd]?|fix(e[sd])?|resolve[sd]?)[[:space:]]+#[0-9]+' | grep -oE '[0-9]+'
   

   3-2. 抽出したIssue番号それぞれに対して、完了クローズを実行する（複数ある場合は全て）。実装がEpicブランチに取り込まれた完了クローズのため、マージせずクローズする場合の--reason "not planned"とは異なり--reason completedを用いる。

   gh issue close <issue番号> --reason completed
   

   関連Issueが抽出できない場合は、その旨を報告に含めること。

意思決定の原則

1. 正確性はスタイルに優先: 機能的な正確性を常に優先する
2. レビュアーの意図を尊重: 具体的な提案を却下する場合でも、レビュアーが達成しようとしていることを理解する
3. コードベースの一貫性: プロジェクトで確立されたパターンを優先する
4. 実用主義: 各変更のコスト対効果を考慮する
5. 判断に迷う場合は対応すべきに寄せる

PRクローズ時のIssue連動Close

何かしらの理由でgh pr closeによりPRをクローズする場合、必ず関連するIssueも併せてCloseすること。GitHubはPRがマージされずにCloseされた場合、Closes #<issue番号>記法で紐づいたIssueを自動Closeしないため、明示的にCloseする必要がある。

手順:

1. PRのdescriptionから関連Issueの番号を取得する。

gh pr view $ARGUMENTS --json body --jq '.body' | grep -ioE '(close[sd]?|fix(e[sd])?|resolve[sd]?)[[:space:]]+#[0-9]+' | grep -oE '[0-9]+'

2. PRをCloseする。

gh pr close $ARGUMENTS --delete-branch

3. 取得したIssue番号それぞれに対してCloseを実行する（複数ある場合は全て）。

gh issue close <issue番号> --reason "not planned"

関連Issueが取得できない場合は、その旨を報告に含めること。

注意事項

• 作業は全てworktree上で行い、デフォルトブランチで作業は絶対に行わないこと
• ファイル編集などの作業を行う際は、pwdコマンドでworktree内部であることを確認してから行うこと
  • 作業ディレクトリ: !pwd
• cc-triage-scopeラベルがPRに付与されている場合、いかなる操作においても絶対に削除しないこと。gh pr editで--remove-labelを使用する際もcc-triage-scopeを対象に含めない
• このスキル本文では一切コードを変更しない（「やること・やらないこと」参照）。コンフリクト解消も修正実行もラベル経由で別スキルに委譲する

出力

処理結果として以下を報告する：

• 判定: コンフリクト検知（cc-resolve-conflictラベル付与） / パターンA（修正が必要・cc-fix-onetimeラベル付与） / パターンB（マージ済み。非デフォルトブランチへのマージ時は連動Closeした関連Issue番号も明記） / PRクローズ（関連IssueもClose） / エラー
• 理由: 判定の根拠（コンフリクト検知時はターゲットブランチ名、対応すべき項目の要約、マージ可能と判断した理由、非デフォルトブランチへのマージで--reason completedにより連動Closeした関連Issue番号、またはクローズ理由と連動Closeした関連Issue番号）