評審規則

四層優先級鏈

對每個檔案路徑，依序嘗試各層；第一個匹配的模式生效。

規則檔格式

{
  "include": ["src/**/*.{ts,tsx}", "src/**/*.go"],
  "exclude": ["**/*.test.ts", "**/generated/**"],
  "rules": [
    { "path": "src/api/**/*.go", "rule": "All exported handlers must validate request bodies before use." },
    { "path": "**/*mapper*.xml", "rule": "Check SQL for injection risks, parameter errors, and missing closing tags." }
  ]
}

• include——glob 模式，繞過內建預設排除（測試檔排除）。它不是白名單。
• exclude——OCR 不審的檔。過濾中優先級最高。
• rules——{path, rule} 條目，按宣告順序求值。第一個匹配決定發給模型的 prompt。

glob 能力（bmatcuk/doublestar/v4）

模式匹配不區分大小寫（路徑先小寫化）。不確定時用 ocr rules check <path> 確認。

五重門檔案過濾

對每個 diff，OCR 依序問：

1. binary——二進位？排除。
2. user_exclude——命中你的 exclude？排除。
3. user_include——有 include 且命中？立即保留（繞過下面兩門）。
4. unsupported_ext——擴展名在白名單？不在則排除。
5. default_path——命中內建測試檔排除模式（**/*_test.go…）？排除。

全部通過才發給 LLM。用 ocr review --preview 可不花 token 印出過濾結果。

內建排除（節選）

**/*_test.go            **/*.test.{js,jsx,ts,tsx}
**/src/test/**/*.java   **/__tests__/**
**/*_test.py            **/*_spec.rb
**/*Test.java           **/*_test.rs

每檔規則解析

過濾決定某檔會審後，OCR 依序試 --rule → 專案 rule.json → 全域 rule.json → 系統內建。解析出的規則正文成為 plan 與 main task prompt 的 {{system_rule}}。

查看哪條規則生效：ocr rules check

$ ocr rules check src/main/java/com/example/UserService.java
File: src/main/java/com/example/UserService.java
Source: System built-in
Pattern: **/*.java
Rule:
────────────────────────
…java.md 內容…
────────────────────────

配方

專案級：強制編碼規範

{
  "rules": [
    { "path": "src/api/**/*.go", "rule": "Every public handler must `defer tx.Rollback()` immediately after starting a transaction." },
    { "path": "**/*mapper*.xml", "rule": "Check SQL for injection risks, missing parameter binding, and unclosed XML tags." }
  ]
}

跳過生成碼，聚焦 src

{ "include": ["src/**/*.{ts,tsx,js,jsx}"], "exclude": ["**/*.gen.ts", "**/generated/**"] }

按 PR 覆蓋

ocr review --rule ./.review-rules-only-for-this-pr.json

cat > .opencodereview/rule.json << 'EOF'
{
  "include": ["src/**/*.go"],
  "exclude": ["**/*_test.go"],
  "rules": [
    { "path": "src/api/**/*.go", "rule": "Check for missing error handling after db.Begin()." }
  ]
}
EOF

ocr rules check src/api/handler.go

ocr review --preview

ocr review

File: src/api/handler.go
Source: Project .opencodereview/rule.json
Pattern: src/api/**/*.go
Rule:
────────────────────────
Check for missing error handling after db.Begin().
────────────────────────

延伸閱讀：CLI 參考 · 架構 · FAQ