rhdh-pr-review について
GitHub のプルリクエストを取得、コード分析し、必要に応じてレビューを投稿するスキルです。レビューの前提条件や head SHA による検証を定め、外部への書き込みには別途承認を求めます。
主な機能
- 01分析前に PR コンテキストを取得
- 02分析のみと投稿のワークフローを分岐
- 03/code-review と Adversarial レビューを必須化
- 04投稿先を head SHA に固定
- 05外部書き込み前に mutation-gate を使用
- 06段階間で構造化結果を引き継ぎ
活用シーン
- 01PR をレビューして検証済みの指摘を投稿
- 02レビューを投稿せず PR を分析
- 03レビュー対象の head SHA に照らして指摘を確認
- 04レビューと書き込みの結果を報告
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ redhat-developer/ rhdh-skills --skill rhdh-pr-reviewインストール後、Claude Code で/rhdh-pr-reviewを入力して読み込まれたか確認します。
同梱ファイル
SKILL.md と一緒にインストールされる参考資料やスクリプト。
agents/openai.yamlreferences/review-perspectives.mdscripts/fetch_pr_context.pyworkflows/fetch-github.mdpost-to-github.mdreview-code.md詳細
RHDH Pull Request Review
Forge との入出力は境界に限定します。fetch は PR コンテキストを生成し、分析はそのコンテキストとチェックアウト済みのコードのみを対象に行い、投稿では head SHA に照らしてすでに検証済みの指摘のみを送信します。
結果に応じたルート
| 結果 | ワークフローの順序 |
|---|---|
| コードレビューして投稿 | workflows/fetch-github.md → workflows/review-code.md → workflows/post-to-github.md |
| 分析のみ | workflows/fetch-github.md → workflows/review-code.md。編集済みのドラフトができた時点で終了します |
PR の URL または番号だけが指定された場合は、コードレビューして投稿するルートが既定です。
レビューの不変条件
- 分析のみの場合も含め、ドラフトレビューのすべての経路で
/code-reviewが必要です。見つからない場合は停止し、code-reviewが見つからないことを伝え、/setup-rhdh-skills installを案内してください。代わりに、ローカルで 2 軸のレビューを行ってはいけません。 /code-reviewの実行では、毎回 Adversarial もディスパッチします。チーム、worktree、ドラフトの各ステップについてはworkflows/review-code.mdを参照してください。- 投稿操作を行うことを伝える前に、編集済みのドラフト全体を提示してください。投稿の明示的な依頼は投稿の意図を示すものであり、特定の書き込み内容に対する承認ではありません。
書き込みゲート
取得と分析は読み取り専用です。GitHub レビューの投稿は外部への書き込みです。名前付きスキル mutation-gate を呼び出し、ここでゲートを改めて説明するのではなく、そのスキルが定めるゲートに従ってください。ローカルの git worktree の作成または削除は、このゲートの対象ではありません。
レビュー操作の対象によって head SHA が固定されます。以前の指摘に対する確認は、書き込みの承認にはなりません。それぞれの結果について、レビュー URL、実施した検証、未完了の復旧対応を報告してください。
各ステージで引き継ぐ情報
各ステージの結果は会話内で次のステージに引き継ぎます。フィールド名は、生成元で一度だけ定義されています。
| ステージ | 結果 | 定義元 |
|---|---|---|
| 取得 | PR コンテキスト:repository、changeRequest、files、diff、linkedIssues、jiraKeys、existingComments、existingReviews、ciStatus、specSource | workflows/fetch-github.md |
| 分析 | レビュードラフト:changeRequest、summary、verdict、findings、edited、worktreePath | workflows/review-code.md |
完了条件
レポートにレビュー対象の head SHA が記載され、/code-review の Standards レポートと Spec レポートが提示され、編集済みのドラフトが提示されていれば完了です。投稿ルートでは、承認された各書き込みの結果とその対象も提示してください。