ccpocket: Skill for Claude Code

Issue / PR Triage

番号からIssueまたはPRを判定し、対応判断に必要な最小限の調査を行う。

/triage 42
/triage #8
/triage #8 --force  # CodeRabbit障害や緊急時のメンテナ例外

原則

• PRでは必ずReadiness判定を最初に行う。
• ReadyでないPRのdiff、全コメント、コードベースを読まない。
• CodeRabbitの指摘を再レビューせず、製品判断・設計・高リスク箇所に集中する。
• 品質基準は CONTRIBUTING.md と .coderabbit.yaml。AI利用や文章の雰囲気ではなく、スコープ、実装の必要性、検証証拠で判断する。
• Codexフェーズでは投稿者へRequest Changesや修正ラリーを返さない。取り込めるならこちらで直し、費用対効果が悪ければ見送る。
• サブエージェントはMedium/High以上で独立した調査面がある場合だけ使う。
• --force時は、バイパスした条件と理由をレポートする。
• /triage <number>単独は判断を返す。取り込み・マージまで依頼済みなら修正、検証、マージまで進め、同じ許可を再確認しない。コメント投稿は明示依頼がある場合だけ行う。

Phase 0: 種別判定

共通のIssue APIで種別を判定する。APIエラーをPR扱いしない。PR判定前にコメントを取得しない。

gh api "repos/{owner}/{repo}/issues/<number>" \
  --jq '{number,title,body,labels:[.labels[].name],state,author:.user.login,isPR:(.pull_request != null)}'
# PRの場合だけ追加取得。bodyは再取得しない。
gh pr view <number> --json number,isDraft,changedFiles,additions,deletions,headRefOid,reviewDecision,statusCheckRollup

Issueなら「Issueフロー」、PRなら「PRフロー」へ進む。

PRフロー

Phase 1: Intake / Ready判定

このPhaseではPR本文、件数、ラベル、チェック状態だけを見る。ファイル内容や全diffは取得しない。

次を順番に確認する。

1. ファイル数
   • 1〜50: 通常
   • 51〜150: 関連Issue / Prompt Requestと分割不能理由を必須とする
   • 150超: NOT READY。Size以外のgateは判定せず、分割依頼とクローズだけを推奨して、ここで終了する
2. Draft: DraftならNOT READY
3. 品質保留: status:quality-holdがあればNOT READYとして終了。--forceやreview:overrideでも進めず、訂正後・誤検出時にメンテナがラベルを明示解除する。自動クローズやAI利用だけを理由とした拒否はしない。
4. レビュー基盤: 外部PRが.coderabbit.yaml、.github/workflows/**、PRテンプレート、PR Readiness checker、エージェント指示・設定を変更する場合、メンテナのreview:overrideがなければNOT READY
5. PR本文: テンプレートの必須欄とAuthor Checklistを確認する。10ファイル以下かつ低リスクでは、補足理由、対象外、分割計画、手動検証、platformはReadiness上の助言項目。OS依存の変更では対象環境の検証証拠を必須とする。
   • メンテナ自身の50ファイル以下のPRは、スコープ判断を本文に残せば別Issue不要。外部PRの非自明な変更と全投稿者の50ファイル超にはIssue / Prompt Requestでの合意を求める。
6. UI証拠
   • レイアウト・外観・操作変更: Before / Afterとdevice/platformを必須とする
   • 新規UI: BeforeはN/A — 理由を許可する
   • 文言のみ: 成功した flutter test ... のコマンド・結果と画像不要理由で代替可能
   • mobile UI領域の非表示変更: スクリーンショット不要理由を必須とする
7. PR Readiness status: 最新head commitで成功していることを確認する
8. CI: Test workflowが成功していることを確認する
9. CodeRabbit: 最新headのレビュー完了と明示的なApprove、未解決Request Changesなしを必須とする。Review completedや緑のstatusだけでは不足。
10. Ready label: ready-for-maintainer-reviewが付いていることを確認する