review
Skill16 starsChanged 2 days agoApache-2.0View on GitHub
PR に対し初回コードレビューを実施し、Approve / Changes Requested を投稿する。新規レビュー専用(修正確認は /pr-verify)。`dev` / `dev-thorough` / `dev-small` / `docs` workflow では `review-poll` の `BACK_FALLBACK` を受けた fallback step として呼び出される。
192 other projects use a version of this.
Adopted by
Most recently taken up by
- dzhng/skillstheir own version, first seen Nov 15, 2026
- muxy-app/muxytheir own version, first seen Nov 15, 2026
- macro-inc/macrotheir own version, first seen Nov 15, 2026
- igoroliveirg/claude-copytheir own version, first seen Nov 15, 2026
- yagizdo/quivertheir own version, first seen Nov 15, 2026
- markmhendrickson/neotomatheir own version, first seen Nov 15, 2026
Used with
Projects with it also use close-spec, daily-arxiv and 10 more.
Other files people use alongside this one.
Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
dzhngSkillclose-spec
When a spec under specs/<feature>/ is done shipping (a write-spec build, or any planned task that produced a spec), archive it to specs/done/ and rewrite it from a build-plan into a durable rationale — the why, the principles, the invariants — pointing back to the real code for the how. Use when implementation has landed and the plan no longer matches what shipped, or the user says a feature/spec is finished. Pairs with [write-spec](../write-spec/SKILL.md) (the plan this closes) and [review](../review/SKILL.md) (run before closing).
Also in 5 projects that use this
LambenthanSkilldaily-arxiv
每日从 arXiv 拉取新论文,过滤相关性,auto-ingest 高优先级论文,检测 SOTA 更新
Also in 5 projects that use this
dzhngSkilldesign-with-images
Explore UI and visual design with image generation, then iterate the real implementation against the user-selected concept. Use when brainstorming visual directions, offering mockup variants, or implementing an approved generated design; do not stop at the mockups or the first code approximation.
Also in 5 projects that use this
LambenthanSkillexp-eval
实验判决门:Review LLM 独立评判实验结果 → 4 种判决路径 → 自动更新 claims confidence、ideas status、graph edges
Also in 5 projects that use this
- +5 more from Lambenthan
- +3 more from dzhng
Other versions192 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 192
- garrytan/gstack★ 142ksame name
- ansible/ansible★ 71ksame name
- docling-project/docling★ 71ksame name
- traefik/traefik★ 66ksame name
- ClickHouse/ClickHouse★ 51ksame name
- temporalio/temporal★ 24ksame name
- ccch1mneyyy/dsh-Go★ 24ksame name
- tisfeng/Easydict★ 15ksame name
- juicedata/juicefs★ 15ksame name
- elie222/inbox-zero★ 13ksame name
182 more not listed
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository46 other files it gives its agents.
- AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- llms.txtllms.txt
- baseline-precheckSkill
- grill-meSkill
- herdr-kaji-launchSkill
- i-dev-final-checkSkill
- i-doc-final-checkSkill
- i-doc-fixSkill
- i-doc-reviewSkill
- i-doc-updateSkill
- i-doc-verifySkill
- incident-cycleSkill
- incident-fixSkill
- incident-investigateSkill
- incident-reportSkill
- incident-reviewSkill
- incident-verifySkill
- i-prSkill
- issue-closeSkill
- issue-createSkill
- issue-designSkill
- issue-fix-codeSkill
- issue-fix-designSkill
- issue-fix-readySkill
- issue-implementSkill
- issue-review-codeSkill
- issue-review-designSkill
- issue-review-readySkill
- issue-small-change-executeSkill
- issue-small-change-reviewSkill
- issue-startSkill
- issue-verify-codeSkill
- issue-verify-designSkill
- kaji-run-verifySkill
- pr-fixSkill
- pr-verifySkill
- releaseSkill
- release-starterSkill
- review-cycleSkill
- review-pollSkill
- review-starter-updateSkill
- run-watchedSkill
- series-createSkill
- update-starterSkill
- watch-triageSkill
The file
Files
Review
PR に対する 初回コードレビュー を実施するスキル。
設計書整合 / コード品質 / テスト証跡 / docs 更新を観点に評価し、kaji pr review で正式な
Approve / Changes Requested を投稿する。
重要: このスキルは 新規レビュー 専用。修正確認(
/pr-fix後の収束確認)は/pr-verifyを使うこと。両者を混同するとレビューサイクルが収束しなくなる。
いつ使うか
| タイミング | このスキル |
PR 作成直後の初回レビュー(単体起動 / review-poll の BACK_FALLBACK 後の fallback) | ✅ 必須 |
/pr-fix 後の修正確認 | ❌ /pr-verify を使う |
provider.type='github' で codex auto-review が走る環境 | ⚠️ workflow からは review-poll 経由で fallback 用途のみ |
provider.type='github' で codex auto-review が走らない環境(クレジット不足等) | ✅ review-poll → BACK_FALLBACK → 本 skill |
ワークフロー内の位置: i-pr → [PR 作成] → review → (pr-fix → pr-verify) → close
入力
ハーネス経由(コンテキスト変数)
| 変数 | 型 | 説明 |
issue_id | str | 正規化済み Issue ID |
issue_ref | str | 人間可読の Issue 参照 |
provider_type | str | github(現行唯一の provider)。Step 0 のガード判定に使用 |
step_id | str | 現在のステップ ID |
手動実行(スラッシュコマンド)
$ARGUMENTS = <issue_id>解決ルール
コンテキスト変数 issue_id が存在すればそちらを使用。なければ $ARGUMENTS の第 1 引数を
issue_id として使用。pr_id は Step 1 で kaji pr list --search から逆引きする
(pr-verify と同じ規約)。
前提知識の読み込み
以下のドキュメントを Read ツールで読み込んでから作業を開始すること。
- 開発ワークフロー:
docs/dev/development_workflow.md - テスト規約:
docs/dev/testing-convention.md - Python スタイル:
docs/reference/python/python-style.md
共通ルール
- _shared/report-unrelated-issues.md — 作業中に発見した無関係な問題の報告ルール
必須情報源 / 任意情報源
初回レビュー判定(Approve / Changes Requested)を出すために 必ず読まなければならない情報源:
| Step | 情報源 | 必須/任意 |
| Step 3a | kaji pr view [pr_id] — PR タイトル / 説明 / 状態 / linked Issue | 必須 |
| Step 3b | git diff [git_remote]/[default_branch]...HEAD — レビュー対象の差分本体 | 必須 |
| Step 3c | kaji pr review-comments [pr_id] — 既存 inline 指摘(重複指摘回避) | 必須 |
| Step 3d | kaji pr reviews [pr_id] — 過去の Approve / Changes Requested 履歴 | 任意 |
| Step 3e | kaji pr view [pr_id] --comments — 非 inline の議論経緯 | 任意 |
| Step 4 | make check — 品質ゲート(失敗時は Changes Requested 必至) | 必須 |
Step 3a / 3b / 3c / 4 を欠いた状態でのレビュー判定は許可しない。Step 3d / 3e は補助情報で、 レビュー対象の主たる入力ではない。
実行手順
Step 0: provider check
本 Skill は forge provider 専用。最初に provider_type を解決し、github 以外なら
以降のステップに進まず ABORT verdict を出力して終了 する。
provider_typeの解決(ハーネス注入 → 手動 fallback の優先順):PROVIDER_TYPE="${provider_type:-$(kaji config provider-type 2>/dev/null || true)}"判定と verdict 出力:
PROVIDER_TYPEがgithub→ Step 1 に進むPROVIDER_TYPEがそれ以外 → ABORT verdict(reason:review could not resolve provider_type、suggestion:Add [provider] to .kaji/config.toml.)を出力して終了
Step 1: PR の解決
Issue 番号から関連 PR を解決し、pr_id / pr_ref を確定する(pr-verify Step 1 と同型)。
PR_JSON=$(kaji pr list --search "[issue_id]" --json number,title,headRefName --jq '.[0]')
pr_id=$(echo "$PR_JSON" | jq -r '.number')
pr_ref="#${pr_id}"見つからない場合は Issue 本文の > **Branch**: 行からブランチ名を取得し:
PR_JSON=$(kaji pr list --head "[branch_name]" --json number,title --jq '.[0]')
pr_id=$(echo "$PR_JSON" | jq -r '.number')
pr_ref="#${pr_id}"両方の経路で PR が見つからない場合は ABORT verdict を出して終了する
(reason: no open PR found for issue [issue_ref]、
suggestion: Create a PR via /i-pr [issue_id] first.)。
Step 2: Worktree パスの解決
_shared/worktree-resolve.md の手順に従い、Worktree の絶対パスを取得。
以降の git diff / make check は [worktree_dir] で実行する。
Step 3: レビュー入力の収集
3a. PR 概要取得(必須)
kaji pr view [pr_id]タイトル / 説明 / 状態 / linked Issue を読み、PR の目的・スコープを把握する。
3b. 差分本体取得(必須)
cd [worktree_dir] && git fetch [git_remote] [default_branch]
cd [worktree_dir] && git diff [git_remote]/[default_branch]...HEADレビュー対象の全コード差分。仕様判定の主入力。差分が大きい場合は主要ファイルを 個別に確認する。
3c. 既存 inline 指摘の取得(必須)
kaji pr review-comments [pr_id]既に他のレビュアー / セッションが付けた inline 指摘を確認し、同じ指摘を重複して 書かない。新規レビューであっても他者の既存指摘を上書きしないこと。
3d. 既存 review state(任意)
kaji pr reviews [pr_id]過去の Approve / Changes Requested 履歴。逆転判定や重複 Approve を避けるための補助情報。
3e. top-level コメント(任意)
kaji pr view [pr_id] --comments非 inline の議論経緯。初回レビューでは差分 (3b) が情報の中心だが、議論で確定済みの 方針があれば従う。
Step 4: 品質チェック
cd [worktree_dir] && source .venv/bin/activate && make checkmake check が失敗した場合は、原則として Changes Requested。失敗内容をレビュー本文に
含める。
Step 5: レビュー観点評価
issue-review-code のレビュー観点を引き継ぐ:
- 設計書整合性:
draft/design/issue-[issue_id]-*.mdと差分が一致しているか - コード品質: 命名 / 責務分離 / 重複排除 / エラーハンドリング
- テスト証跡: 設計書「テスト戦略」で定義した検証が実施されたか
- docs 更新: 設計書「影響ドキュメント」の「あり」項目が更新されたか
- Scope 混在: 設計書のスコープ境界を逸脱した変更がないか
各観点について ✅ / ⚠️ / ❌ で判定し、❌ または ⚠️ がある項目を Must Fix / Should Fix として 列挙する。
設計書を持たない dev-small 経路: draft/design/issue-[issue_id]-*.md が存在せず、かつ
kaji issue resolve-verdict [issue_id] --step verify-change または --step review-change が
status: PASS を返す場合(harness 起動時は --current-verdict-path [verdict_path] を付けて marker
欠落時に同じ run の verdict.yaml へ fall back させる。手動実行でコンテキスト変数が無い場合は付けない)に限り、観点 1 / 3 / 4 / 5 の「設計書」を Issue 本文の決定事項・完了条件
(要件の正本)に読み替えて評価する(設計書の不在だけを理由に ❌ にしない)。この条件に該当しない場合は
上記のとおり設計書を前提とする。
Step 6: 正式 review 投稿
判定結果に応じて、kaji pr review で正式な review state を更新する。
Approve の場合
kaji pr review [pr_id] --approve --body-file - <<'EOF'
## 初回コードレビュー結果
### 参照した一次情報
| 情報源 | 確認結果 |
|--------|----------|
| `kaji pr view [pr_id]` | ✅ PR 目的 / スコープ確認 |
| `git diff [git_remote]/[default_branch]...HEAD` | ✅ 差分全量確認 |
| `kaji pr review-comments [pr_id]` | ✅ 既存 inline 指摘なし / 重複なし |
| `make check` | ✅ PASS |
### 観点評価
| 観点 | 判定 | 根拠 |
|------|------|------|
| 設計書整合 | ✅ | (引用) |
| コード品質 | ✅ | (引用) |
| テスト証跡 | ✅ | (引用) |
| docs 更新 | ✅ | (引用) |
| Scope 混在 | ✅ | (引用) |
### 判定
[x] Approve
[ ] Changes Requested
### 次のステップ
`/issue-close [issue_id]` で PR マージ & クリーンアップ。
EOFChanges Requested の場合
kaji pr review [pr_id] --request-changes --body-file - <<'EOF'
## 初回コードレビュー結果
### 参照した一次情報
| 情報源 | 確認結果 |
|--------|----------|
| `kaji pr view [pr_id]` | ✅ |
| `git diff [git_remote]/[default_branch]...HEAD` | ✅ |
| `kaji pr review-comments [pr_id]` | ✅ |
| `make check` | ✅ / ❌ |
### 観点評価
| 観点 | 判定 | 根拠 |
|------|------|------|
| 設計書整合 | ✅ / ⚠️ / ❌ | (引用) |
| コード品質 | ✅ / ⚠️ / ❌ | (引用) |
| テスト証跡 | ✅ / ⚠️ / ❌ | (引用) |
| docs 更新 | ✅ / ⚠️ / ❌ | (引用) |
| Scope 混在 | ✅ / ⚠️ / ❌ | (引用) |
### 指摘事項 (Must Fix)
- [ ] **point 1**: (具体的修正内容) — 根拠: (一次情報)
### 改善提案 (Should Fix)
- **point N**: (具体的修正内容)
### 判定
[ ] Approve
[x] Changes Requested
### 次のステップ
`/pr-fix [issue_id]` で修正対応をお願いします。
EOF規約遵守: auto-close hazard pattern(
Clos(e[sd]?|ing)/Fix(e[sd]|ing)?/Resolv(e[sd]?|ing)/Implement(s|ing|ed)?の直後#[0-9])を本文に書かない。 指摘参照は指摘 N/point N/Must Fix item Nで統一する (docs/dev/shared_skill_rules.md§ auto close keyword 回避規約)。
Step 7: 完了報告
## 初回コードレビュー完了
| 項目 | 値 |
|------|-----|
| PR | [pr_ref] |
| Issue | [issue_ref] |
| 判定 | Approve / Changes Requested |
### 次のステップ
- Approve: `/issue-close [issue_id]` で PR マージ & クリーンアップ
- Changes Requested: `/pr-fix [issue_id]` で修正対応Verdict 出力
実行完了後、以下の形式で verdict を stdout に 出力すること。
---VERDICT---
status: PASS
reason: |
PR の初回レビューを Approve として投稿
evidence: |
全観点 ✅、make check PASS、kaji pr review --approve 投稿済み
suggestion: |
/issue-close [issue_id] でマージへ
---END_VERDICT---status の選択基準
| status | 条件 |
| PASS | Approve を投稿 |
| RETRY | Changes Requested を投稿(pr-fix へ進む合図) |
| ABORT | Step 0 で provider mismatch / Step 1 で PR が見つからない等の致命的問題 |
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

