mirror of
https://github.com/codestable/CodeStable.git
synced 2026-09-19 09:03:09 +08:00
docs: clarify OCR untracked review scope
This commit is contained in:
@@ -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 严重度后合并:
|
||||
|
||||
|
||||
Reference in New Issue
Block a user