讲师中心 微信公众号

工具推荐

视频效率加速
立刻MV
立刻MV

低成本歌曲 MV、视频生成

剧云
剧云

中文短剧剧本制作平台

Laper
Laper

剧本策划到成片协作

Seko
Seko

AI短剧一键生成成片

ocr-review-loop

Polar Sponsor
爱发电 赞助
.NET 9.0

把零散代码审查变成可追踪、自动收敛的修复闭环——高风险必修、重复告警降噪,直到交付真正干净的代码。

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: 结束条件

循环终止条件:

  1. 高优先级 = 0 且 中优先级 ≤ 0(或剩余中优先级已明确判定无需修复)→ 审查通过

以下情况强制终止,不允许无限循环:

  1. 同一仓库已跑 3 轮仍未清零 → 终止并标注 ⚠️,列出剩余未解决问题
  2. 同一问题连续 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 |

重要约束

  1. 不过度开发 — 只修问题本身,不顺手重构
  2. 不高估 — 不确定的降级为中或低
  3. 不虚构 — 审查结果基于 ocr 实际输出,不编造问题
  4. commit 前需用户确认
  5. 低优先级一律忽略,不展示不讨论
目录

热门AI工具

更多
豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

花生AI
花生AI Hot

一款AI视频创作工具,主要用于B站推出的AI视频创作工具,适合需要提升相关任务效率的用户。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

相关专题

更多
GoFrame框架Web开发与路由中间件
GoFrame框架Web开发与路由中间件

本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。

0

2026.11.17

GoFrame框架安装与gf命令行工具
GoFrame框架安装与gf命令行工具

本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。

0

2026.11.17

GoFrame框架零基础入门
GoFrame框架零基础入门

本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。

0

2026.11.17

SQLAlchemy 一对多关系怎么建立
SQLAlchemy 一对多关系怎么建立

SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。

0

2026.11.17

SQLAlchemy 如何增删改查
SQLAlchemy 如何增删改查

SQLAlchemy 如何增删改查?本专题整理 ORM 新增记录、条件查询、更新和删除、Session 事务提交与批量处理等实用文章,帮助你掌握 Python 数据库操作流程。

0

2026.11.17

SQLAlchemy ORM 模型怎么写
SQLAlchemy ORM 模型怎么写

SQLAlchemy ORM 模型怎么写?本专题整理模型类定义、Mapped 字段映射、主键与约束、表结构创建和常见报错的相关文章,帮助你从基础配置到实际建模逐步掌握 SQLAlchemy。

0

2026.11.17

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

0

2026.11.12

Go-Zero安装与goctl环境配置教程
Go-Zero安装与goctl环境配置教程

本专题围绕Go-Zero的安装与工具链配置展开,讲清Go版本要求、goctl安装方式、代理镜像、protoc依赖与环境变量设置,说明多版本共存、升级回退与CI流水线安装的做法,并整理安装阶段的常见报错与验证步骤。

0

2026.11.12

Go-Zero零基础入门教程
Go-Zero零基础入门教程

本专题整理Go-Zero的入门知识,从框架定位、环境准备到跑通第一个API服务,讲清目录分层、配置加载、日志与中间件的基本用法,并对比Gin、Kratos的差异,帮助Go开发者建立整体认知,判断它是否适合当前项目。

0

2026.11.12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn