AGENT SKILL
pr-review
PR を実装担当とは別のセッションでレビューし、最新コミットについての判定を記録する。「PR
- License 许可
- MIT
- 最近更新
- 2026-11-02
- Stars
- ★ 0
- Forks
- 1
01 前言 Front Matter
- name
- pr-review
- description
- PR を実装担当とは別のセッションでレビューし、最新コミットについての判定を記録する。「PR
03 SKILL.md 正文
pr-review — 別セッションでのレビューとマージ可否の技術判定
0. 始める前に(必ず)
- モデルの確認: このセッションが
claude-opus-5-5(Opus 5.5。.agent-kit/config.envのAGENT_REVIEW_MODEL)で動いているか確かめる。違う・分からないときは、別モデルでレビューせず、 「指定モデルで動いていない(現在: …)」と本人に報告して止まる。Claude Code では開始時に/model claude-opus-5-5。 セッションの最初から Opus 5.5 で動かし、途中で変えない。サブエージェントに読ませない(セッション全体の応答のモデルで判定され、 別のモデルが混ざると記録を拒否される)。 - 別セッションであること: この PR を実装した・確保したセッションではないこと。同じセッションならレビューしない。
- リポジトリ固有の制限(例:「main へ変更しない・マージしない」)は常に優先する。
1. レビューする SHA を固定して読む
python3 .agent-kit/bin/agent-gh review-start <PR番号> # 1行目にレビューする SHA が出る
git fetch origin <head のブランチ> <base のブランチ> && git checkout --detach <SHA>
- 固定した SHA の差分全体を読む(前回のレビュー結果を流用しない)。途中で PR が更新されても、読んだのはこの SHA。
- 関連 Issue の「期待する動作」「受入条件/確認方法」「依存」を読む。
2. 確認する観点
| 観点 | 見ること |
|---|---|
| 仕様への適合 | 受入条件を1つずつ満たしているか。範囲外の変更が混ざっていないか |
| 不具合 | 境界値・エラー時・並行実行・既存機能への影響 |
| 設計 | 責務の分離、命名、依存の向き。不要な抽象化・過剰な複雑さが無いか |
| 保守性 | 巨大な関数、重複、読みにくい分岐、コメントの不足/過剰 |
| テスト | 受入条件に対応するテストがあるか。失敗系のテスト。実際に走らせた結果 |
| ドキュメント | 使い方・設定・移行が変わったなら更新されているか |
| 安全 | 秘密の混入、入力検証、権限、削除・課金を伴う処理 |
できる範囲でテストを実際に走らせる(bash .agent-kit/bin/setup-deps.sh deps の後に)。走らせられないものは「未検証」として列挙する。
3. 記録する
指摘は重大度を付けて書く(重大=マージ前に必須、通常、提案)。本文を一時ファイルに書いてから:
python3 .agent-kit/bin/agent-gh review-post <PR番号> --sha <固定した SHA> --verdict pass|changes|blocked \
--blocking <未解決の重大な指摘の数> --body-file /tmp/review.md \
[--unverified "マージ前に必要な未検証事項"]
- 重大な指摘が残る、または必要な未検証事項があるときは
passにしない。 - 終了コード 6: レビュー中に PR が更新された。古い差分のレビューは投稿されていない。
review-startからやり直す。 - 終了コード 4: このセッションの応答に指定以外のモデルが混ざっている、または実装したセッション。本人に報告する。
- 記録には、モデルと独立性が「確認済み」か「未確認」かが入る(このセッションの transcript と hook の記録で確かめる。
自己申告は使わない)。未確認のままでは merge-gate は合格にしない。本人が確かめたら、本人の端末で
agent-gh human-confirm <PR> --sha <SHA> --items model,session --key <鍵> --principal <名前>(本人の鍵で署名)を実行してもらう(エージェントは実行しない)。
4. 判定を確認する
python3 .agent-kit/bin/agent-gh merge-gate <PR番号>
- 最新コミットのレビュー(モデル・独立性の確認を含む)・その SHA の必須 CI(ルールセット・ブランチ保護・
.agent-kit/ci-policy.json)・依存・draft/WIP・コンフリクトを確認し、「マージ可(技術判定)」か「マージ不可」と理由を出す。 - 「マージ可」でもマージ操作はしない。本人(またはマージ権限を与えられた実行者)に結果を伝える。
- 実装担当が修正したら、新しい head でもう一度 1〜4 をやる。
04 同仓库更多 Skills
vault-like
Synthetic test fixture for rejecting local-only skills.
★ 0
doc-skill
テスト用。本文だけのスキル。
★ 0
publish-polish
対外文章(PR のタイトル・本文、リリースノート、README など外に出す文書)を公開する前に、Gemini で推敲し、差分を確かめてから公開するときの手順。PR を作る・PR の本文やタイトルを変える・リリースを作る・README を含む push をするときに必ず使う。技術レビュー・承認・マージ判断には使わない。
★ 0
issue-task
GitHub の Issue を拾って実装するときの手順(担当確保・feature ブランチ・draft PR・依存の確認・テスト・レビュー依頼まで)。「Issue をやって」「#123 を実装」「次の Issue を拾って」で使う。レビューやマージ判定には使わない(それは pr-review)。
★ 0
cloud-worklog
クラウド実行(Codex Cloud / Claude Code on the web)で、実質的な作業をしたターンの終わりに作業ログを1件残して送る。コード・設定・文書を変えた、テストを走らせた、調査の結論が出た、失敗して止まった、のどれかなら使う。質問に答えただけのターンでは使わない。ローカルでは使わない(ローカルは project-log)。
★ 0