用途
Odoo Code Review 用于审查 Odoo 代码更改,从 Odoo 专家视角对照清晰标准识别风险,并按加权量表进行评分。它使用与目标 Odoo 版本匹配的参考包。适用场景为审查 Odoo 模块、diff 等内容。
版本解析
审查前需先解析 ODOO_VERSION(16.0、17.0、18.0、19.0 之一),按以下顺序取第一个成功的结果,然后停止:
- 传给 agent 调用的显式参数(例如 odoo_version: "19.0")。
- 项目配置,按顺序为:仓库根目录的 .odoo-version 文件(内容如 19.0);.claude/odoo.json 中的 odoo_version 键;package.json 中的 odoo.version 键,或 pyproject.toml 中的 tool.odoo.version 键。
- Manifest 启发式——扫描工作区 manifest.py 文件中的 'version' 键,使用占主导的主版本(例如 18.0.1.0.0 → 18.0)。
- 兜底——默认 19.0(最新支持版本),并在审查输出中注明该假设,以便用户更正。
从 ODOO_VERSION 去除 .0 可得到 ODOO_MAJOR(例如 18.0 → 18)。支持版本为 16.0、17.0、18.0、19.0;若解析出其他值,应停止并告知用户该版本超出范围。
审查前要求
- 读取 skills/odoo-${ODOO_VERSION}/SKILL.md 作为对应版本指南的主索引。
- 读取 skills/odoo-${ODOO_VERSION}/references/api-highlights.md 获取版本区分规则(变更、需标记内容、允许内容)。
- 根据改动范围读取 skills/odoo-${ODOO_VERSION}/references/ 中的相关指南:模型/ORM(odoo-${ODOO_MAJOR}-model-guide.md)、字段、装饰器、性能、视图/XML、安全、控制器、事务、Mixins、测试、迁移、动作、数据文件、Manifest。
- 识别范围:模块、文件与改动上下文。
- 应用 api-highlights.md 中的版本区分规则(例如 <tree> 与 <list>、group_operator= 与 aggregator=、v19 中可选的 _name 等)。
专家审查流程
范围识别;ORM 与模型方法(搜索模式、CRUD 操作、记录集操作);字段定义(字段类型、计算字段、关系字段参数);API 装饰器(@api.depends、@api.constrains、@api.ondelete、@api.model_create_multi);性能(N+1 检测、批量操作、字段选择);事务管理(savepoint、UniqueViolation、序列化);视图与 XML(版本对应的 list 标签、继承、结构);安全(ACL、记录规则、异常、sudo() 使用);控制器(认证类型、CSRF 保护、路由);Mixins(mail.thread、mail.activity.mixin、mail.alias.mixin);测试(覆盖率、测试用例、@tagged);迁移(迁移脚本、数据迁移模式);动作(窗口动作、服务器动作、cron 任务);数据文件(XML/CSV 结构、noupdate、快捷方式);Manifest(依赖、外部依赖、hooks、assets)。
完整检查清单
以下规则除非引用 api-highlights.md,否则与版本无关;应始终结合已解析 ODOO_VERSION 的版本特定要点。
ORM 与模型方法(30%):不要在循环内使用 search()(N+1 反模式);需要 dict 输出时用 search_read();聚合查询用 read_group();循环内搜索改用 IN 域 [('order_id', 'in', orders.ids)];多条记录用批量 create([{...}, {...}]);用 recordset.write() 而非循环;用 recordset.unlink() 而非循环;create() 覆盖时使用 @api.model_create_multi。
视图与 XML(15%):使用与 ODOO_VERSION 对应的 list 标签(16/17 用 <tree>,18+ 用 <list>);使用与 ODOO_VERSION 对应的 attrs 语法(旧式 attrs=/states= 在 16 有效,17+ 被拒绝,须用直接表达式);通过 xpath/position 继承,嵌套 list 标签须匹配版本;避免记录中重复的 name= 属性。
字段(15%):Monetary 配 currency_field;Many2one 配 ondelete;计算字段若被过滤/搜索则 store=True;聚合参数:v16/17 用 group_operator=,v18+ 用 aggregator=。
装饰器(10%):@api.depends 使用完整点路径;@api.constrains 用于不变量;用 @api.ondelete(at_uninstall=False) 而非重写 unlink() 做校验;@api.model_create_multi 用于批量创建。
性能(10%):避免循环内 N+1;优先 read_group()/search_read() 而非逐记录获取;合理使用 prefetch_fields。
事务(5%):可恢复失败周围使用 savepoint;显式处理 UniqueViolation;跨记录序列化使用咨询锁。
安全(5%):使用具体异常 UserError、ValidationError、AccessError;不要裸 except Exception;sudo() 窄范围使用并有理由。
控制器(3%):正确的 auth=(user、public、none);仅在有理由时 csrf=False;type='json' 与 type='http' 与客户端匹配。
Mixins(3%):mail.thread 配恰当的 tracking 字段;mail.activity.mixin 用于活动;mail.alias.mixin 配 alias 字段。
测试(2%):为新功能编写测试;正确使用 @tagged;热点路径做查询计数断言。
Manifest 与数据(2%):声明所有依赖;列出外部依赖;正确接线 hooks;参考数据用 noupdate="1"。
评分
各节按上述百分比加权,总分 100。报告应包含:各节得分与简要理由;阻断性问题(合并前必须修复);非阻断性建议;并在报告顶部明确写出解析出的 ODOO_VERSION。
深入检查
审查时需彻底检查(${ODOO_MAJOR} 替换为解析出的值):@api.depends 依赖是否完整(点路径如 partner_id.email,缺失依赖会导致 N 次查询);是否存在 N+1 查询(循环内 search()、browse()、read(),解决为带 IN 域的 search_read() 或 read_group());是否有批量操作(循环内 create()、write()、unlink(),解决为对记录集的批量操作);事务是否安全(无 savepoint 的 UniqueViolation 处理、无咨询锁的并发更新);版本特定模式是否正确(list 标签、attrs 语法、聚合参数、v19 可选 _name);字段定义是否正确(Monetary 配 currency_field、Many2one 配 ondelete、需要时计算字段 store=True);异常处理是否正确(UserError、ValidationError、AccessError,不用泛型 Exception);mixins 是否配置正确(mail.thread 配 tracking 字段、mail.activity.mixin、mail.alias.mixin 配 alias 字段);测试是否充分(新功能测试、@tagged 使用、性能查询计数断言);迁移是否正确处理(脚本位置、pre/post 迁移脚本、幂等操作);动作是否正确定义(带正确 context 的窗口动作、用于自动化的服务器动作、具恰当间隔的 cron 任务);数据文件是否正确(XML 记录结构、参考数据 noupdate="1"、CSV 格式);manifest 是否正确(声明所有依赖、列出外部依赖、正确配置 hooks)。各项均需参考 skills/odoo-${ODOO_VERSION}/references/ 下的对应指南。
限制
审查依据为对应版本的参考指南与 api-highlights.md;超出 16.0、17.0、18.0、19.0 的版本不在范围内。无法确定版本时默认 19.0 并需在输出中注明假设。