整合

把 OCR 嵌入你的 coding agent —— Skill、Command、OpenCode、CI

整合方式一覽

模式誰呼叫 LLM?適用場景
Agent SkillOCRagent 呼叫 ocr review,OCR 驅動完整評審(修復前先問)
Command(Claude Code)OCRClaude Code 的斜線命令,OCR 驅動評審(預設自動修復)
OpenCode 工具OCR註冊 ocr_review / ocr_health 原生工具
委託模式宿主 AgentOCR 提供工程架構,宿主 Agent 用自己的 LLM

Agent Skill

把 OCR 註冊為可呼叫的 skill,讓 agent 框架以正確的參數、前置檢查與分級標準呼叫它。

npx skills add alibaba/open-code-review --skill open-code-review

SKILL.md 讓 agent 執行七步:前置檢查 → CLI 缺失自動安裝 → 無 LLM 停下詢問 → 提取業務脈絡 → 跑評審 → 分級(High/Medium/Low)→ 按需修復。完整 prompt 在 skills/open-code-review/SKILL.md

前置條件:你需要預先配好 LLM——skill 不會替你完成,會停下來詢問。

Command(Claude Code Plugin)

在 Claude Code 內端到端跑——評審 diff、分類發現、自動套用值得採納的修復。

/plugin marketplace add alibaba/open-code-review
/plugin install open-code-review@open-code-review

註冊 /open-code-review:review 斜線命令。與 Agent Skill 不同,此命令預設自動修復——適合「評審並清理」工作流。命令檔是帶 frontmatter 的純 markdown,其他支援 command 約定的 agent 也能用。

OpenCode 工具

mkdir -p ~/.config/opencode/plugins
curl -fsSL \
  https://raw.githubusercontent.com/alibaba/open-code-review/main/plugins/open-code-review/opencode/open-code-review.ts \
  -o ~/.config/opencode/plugins/open-code-review.ts

註冊原生工具:ocr_review(評審工作區 / commit / ref 範圍,回傳結構化 JSON)、ocr_health(顯示版本與 LLM 連通性),以及 /ocr-review/ocr-health 斜線命令。評審用 --audience agent + JSON 輸出、15 分鐘超時、10 MiB 輸出上限。

委託模式

讓宿主 Agent 用自己的 LLM 執行評審,OCR 只負責檔案篩選與規則解析——詳見 委託模式專頁

CI/CD

在每個 PR / MR 上跑 OCR。上游提供 GitHub Actions 與 GitLab CI 兩條現成管線——詳見 CI/CD 專頁

📖 教學解說:整合實戰

四種模式的決策樹

問三個問題:① OCR 的 LLM 要用誰的?② 要自動修復嗎?③ 用什麼 agent 框架?

  • 用自己的 API key + 不修復 + 任意框架 → Agent Skill
  • 用自己的 API key + 要修復 + Claude Code → Command
  • OCR 端無 LLM + 宿主有訂閱 → 委託模式
  • 需要原生工具整合 → OpenCode 工具

Agent Skill 的七步流程

SKILL.md 讓 agent 執行:① 前置檢查(Git? LLM?)→ ② CLI 缺失自動安裝 → ③ 無 LLM 停下詢問 → ④ 提取業務脈絡 → ⑤ 跑評審 → ⑥ 分級(High/Medium/Low)→ ⑦ 按需修復。關鍵:第 ⑦ 步是修復前先問,不像 Command 的預設自動修復。

OpenCode 工具的註冊機制

open-code-review.ts 放到 ~/.config/opencode/plugins/ 就自動註冊。它暴露 ocr_review(結構化 JSON)和 ocr_health(版本+連通性),以及 /ocr-review/ocr-health 斜線命令。審計用 --audience agent + JSON 輸出、15 分鐘超時、10 MiB 輸出上限。

練習 / 驗收清單

  • 能區分四種整合模式的「誰呼叫 LLM」
  • 能解釋 Agent Skill vs Command 的差異
  • 能描述 OpenCode 的 ocr_review / ocr_health 工具
  • 能選擇適合自己場景的整合模式
看完這頁你應該能說出:四種整合模式的「誰呼叫 LLM」、Agent Skill(修復前先問)vs Command(預設自動修復)的差異、以及 OpenCode 的 ocr_review / ocr_health 工具。

延伸閱讀:委託模式 · CI/CD · 快速開始