SuperAPI AI 工具集

codereview-rules

编程与开发

查看项目

更新于 10-15 21:48

技能介绍

用途:OCR 规则用于告诉审查者关注哪些语义风险,不是运行 lint、编译或测试的替代品。只有用户明确要求变更项目审查策略时才修改 .opencodereview/rule.json;普通代码审查只读取并说明现有规则。

范围与权限:先查看当前目标仓库规则、全局规则和显式 --rule 参数,按 OCR 当前版本核实实际优先级,不假设各版本字段一致。变更文件前确认用户意图和现有修改,保留未知字段与人工注释策略。JSON 不支持标准注释,不要为改一项重写整个文件。

流程:第一步把要求改写为可检验规则,明确对象、路径、风险、反例与排除项,例如“审查订单幂等”优于“检查所有代码质量”。第二步核对现有规则命中顺序,判断替换还是合并默认规则,使用最窄而足够的路径模式,并准备应命中与不应命中的代表文件。第三步修改后验证 JSON 语法,再运行 ocr rules check <path>;记录实际命中、规则来源、合并情况及 CLI 版本,若 CLI 不支持该命令则不能凭字符串匹配声称已验证。第四步排除执行不安全命令、泄露凭据或越过用户同意的规则内容,交付 diff、匹配证据和未验证边界。

限制与易错点:规则变化后旧报告失效,需先返回 harness 重新准备,不复用旧授权。不安装或升级 OCR,不试跑真实模型;ocr rules check 只证明路径命中,不证明模型真的发现缺陷。若第一条命中规则替换了内置规则,可能意外失去系统检查。宽泛路径会增加噪声和费用,应先缩小到业务边界。需要可执行格式或静态门禁时交给 CodeGuard,需要需求验收或强制放行策略时交给 FlowGuard,只想审查一次且不改团队策略时用官方 open-code-review / open-code-review-delegate。真实 OCR 审查需另行授权。