用途:Open Code Review(OCR)的委派模式技能,用于让宿主智能体自行完成 AI 代码审查,OCR 侧不调用 LLM,只提供确定性工程能力,包括文件过滤、规则解析和 diff 准备。
工作流程:第一步 ocr delegate preview --format json,支持 --from/--to 范围模式、-c/--commit 单提交模式,以及默认工作区模式;输出模式、ref 元数据、可审查文件列表与排除文件及原因。第二步 ocr delegate rule --format json <path...>,传入上一步的可审查路径,输出按规则内容分组的规则。第三步用 git --no-pager 获取 diff,命令统一加 --no-ext-diff --no-textconv --no-color;范围模式用 merge_base..to,提交模式用 git show,工作区模式对已跟踪文件用 git diff HEAD,未跟踪新文件直接 cat 读取。大 diff 可用 --output 写入仓库外绝对路径文件,Git 退出码为 0 后分块读取再删除。
审查与输出:逐文件建立清单,以(路径、状态)为标识,结合规则组与上下文审查,逐项标记已审或跳过并给出原因。评论字段包括 path、content 必填,start_line、end_line、category、severity 可选;category 取 bug、security、performance、maintainability、test、style、documentation、other,severity 取 critical、high、medium、low。汇总需给出 total_files、reviewed_files、skipped_files 与 coverage_rate,按严重级别分组,避免误报。用户要求“review and fix”时可直接修 High/Critical,描述需人工处理的 Medium,跳过非琐碎的 Low。
常用参数:--repo 指定仓库根目录,--rule 指定自定义 rule.json,--exclude 逗号分隔排除模式,-b/--background 与 -B/--background-file 提供业务背景(文件优先),-f/--format 支持 text 与 json。
限制与注意:OCR 侧不需要 LLM;工作目录需为 Git 仓库;工作区模式需直接读取未跟踪文件;覆盖率必须完整,不得静默遗漏文件。--background-file 原始文件不超过 1 MiB、清洗后内容不超过 8000 字符,超限需摘要后重试,不要静默截断。--format 需 ocr v1.9.0 及以上,若报 unknown flag: --format,可去掉该参数改用文本输出完成本次委派,不要解析文本为 JSON。可通过 npm install -g @alibaba-group/open-code-review 升级 CLI。