用途:让 Codex 等其它智能体在本地代码改动后,获得与 Claude Code 相同的独立审查流程。Claude Code 将内置 /code-review 标记为需显式调用,用自然语言请求不会触发同一工作流;该技能通过 claude CLI 调用它。若本身在 Claude Code 内运行,应直接用内置 /code-review,本技能会因检测到 CLAUDECODE 环境变量而拒绝运行。
工作流:先读仓库说明并检查 git status,保留无关改动,审查范围含已提交分支改动及暂存、未暂存和未跟踪内容。比较基准优先用户指定,否则由助手查找远程默认分支,依次尝试 origin/main、origin/master、main、master,可用 --base <ref> 纠正。
运行:在待审查仓库执行 python <skill-path>/scripts/review.py [--base <ref>] [--focus "extra context"]。助手以非交互 print 模式、Opus 模型显式调用 /code-review,保留仓库 CLAUDE.md 指令并返回纯文本报告,进度输出到 stderr。
验证与修复:逐条独立核对引用位置、追踪行为、必要时做聚焦复现,将结果分为已确认、误报、已处理、超出范围,并简要说明被拒原因。只修复属于本次改动的已确认问题,遵循仓库指令,保留无关工作,能证明失败模式时补回归测试;扩大范围或重大产品决策前先询问。每次修复后跑聚焦检查,最后跑仓库要求的检查。改动更新后再审查一次;仅当出现新的已确认缺陷才继续,除非用户要求更深入,最多两轮。最后报告确认与拒绝的发现、所做修改、执行的检查和剩余风险;未经用户要求或仓库流程规定不提交。
助手选项:--base <ref> 设比较基准;--target <value> 传精确路径、PR、分支或 ref 范围(与 --base 互斥);--focus <text> 补充审查上下文;--model <alias-or-id> 覆盖默认 opus;--effort <level> 覆盖默认 high;--timeout <seconds> 改 20 分钟子进程超时;--max-budget-usd <amount> 限制 API 花费;--output <path> 写出报告;--bypass-permissions 使用 --dangerously-skip-permissions,仅在计划模式无法完成审查且仓库处于隔离可信环境时使用,该模式给子进程完整系统权限。不要用 /review 代替:它面向 GitHub PR,本分支本地改动可能返回空结果。快速迭代和复审用 medium,最终大范围审查用 high 或 max,大 diff 即使本地运行也可能耗时数分钟。更深入的合并前审查可提供 claude ultrareview <base> --json,它执行远程多智能体审查并独立验证,但会上传仓库状态且可能产生额外用量费用,需先获用户明确同意。审查标准优先当前改动引入的缺陷:错误行为、回归、安全问题、数据丢失、竞态、错误处理失效和明显性能问题,需具体失败路径并引用最窄有用行号;跳过风格偏好、推测性担忧和泛泛的补测试要求。空发现结果是合法的,不得为显得有用而编造问题。