docs: clarify OCR untracked review scope

This commit is contained in:
dafang
2026-06-29 14:48:46 +08:00
parent 7b58fb2f11
commit 9bb946e9ba
+3 -2
View File
@@ -120,13 +120,14 @@ which ocr && ocr llm test
ocr review --audience agent --background "{feature slug / 目标 / 本次改动范围}"
```
**审查范围必须限定到本 feature 的人写代码改动**`ocr review` 默认 workspace 模式会把 staged + unstaged + **untracked** 全审一遍;当工作区存在大量与本 feature 无关的 untracked 文件(最典型是 `.codestable/` goal 执行包、点目录产物OCR 会横向扫描这些非范围文件,污染结果。两道控制:
**审查范围必须限定到本 feature 的人写代码改动**`ocr review` 默认 workspace 模式会把 staged + unstaged + **untracked** 全审一遍;untracked 里可能有本轮新增源码,也可能有 `.codestable/` goal 执行包、点目录产物、缓存等非范围文件。策略是遵循 `.gitignore` 并按本轮范围归因,而不是一律排除 untracked。两道控制:
1. **调用时限定范围**:本 feature 改动已提交到执行分支时,优先用 ref 范围 `ocr review --audience agent --from {feature-base} --to HEAD`天然排除 untracked 产物;只有改动全在 workspace 未提交时才用默认模式
1. **调用时限定范围**:本 feature 改动已提交到执行分支时,优先用 ref 范围 `ocr review --audience agent --from {feature-base} --to HEAD`审已提交 diff若本轮仍有未提交改动含新增文件必须先用 `git status --short` 判断这些文件是否属于本轮,再用默认 workspace 模式或补充本地审查覆盖它们
2. **结果过滤(兜底,必做)**:合并 OCR finding 前,**丢弃**命中以下路径的 finding无论 OCR 是否扫到——
- `.codestable/`CodeStable 自己的 spec / 工具产物,永远不是行级代码审查对象)
- 任何 `.` 开头的目录(`.git/``.claude/``.venv/` 等)
- `.gitignore` 命中的文件(`git check-ignore <path>` 为真)
未被 `.gitignore` 忽略、且能归因到本轮目标的 untracked 新增文件必须保留并 review。
OCR 的 High / Medium / Low 映射到 cs-code-review 严重度后合并: