用途:在提交、更新或复审 issue/PR 前,先在本地运行 ClawSweeper 获得只读审查结果,不产生 GitHub 变更。
安全边界:仅运行 pnpm run review -- --local-only(针对已有 GitHub 条目)或 pnpm run review -- --local-range(针对提交前的已提交范围)。除非用户明确要求变更操作,否则不要运行 apply-artifacts、apply-decisions、GitHub 评论发布、合并或自动修复命令。不要打印 OPENAI_API_KEY、CODEX_API_KEY、CODEX_ACCESS_TOKEN、GitHub token 或 Codex 认证材料。
定位与初始化:优先使用 package.json 名称为 @openclaw/clawsweeper 的当前仓库,否则用干净的本地检出(Windows: C:\oc-work\clawsweeper-source;POSIX: ~/Projects/clawsweeper)。改动前先 git status --short,检出脏或不确定时不要用于本地审查。首次设置:corepack enable、pnpm install、pnpm run build:all、pnpm run codex:local:check。若 Codex 未登录,由操作者自行认证,例如 codex login --device-auth -c 'service_tier="fast"'。
运行方式:pnpm run review -- --local-only --item-number <pr-number>,可加 --target-dir <target-dir>;预提交范围用 pnpm run review -- --local-range --target-repo <owner/repo> --base origin/main。默认输出人类可读进度,--verbose 仅在调试时使用。
产物与限制:报告默认写入 <artifact-dir>/<issue-or-pr-number>.md,需读取并汇总 review_status、main_sha、pull_head_sha、decision/confidence/action、findings/blockers,以及失败时的 Codex/认证/运行时错误。local-range 会隐藏 GitHub 凭据、隔离 gh 认证、禁用网络搜索并跳过 URL/媒体预处理,但仍会调用所配置的 Codex 模型服务,不能称为完全离线。收尾前确认使用只读命令、未运行任何 GitHub 变更、目标检出仍干净;如有问题列出可操作项与下一步本地修复/测试。