Code Review
Plugin

完整 code review 生態系統，以 Claude Code plugin 形式發布。提供 27 個 agent（含 Code Graph Analyzer、語言/框架專項 reviewer、Verification 等）、單一 /code-review command（自動偵測語言/框架並 dispatch 對應 agent）、以及 3 個自動觸發的安全 review skill。

核心特性

• 單一 /code-review，自動 dispatch — 一個 command 處理全部。依變更檔案副檔名自動偵測語言/框架（.py→python-reviewer、.go→go-reviewer，Django/FastAPI/Flutter 以內容輔助），自動加對應專項 agent，不需記每個語言的 command
• 27 個 Agent — 涵蓋 TypeScript、Python、Go、Rust、Java、Kotlin、Swift、C++、C#、F#、Django、FastAPI、Flutter、Database、Healthcare（PHI/HIPAA）、ML pipeline + Code Graph Analyzer + Verification + PR Walkthrough
• Code Graph + 八 Agent 並行 PR Review — PR 模式先執行 code-graph-analyzer（import deps + co-change risk），再並行啟動 8 通用 agent + 自動 dispatch 的語言 agent，confidence < 80% 自動過濾
• 多平台 PR Review — 自動偵測 GitHub（需 gh CLI）與 Bitbucket Cloud（需環境變數）
• Auto-trigger Skills — 根據任務上下文自動啟動安全掃描，無需手動呼叫

Installation setup

Plugin 安裝（推薦）

在 Claude Code 中執行 /plugin，搜尋 jurislm/code-review，點擊安裝後執行 /reload-plugins 套用。安裝後無需額外設定即可使用所有功能。

手動安裝

# Clone 專案
git clone https://github.com/jurislm/code-review.git

# 複製各元件到全域
cp commands/*.md ~/.claude/commands/
cp agents/*.md ~/.claude/agents/
cp -r skills/* ~/.claude/skills/

Bitbucket 環境變數

使用 Bitbucket Cloud PR review 前，需在 ~/.zshenv（或 ~/.bashrc）加入：

export BB_USERNAME="your-bitbucket-username"
export BB_APP_PASSWORD="your-app-password"

/code-review command

唯一的 review 入口。依參數自動切換本地 / GitHub PR / Bitbucket PR 模式，並依變更檔案自動偵測語言/框架、dispatch 對應的專項 reviewer agent — 不需為每個語言記不同 command。

/code-review [pr-number | pr-url | --from=<commit> | blank] [--focus=comments|tests|errors|types|code|simplify] [--profile=chill|assertive]

Local Review Mode

不傳參數時進入本地模式，對目前 uncommitted 變更跑與 PR 模式相同的完整並行 stack（code-graph 前置 + 八通用 agent + 自動 dispatch 語言 agent + verification），只是結果輸出到終端機、不發佈。傳 --from=<commit> 則只審查自該 commit 以來的變更。

/code-review

執行流程：GATHER（git diff 收集變更）→ Classify & Dispatch → Context & Code Graph → Parallel Review（8 通用 agent + 自動 dispatch 語言 agent）→ Verification（Phase 3.5）→ Aggregate → 依 CRITICAL → HIGH → MEDIUM → LOW 輸出 finding（不發佈）。

GitHub PR Review Mode

傳入 PR 號碼或 GitHub URL，需本機安裝 gh CLI 並已登入。

/code-review 123
/code-review https://github.com/owner/repo/pull/123

PR 模式為完整並行流程：Fetch → Classify & Dispatch → Context → Code Graph → Parallel Review（8 通用 agent + 自動 dispatch 的語言 agent）→ Verification（Phase 3.5）→ Aggregate → Decide → Report → Publish → Output。HIGH/CRITICAL finding 由 verification-reviewer 三道關卡二次確認後才納入。

語言 / 框架自動 Dispatch

兩種模式都會依變更檔案自動加上對應的專項 reviewer。偵測到才加，零匹配不浪費。

network-config-reviewer / healthcare-reviewer / mle-reviewer 為內容導向（無可靠副檔名），依上下文相關性加入。

--focus 過濾（PR 模式）

code-reviewer 與自動 dispatch 的語言 agent 永遠執行；--focus 只縮減通用 agent 子集：

Review Profile

控制 NITPICK 級別 finding 的顯示與否：

Bitbucket Cloud PR Review Mode

URL 含 bitbucket.org 或 remote origin 指向 Bitbucket 時自動切換，使用 REST API（需 BB_USERNAME、BB_APP_PASSWORD）。

/code-review 123
/code-review https://bitbucket.org/workspace/repo/pull-requests/123

PR 模式 — 並行 Stack & Verification /code-review

傳入 PR 號/URL 時，/code-review 先執行 code-graph-analyzer（import dependency + co-change 風險，結果快取於 .claude/code-graph/），再並行啟動 8 個通用 agent + 依變更檔案自動 dispatch 的語言/框架 agent，彙整去重並排序 finding。confidence < 80% 自動過濾。所有 HIGH / CRITICAL finding 須通過 verification-reviewer（Phase 3.5）二次確認後才納入報告。

/code-review 123
/code-review 123 --focus comments
/code-review 123 --focus tests
/code-review 123 --focus errors
/code-review 123 --profile=chill

通用並行 Agents（8 個）

另依變更檔案副檔名自動加入對應語言/框架 agent（見上方「語言 / 框架自動 Dispatch」）。

Phase 3.5 — Verification Pass

並行 agents 完成後，所有 HIGH 與 CRITICAL finding 自動送入 verification-reviewer 執行二次確認（三道關卡驗證）。CONFIRMED finding 及 UNCERTAIN（降為 MEDIUM）的 finding 均進入最終報告；若本 PR diff 已修復問題，以「FIXED IN THIS PR」verdict 移除（不受 CRITICAL 保護限制）；CRITICAL finding 不可被完全移除，最多降為 HIGH。

Walkthrough & Effort Score

PR 模式輸出前先產生 Walkthrough 摘要，包含逐檔變更說明與 PR 複雜度評分：

Agents — 通用主審 agents

Agents — 前置分析 agents

在並行 reviewer agents 啟動前，依序執行，建立跨檔案依賴圖，供所有下游 agent 使用。

Agents — PR 協作 agents

以下 agent 由 /code-review PR 模式並行調用，也可在對話中單獨使用。

Agents — 語言 / 框架專項 agents

通用語言（Sonnet）

框架專項（Sonnet）

特殊領域

Auto-trigger Skills skills

Skills 根據任務上下文自動啟動，無需手動呼叫。以下說明各 skill 的觸發條件與功能。

security-review

觸發條件：實作 authentication / authorization、處理 user input 或 file upload、建立 API endpoint、存取 secrets 或 credentials、實作付款功能、儲存或傳輸敏感資料、整合第三方 API。

提供完整的安全清單，涵蓋 secrets management、input validation、authentication、cryptography、dependency security 等，每項均附反例（FAIL）與正確做法（PASS）的程式碼範例。

security-scan

觸發條件：掃描 .claude/ 設定目錄的安全漏洞，包含 settings.json、hooks、MCP 設定、permission 設定等。

flutter-dart-code-review

觸發條件：Review Flutter / Dart 程式碼時啟動。

Library-agnostic 的 Flutter / Dart 完整 review 清單，涵蓋 widget 最佳實踐、各種 state management 模式（BLoC、Riverpod、Provider、GetX、MobX、Signals）、Dart idioms、效能、accessibility、安全性、clean architecture。

Severity Levels reference

HIGH / CRITICAL finding 三要素

每個 HIGH 或 CRITICAL finding 必須同時提供：

1. 精確行號 — 指出問題所在的具體位置
2. 具體失敗場景 — 描述這個問題在什麼情境下會造成實際問題
3. 現有 guard 為何不夠 — 說明目前的防護機制有何缺失

Decision Logic reference

PR review 完成後，依據 finding 嚴重程度自動產生決策：

Design Principles reference

1. 高信心原則 — 只報告 confidence > 80% 的問題。不確定的 finding 寧可略過，不製造雜訊。
2. 讀全文 — PR review 讀每個變更檔案的全文，而非只看 diff 行。context 是判斷問題的關鍵。
3. 零 finding 合法 — clean code 應該得到 APPROVE，不強行挑毛病。
4. HIGH / CRITICAL 三要素 — 精確行號 + 具體失敗場景 + 現有 guard 為何不夠，缺一不可。
5. False positive 過濾 — 明確排除 LLM reviewer 常見誤判，包含：magic number（有命名常數時）、fire-and-forget（設計如此時）、test fixture（測試資料不算 magic number）、未修改的程式碼（除非 CRITICAL 安全問題）。
6. Verification gate — /code-review PR 模式 Phase 3.5 由 verification-reviewer 對所有 HIGH / CRITICAL finding 執行三道關卡二次確認。CRITICAL finding 不可被完全移除，最多降為 HIGH。
7. NITPICK 分層 — 純風格偏好歸類為 NITPICK；--profile=chill 時略過 MEDIUM / LOW / NITPICK，--profile=assertive（預設）時顯示所有等級。

Contributing guide

新增 Agent

1. 在 agents/ 建立 <name>.md，frontmatter 至少包含 name、description、color、model、tools
2. 若是語言/框架專項，更新 commands/code-review.md 的「Language / Framework Auto-Dispatch」對照表，讓 /code-review 能依副檔名或內容特徵自動 dispatch
3. 若是 PR 模式並行協作 agent，更新 commands/code-review.md Phase 3 的通用 agent 列表
4. 更新 README.md 的 Agents 表格
5. 更新 docs/index.html 的 agent 列表與 stats 數字

修改 Command

本 repo 只有單一 command /code-review。所有 review 能力（本地 / GitHub PR / Bitbucket PR / 多 agent 並行 / verification / 語言自動 dispatch）都在 commands/code-review.md 內。新增能力時直接擴充該檔，不另建 command；若改動使用者可見行為，同步更新 README.md 與 docs/index.html。

Agent Frontmatter 格式

---
name: my-reviewer
description: <一句話說明觸發時機，Claude 靠這段決定何時使用>
tools: [Read, Grep, Glob, Bash]
model: sonnet          # sonnet | opus | haiku
color: blue            # green | red | blue | cyan | yellow | magenta
---

<agent prompt content>