What · 是什么
没有 LLM API Key 或想用宿主 Agent 模型：ocr delegate preview/rule 输出 spec，编码 Agent 自己审
面向没有 LLM API Key 或希望复用宿主 Agent（如 QCA、Claude Code）模型能力的场景
ocr delegate preview --format json 输出当前可审查的文件清单，供委托前确认范围
ocr delegate rule src/main.go src/handler.go 输出针对指定文件的审查规则，作为委托审查的标准
委托流程：编码 Agent 用 git diff 取到 diff → 按 delegate 给出的规则审查 → 输出结构化评论，OCR 只做规则与编排
QCA / Claude Code 等宿主 Agent 插件内嵌委托命令，让审查能力融入已有工作流
Why · 为什么
原理 · Principle
很多开发者没有直接可用的 LLM API Key，或已有宿主 Agent 的模型额度，重复付费不划算
把『规则生成』与『审查执行』分离：OCR 负责高质量规则，宿主 Agent 负责执行，各用所长
委托模式让 OCR 审查能力可嵌入任何 Agent 工作流，而不局限于 OCR 自身的模型连接
How · 怎么做
查看可审查清单：运行 ocr delegate preview --format json，确认当前仓库哪些文件可进入委托范围
获取审查规则：运行 ocr delegate rule src/main.go src/handler.go，得到针对这两个文件的规则文本
执行委托审查：在编码 Agent 内用 git diff 取 diff，将 delegate rule 输出的规则与 diff 一起交给宿主 Agent，令其按规则输出结构化评论
嵌入插件：在 QCA / Claude Code 插件中内嵌 ocr delegate 命令，实现『宿主模型 + OCR 规则』的混合审查流
案例 · Cases
| 代表性案例 |
|---|
| 无 Key 环境：只有宿主 Agent（如 Claude Code）模型可用，通过 delegate 获取规则后由宿主执行审查 |
| 规则标准化：团队把 delegate rule 输出固化为审查 checklist，所有成员与 Agent 共用同一套标准 |
| 插件集成：Claude Code 插件内调用 delegate 命令，审查能力一键获得 |
| 批量预审：preview 先圈定文件范围，避免委托审查覆盖无关文件 |
反模式 · Anti-patterns
- 把 delegate preview 当审查结果：preview 只是文件清单，真正的审查结论仍需 Agent 按规则执行
- 用宿主 Agent 直接审查而不取 delegate rule，等于放弃 OCR 沉淀的审查规则，质量回到裸模型水平
- 在委托链中丢失 git diff 上下文，宿主 Agent 只拿到文件全文而非变更，审查失去 diff 焦点
- 忽视输出结构化约束，宿主 Agent 返回自由文本评论，无法被下游解析与回贴
正反实例论证 · Evidence
正例 · Pro
preview 圈定委托范围
ocr delegate preview --format json# 返回可审查文件清单，确认范围后再委托委托前先看文件清单，避免覆盖无关文件，也让宿主 Agent 的审查范围可控。
反例 · Con
把 preview 输出当审查结果
ocr delegate preview --format json > result.json# 直接把文件清单当结论归档preview 只是文件清单而非审查结论，真正的审查仍需宿主 Agent 按规则执行，误用导致结果空洞。
正例 · Pro
delegate rule + git diff 喂给宿主 Agent
ocr delegate rule src/main.go src/handler.go > rules.mdgit diff > diff.patch# 宿主 Agent: 按 rules.md 审查 diff.patch，输出结构化评论OCR 负责高质量规则、宿主 Agent 负责执行，各用所长，无 LLM Key 也能获得规则化审查。
反例 · Con
宿主 Agent 裸审不取规则
git diff | claude -p "review this diff"放弃 delegate rule 等于放弃 OCR 沉淀的审查规则，审查质量回到裸模型水平，且评论格式不可控。
正例 · Pro
插件内嵌委托命令融入既有工作流
# QCA/Claude Code 插件中内嵌ocr delegate rule src/ > /tmp/ocr-rules.md# 宿主按规则审查并回贴审查能力嵌入已有宿主 Agent 工作流，团队成员共享同一套规则标准，无需各自申请 Key。
反例 · Con
委托链丢失 diff 上下文
# 只把文件全文交给宿主 Agent，无 git diffcat src/main.go | claude -p "review"宿主 Agent 拿到全文而非变更，审查失去 diff 焦点，评论大量命中历史代码而非本次改动。