概念地圖

OpenCodeReview 的核心概念,一張圖看懂

OCR 做的事可以一句話講完:讀你的 Git diff,把變更檔交給 LLM Agent 產生精確逐行註解。關鍵在於——哪些工作交給「確定性工程」,哪些交給「Agent」,各取所長。下面從「輸入」到「輸出」拆解。

1. 輸入:Git 變更

OCR 讀 Git 的 diff(不是整個 repo),三種模式(CLI 參考):

2. 核心架構:確定性工程 × Agent 混合

這是 OCR 與一般「用自然語言 prompt 驅動的 review skill」最根本的差異(架構詳解):

3. 五重門檔案過濾

4. 四層規則鏈

規則告訴 agent 每個檔案要「關注什麼」(評審規則)。對每個檔案依序嘗試,第一個匹配生效:

5. 6 個內建工具

評審過程 LLM 可呼叫的工具(工具全解):

工具PlanMain用途
task_done「我完成了」——終止迴圈
code_comment發出一條帶行範圍 + 建議的評審註解
file_read讀變更後檔的一段
file_read_diff讀另一檔的 diff 確認跨檔關切
file_find依檔名關鍵字定位
code_search全 repo grep(git grep)

6. per-file 子 agent:plan + main

7. 輸出與產出

8. 委託模式(Delegation)

小結:OCR = 「保證不出錯的管線」×「會思考的 Agent」。你只要 ocr review,它負責選對檔案、套對規則、給出精確位置的評論——省 token、高 Precision、可除錯。

延伸閱讀:運作原理詳解 · 架構總覽 · 評審規則 · 6 個工具 · CLI 參考