菜单
現在のローカルブランチを対象に、PR を作る前段階で AI レビューを行う thin orchestrator。`compose-review` (sub-agent) でレビュー本文を生成し、結果をチャットと markdown ファイルの両方に出力する。GitHub への投稿は行わない (post-pr-review / resolve-pr-threads は呼ばない)。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
PR 差分 or ローカルブランチ差分に対してレビュー本文 (body / event / comments[]) を生成する skill。`/pr-review-style-reference` slash command とプロジェクト指示ファイル (REVIEW.md / AGENTS.md / .claude/CLAUDE.md / CLAUDE.md) を読み込んでレビュー方針を決め、差分を読んで `post-pr-review` のスキーマに揃った JSON を **最終メッセージとして生テキストで** 返す。`run-pr-review` / `run-local-review` orchestrator から Task ツール (subagent_type=general-purpose) 経由で呼ばれる前提だが、Codex 等他 caller が直接 Skill ツール経由で呼んでも動作する。GitHub 投稿 / 過去スレッド resolve は行わない (read-only)。
期間内 merged PR のレビューコメント (AI 自動投稿 + 人間レビュー両方) を集約し、REVIEW.md に追記する価値のある指摘候補を proposals.md として出力する skill。取り込み判定の信号収集はスクリプト、最終的な採否分類とクラスタリングは AI が行う。本 skill は read-only で、REVIEW.md の編集や PR 作成は行わない。
PR レビュー結果を1回の API コールで1つの Review として GitHub に投稿する。複数のインライン指摘や総括コメントを含むレビューを投稿する場合は必ずこの skill を使うこと。`gh pr comment` や `gh pr review` を使った個別投稿は禁止。
PR レビュー全体を 1 コマンドで実行する thin orchestrator。PR 情報取得 / `compose-review` (sub-agent) でのレビュー本文生成 / `post-pr-review` でのレビュー投稿 / `resolve-pr-threads` での過去スレッド整理を順に呼ぶ。レビュー方針 (`/pr-review-style-reference` 読み込み / プロジェクト指示ファイル / 本文生成) は `compose-review` に委ねる。
ブラウザにインストール済みの本拡張機能を、GitHub 上の examples/ サンプル（basic / relative-assets / swagger / long-content）に対して実機で動作確認する。「動作確認して」「example を検証して」「プレビューが壊れてないか確認して」等のときに使う。
| name | run-local-review |
| description | 現在のローカルブランチを対象に、PR を作る前段階で AI レビューを行う thin orchestrator。`compose-review` (sub-agent) でレビュー本文を生成し、結果をチャットと markdown ファイルの両方に出力する。GitHub への投稿は行わない (post-pr-review / resolve-pr-threads は呼ばない)。 |
PR 作成前のローカルブランチに対して AI レビューを行うための thin orchestrator skill。レビュー方針は run-pr-review と揃え、出力先のみ「GitHub Review 投稿」ではなく「チャット表示 + markdown ファイル出力」に差し替えたバリエーション。
すべて省略可。
BASE_BRANCH: 比較対象のベースブランチ。compose-review にそのまま転送する。本 skill / compose-review は git fetch を走らせないため、ローカルのベースが古いと古い基準で diff が出る。最新で比較したい場合は caller 側で fetch するか、BASE_BRANCH=origin/main のようにリモート追跡参照を明示する。MAX_INLINE_COMMENTS: インライン指摘の総数上限。正の整数または unlimited。compose-review にそのまま転送する。OUTPUT_PATH: markdown 出力先パス。省略時は /tmp/run-local-review/{repo}/{timestamp}-{branch}.md (例: /tmp/run-local-review/skills/20260507T123456Z-claude-unique-review-filenames-tpIhG.md)。caller が明示パスを指定した場合は既存ファイルがあれば上書きする。プレースホルダの組み立て規則:
{repo}: git remote get-url origin の URL 末尾セグメント (.git を除く、取得失敗時は local){timestamp}: date -u +%Y%m%dT%H%M%SZ の出力{branch}: 現在ブランチ名の英数記号以外 (/ 等) を - に置換caller プロジェクト固有の方針は プロジェクト指示ファイル に置く運用。読み込み手順は compose-review skill 側に集約しているため、本 skill では扱わない。
compose-review (sub-agent) でレビュー本文を生成するdispatch 手順 (Task ツール / general-purpose / Skill ツール経由起動 / 生 JSON 返却) と戻り値 parse 判定の順序は compose-review skill の「caller 向け呼び出し契約」節 に従う (本 skill には再掲しない — 出力契約変更時の二重管理を避けるため)。本 skill 固有の点は以下。
pr-review プラグインの compose-review skill を呼び出すための subagent。
Skill ツール (`skill: "compose-review"`) で compose-review skill を起動し、
以下を引数として渡せ。skill の出力 (JSON) を最終メッセージとして verbatim に返せ。
最終メッセージは前置きも fenced ブロックもなしの生 JSON 1 つだけ。
MODE=local
BASE_BRANCH=<値>
MAX_INLINE_COMMENTS=<値>
非 success の 3 ケースはいずれも 擬似結果を組み立てて Step 2 (markdown 出力) を必ず実行 する (markdown ファイルは差分が空でも必ず生成する、という本 skill「守ること」の不変条件と整合させる)。擬似結果の共通部は comments=[] / base_branch="<unknown>" / diff_mode="none" / commit_count=0、body のみケースで差し替える:
body="compose-review 失敗 (parse error)。Task ツール戻り値を JSON として解釈できませんでした。" で Step 2 を実行し、Step 3 で同旨を caller に報告する。error あり → body="compose-review エラー: <error message>" で Step 2 を実行する。mode が "local" でない → body="compose-review モード不整合 (期待: local、実際: <mode>)。" で Step 2 を実行する。base_branch / diff_mode / commit_count / body / comments を Step 2 に渡し、Step 2 → Step 3 を順に必ず実行する。markdown ファイルが完全版、チャットは要約版で、両者は内容そのものは同じだが粒度が異なる (チャットへの全文ダンプは後続コンテキストを圧迫するため避ける)。
OUTPUT_PATH (省略時の組み立て規則は「入力」セクションの OUTPUT_PATH 説明を参照) に Write ツールで書き出す。
Write ツールは中間ディレクトリの自動作成を保証していないため、書き出し前に Bash ツールで mkdir -p "$(dirname "<OUTPUT_PATH>")" を実行して親ディレクトリを作成する (<OUTPUT_PATH> をダブルクォートで囲むことでスペース入りパスも安全に動く)。caller が明示パスを指定したケースも同様。
現在ブランチ名は git rev-parse --abbrev-ref HEAD で取得する (markdown 見出し用)。
スキーマ:
# Local AI Review: <branch> (vs <base_branch>)
- 生成日時: <ISO8601, UTC 秒精度。例: 2026-05-04T12:34:56Z>
- 差分モード: <commit / staged / worktree / none>
- 対象コミット: <ここは `diff_mode="commit"` のとき `<commit_count> 件 (<base_branch>..HEAD)` (例: `3 件 (main..HEAD)`)、それ以外 (`staged` / `worktree` / `none`) のとき `0 件 (コミット未作成)` と固定文字列で書き込む。機械的な置換ではなく `diff_mode` で分岐する>
- インライン指摘: <count> 件
## 総括
<compose-review の `body` を埋め込む。埋め込み時、`body` 内の **行頭 `^## ` を一律 `### ` に機械置換** して h2 を h3 に 1 段下げる (特定見出し名 `## 総合判断` / `## 指摘内訳` / `## 良かった点` への依存を避け、compose-review が将来見出し文言を変えても取りこぼさないため)。h3 以降 (`### ` 等) はそのまま。markdown 親見出し `## 総括` の下に同レベルの h2 が並んで階層が崩れるのを防ぐ変換であり、post-pr-review 投稿時は h2 のままが自然なので本変換は run-local-review でのみ行い、compose-review 自体は h2 を出力する契約のままにする。>
## インライン指摘
### 1. [must] path/to/file.ts:42
<comments[0].body>
### 2. [should] path/to/file.ts:50-55
<comments[1].body>
<以下、指摘ごとに繰り返し。指摘が無ければ「特に指摘なし」とだけ書く。>
各インライン指摘の見出しは ### <番号>. <body 先頭の重要度ラベル> <path>:<line> の形式で揃える。重要度ラベルは comments[i].body の先頭にある [must] / [should] / [nit] / [question] / [pre_existing] のいずれか (正規表現 ^\[[a-z_]+\] を body 冒頭にマッチさせて取り出す)。見出しに使ったラベル文字列は本文側からは削除せず body をそのまま掲載する (本文先頭でも重複表示で問題ない)。マッチしない場合は見出しからラベルを省く (### <番号>. <path>:<line>)。複数行範囲 (start_line / line 併用) のコメントは <path>:<start_line>-<line> で表記する。
heredoc や cat リダイレクトは使わず、必ず Write ツールで書く。Write ツールは既存ファイルがあると事前 Read 必須なため、OUTPUT_PATH が既存パスの可能性があれば Read を 1 回挟んでから Write する。
差分なし (diff_mode: "none") で compose-review から空 comments[] + 「対象差分なし」相当の body が返った場合でも、markdown のスキーマ (## 総括 / ## インライン指摘 見出し) は保持し、本文は compose-review が返した文言と「特に指摘なし」で埋める (見出し削除や空セクション化はしない)。
「生成日時」は実行時に date -u +%Y-%m-%dT%H:%M:%SZ で取得した UTC 秒精度の ISO8601 を採用する。date が利用できない環境では caller / 実行環境から提供される現在日時を使い、それも無ければ <unknown> と記載する。
チャットには以下を出力する。markdown ファイル全文をそのままダンプしない (指摘件数や差分が多いケースで後続会話のコンテキストを圧迫するため):
OUTPUT_PATH) を 1 行## 総括 セクションは全文表示[label] path:line — 1 行サマリ」のリスト形式に縮約 (本文詳細は markdown 側に任せる)詳細は <OUTPUT_PATH> を参照 を 1 行添える以下を簡潔に caller へ返す:
base_branch / diff_modecompose-review) は 必ず Task ツール (sub-agent) 経由で利用 する。本 skill 内でレビュー本文 (/pr-review-style-reference 読み込み / プロジェクト指示ファイル / 差分取得 / 本文生成) を再実装しない。post-pr-review / resolve-pr-threads skill は呼ばない。gh pr comment / gh pr review / gh api .../reviews も使わない。git fetch / git pull / git checkout / git reset 等、ワーキングツリーやローカル ref を書き換える操作はしない。読み取り専用 (git rev-parse / git remote get-url) のみ。compose-review 側の diff_mode に従う。