open-code-review

1# Open Code Review
2 
3A skill for invoking [open-code-review](https://github.com/alibaba/open-code-review) (`ocr`) — an open-source AI code review CLI that reads Git diffs and generates structured, line-level review comments.
4 
5## Workflow
6 
7### Step 1: Gather Business Context
8 
9Analyze the review target (commits, branch, or changes) to extract concise business context. Pass this context via `--background` to improve review quality.
10 
11### Step 2: Run Code Review
12 
13**Do not pre-check whether `ocr` is installed** — skip probes like `command -v ocr` or `ocr --version`. Assume the CLI is available and run the review directly; that saves a tool call on the common path. Only if the review fails with `command not found` should you install it per Troubleshooting.
14 
15Run the OCR command with appropriate flags. **Always pass business context via `--background`** when available:
16 
17```bash
18ocr review --audience agent --background "business context here" [user-args]
19```
20 
21**Argument handling:**
22 
23- **Background context** (RECOMMENDED): use `--background "context"` or `-b "context"` to provide business context for better review quality
24- **Default** (no user arguments): reviews staged, unstaged, and untracked changes (workspace mode)
25- **Specific commit**: use `--commit` or `-c` to review a single commit against its parent
26- **Branch comparison**: use `--from <ref>` and `--to <ref>` to review diff between two refs
27…