← 文件教學

委託模式（Delegation）

OCR 負責確定性工程，宿主 Agent 用自己的 LLM 做評審——不用設 API key

是什麼

委託模式把工作切開：OCR 負責確定性工程（檔案篩選、規則解析、排除邏輯），宿主 Agent 使用自身的 LLM 能力執行實際評審。OCR 端不需要配置 LLM。

何時使用

專為訂閱制 AI 編碼代理設計——Claude Code、Codex、Cursor、OpenCode、Qoder 等：

  1. 你的 AI 編碼代理用訂閱制，想複用已有額度做評審——不需額外 API key 或模型端點。
  2. 你只需要 OCR 的工程腳手架（檔案過濾、規則解析、排除邏輯），由宿主 Agent 負責所有 LLM 推理。
  3. 你在建自訂 Agent 管線，需要結構化輸入（檔案清單 + 規則）作為自身評審步驟的輸入。

前置條件

which ocr || npm install -g @alibaba-group/open-code-review

不需配置 LLM——委託模式在 OCR 端不呼叫任何 LLM。

安裝 Skill / Command

# Claude Code — Command
mkdir -p .claude/commands
curl -o .claude/commands/delegate-review.md \
  https://raw.githubusercontent.com/alibaba/open-code-review/main/plugins/open-code-review/claude-code/commands/delegate-review.md

# 任意 Agent — Skill
npx skills add alibaba/open-code-review --skill open-code-review-delegate

工作流程

Step 1 — Preview：確定評審範圍

ocr delegate preview                # 工作區
ocr delegate preview --from main --to feature
ocr delegate preview -c abc123      # 單次提交

輸出 mode（workspace/range/commit）、ref 元資料、可評審檔案清單（路徑、狀態、插入/刪除行數）、已排除檔案與原因。

Step 2 — 取得檔案規則

ocr delegate rule <path1> <path2> ...

依規則內容分組輸出——共享相同規則的檔案歸為一組，避免重複。

Step 3 — 取得 diff

# Range 模式
git diff <merge_base>..<to> -- <path>
# Commit 模式
git show <commit> -- <path>
# Workspace 模式
git diff HEAD -- <path>        # 已追蹤檔案
cat <path>                      # 新的未追蹤檔案

Step 4-5 — 評審與報告

子命令與旗標

命令用途
ocr delegate preview列出可評審檔案 + mode/ref 元資料
ocr delegate rule <path...>依內容分組解析評審規則

通用旗標：--from / --to / -c --commit / --repo / --rule / --exclude / -b --background / -B --background-file。

與其他整合方式對比

模式誰呼叫 LLM？適用場景
Agent SkillOCROCR 驅動完整評審
Command（Claude Code）OCR斜線命令，OCR 驅動，自動修復
委託模式宿主 AgentOCR 提供腳手架，Agent 驅動評審
📖 教學解說：委託模式深入

「誰負責什麼」的精確分工

委託模式的核心是職責分離：

  • OCR 負責：檔案篩選（五重門）、規則解析（四層鏈）、排除邏輯、結構化輸出——這些是確定性的，不需要 LLM。
  • 宿主 Agent 負責：所有 LLM 推理——讀 diff、依規則評審、產生評論。

OCR 端完全不呼叫 LLM，所以不需要 API key。這是與 Agent Skill / Command 的本質差異。

五步工作流的實務技巧

Step 1 ocr delegate preview 的輸出不只是清單——它包含 mode（workspace/range/commit）、merge_base、以及每個檔案的排除原因。先看排除原因再決定是否調整 --exclude。Step 2 ocr delegate rule 會自動按規則內容分組——共享相同規則的檔案只出現一次規則文本，避免重複。

與 Agent Skill 的選擇矩陣

選哪個？看兩個問題：① OCR 的 LLM 要用誰的？② 要自動修復嗎？

  • 用自己的 API key、不自動修復 → Agent Skill
  • 用自己的 API key、要自動修復 → Command（Claude Code）
  • 不想付 API key、宿主有訂閱 → 委託模式

練習 / 驗收清單

  • 能解釋委託模式「誰負責什麼」
  • 能描述五步工作流
  • 能區分委託模式與 Agent Skill / Command
  • 能設定 Claude Code 的 delegate-review 命令
看完這頁你應該能說出：委託模式「誰負責什麼」（OCR 工程 / Agent 推理）、為什麼訂閱制代理最適合、五步工作流、以及它與 Agent Skill / Command 的本質差異。

延伸閱讀：整合 · 快速開始 · 評審規則