把零散代码审查变成可追踪、自动收敛的修复闭环——高风险必修、重复告警降噪,直到交付真正干净的代码。
OCR Review Loop
功能概述
OCR Review Loop是一项面向实际任务的技能,主要用于基于 ocr CLI(alibaba/open-code-review)进行迭代式代码审查;核心流程:;
核心要点
- Step 0: 发现所有仓库;
- 多仓库项目必须覆盖每个子仓库,不遗漏:;
- 扫描项目根目录下所有含 .git 的子目录;
使用与执行
展示仓库清单给用户确认 ,等待确认后再继续;工作区无改动的仓库直接跳过,不浪费 LLM 调用;对每个仓库独立运行审查循环;输出最终报告时按仓库分组。它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
结果检查与注意事项
从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
OCR Review Loop
概述
基于 ocr CLI(alibaba/open-code-review)进行迭代式代码审查。核心流程:
审查 → 分类(高/中/低) → 修复高+中 → 抑制已修复项 → 再审查 → 直到干净
Step 0: 发现所有仓库
多仓库项目必须覆盖每个子仓库,不遗漏:
- 扫描项目根目录下所有含
.git的子目录 - 展示仓库清单给用户确认,等待确认后再继续
- 工作区无改动的仓库直接跳过,不浪费 LLM 调用
- 对每个仓库独立运行审查循环
- 输出最终报告时按仓库分组汇总
前置检查
which ocr || echo "NOT INSTALLED" ocr llm test
若未安装:npm install -g @alibaba-group/open-code-review
工作流程
Step 1: 收集业务上下文
分析审查目标(commit / 分支 / 工作区改动),提取简洁的业务上下文,通过 --background 传给 OCR。
Step 2: 运行审查
始终使用 --audience agent 抑制进度 UI:
ocr review --audience agent --background "业务上下文" [目标参数]
| 场景 | 命令 |
|---|---|
| 审查工作区改动 | ocr review --audience agent -b "context" |
| 审查分支对比 | ocr review --audience agent -b "context" --from main --to feature |
| 审查单个 commit | ocr review --audience agent -b "context" --commit abc123 |
| 预览审查范围 | ocr review --preview |
Step 3: 分类
对每条审查意见按优先级分类:
- 高:明确的 bug、安全漏洞、数据风险、空指针 → 必须修
- 中:合理关切但依赖上下文、风格/性能建议 → 选择性修
- 低:大概率误报、上下文不足、吹毛求疵 → 直接丢弃
分类完成后,必须先输出本轮问题清单,再进入修复或确认:
- 本轮有高/中优先级问题时,必须逐项列出文件、行号、问题和处置方式。
- 本轮只有低优先级问题时,也要明确写“无高优先级问题”“无中优先级问题”“低优先级已忽略”。
- 每个问题必须带唯一编号,建议格式为
R{轮次}-{序号},后续引用时只报编号即可。
Step 4: 修复
- 先列出所有高+中优先级问题清单
- 按优先级排序,逐一修复
- 在开始修复前,先把“本轮发现 / 高优先级 / 中优先级 / 处置方式”完整汇总给用户确认
- 高优先级可以直接修,但必须先展示完整汇总结果;不要边审查边直接改代码
- 同一文件多问题时,从文件底部往顶部修,避免行号漂移导致后续修复定位错误
- 中优先级问题修复前先问用户确认,高优先级直接修
- 每完成一项,标注已修复
- 不过度开发:只修问题本身,不顺便重构无关代码
修复完成后,输出本轮修复清单:
## 修复清单 | 编号 | 优先级 | 文件:行号 | 问题 | 状态 | |------|--------|-----------|------|------| | R1-1 | 高 | Foo.java:42 | 空指针 | ✅ 已修复 | | R1-2 | 中 | Bar.ts:88 | SQL拼接 | ✅ 已修复 | | R1-3 | 中 | Baz.java:15 | 命名不规范 | ⏭️ 跳过,业务允许 |
Step 5: 抑制重复
对于已确认修复的问题,在下一轮审查前,将对应规则写入项目级抑制配置:
# 项目级规则文件: .opencodereview/rule.json
避免同一问题反复出现。
Step 6: 循环
修复完成后,重新运行 ocr review,验证:
- 高优先级问题清零
- 中优先级问题清零或已确认无需修复
- 无新增高优先级问题
若仍有高/中优先级问题,回到 Step 3,继续循环。
Step 7: 结束条件
循环终止条件:
- 高优先级 = 0 且 中优先级 ≤ 0(或剩余中优先级已明确判定无需修复)→ 审查通过
以下情况强制终止,不允许无限循环:
- 同一仓库已跑 3 轮仍未清零 → 终止并标注 ⚠️,列出剩余未解决问题
- 同一问题连续 3 轮出现且已确认无法修复 → 放入暂缓修复清单,记录到项目 TODO,后续审查不再报
输出格式
仓库发现清单
审查开始前,展示待审查仓库:
## 待审查仓库清单 | # | 仓库 | 状态 | |---|------|------| | 1 | /path/repo-a | ✅ 有改动 | | 2 | /path/repo-b | ⏭️ 无改动,跳过 | | 3 | /path/repo-c | ✅ 有改动 |
每轮审查输出
## [repo-name] 第 N 轮审查 **审查文件数**: N **本轮发现**: X 高 / Y 中 ### 本轮问题清单 | 编号 | 优先级 | 文件:行号 | 问题 | 处置 | |------|--------|-----------|------|------| | R1-1 | 高 | path/file:10 | 问题描述 | 直接修复 | | R1-2 | 中 | path/file:20 | 问题描述 | 先确认后修复 | ### 高优先级 - **`path/file:行号`** — 问题描述 > 修复建议: xxx ### 中优先级 - **`path/file:行号`** — 问题描述 > 修复建议: xxx
如果本轮没有高/中优先级问题,仍然要明确输出:
## [repo-name] 第 N 轮审查 **审查文件数**: N **本轮发现**: 0 高 / 0 中 ### 本轮问题清单 - 无高优先级问题。 - 无中优先级问题。 - 仅有低优先级问题,已忽略。
最终报告(按仓库分组)
## 审查完成 | 仓库 | 轮数 | 高修 | 中修 | 跳过 | 结果 | |------|------|------|------|------|------| | repo-a | 2 | 3 | 1 | 0 | ✅ 通过 | | repo-b | 1 | 1 | 0 | 0 | ✅ 通过 | | repo-c | 3 | 2 | 1 | 1 | ⚠️ 达上限,剩余1个中优先级问题 | **总计**: 3 个仓库 / 6 轮 / 7 个高优修复 / 2 个中优修复 / 审查通过 ✅
未通过时标注异常项:
### 未解决问题 | 编号 | 仓库 | 文件:行号 | 问题 | 处置 | |------|------|-----------|------|------| | R3-2 | repo-c | Foo.java:42 | 线程安全 | ⚠️ 暂缓修复,已记录 TODO |
重要约束
- 不过度开发 — 只修问题本身,不顺手重构
- 不高估 — 不确定的降级为中或低
- 不虚构 — 审查结果基于
ocr实际输出,不编造问题 - commit 前需用户确认
- 低优先级一律忽略,不展示不讨论
热门AI工具
相关专题
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。
0
2026.11.17
SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。
0
2026.11.17
SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。
0
2026.11.17
SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。
0
2026.11.17
本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。
0
2026.11.12
本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.12
本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。
0
2026.11.12
热门下载
相关下载
精品课程
共6课时 | 12.1万人学习
共79课时 | 161.9万人学习
共6课时 | 54.8万人学习
最新文章