메뉴
用户显式触发的本地代码审查:按 diff 特征自动从 lens 池选 3-6 个相关审查维度(不是固定 3-agent、也不是几十 agent 的 workflow),跑 Route→Fan-out→Verify→Synthesize,对抗式 verify 杀假阳性后按严重度出报告。替代项目「固定 3-agent 本地审查」约定。三档 quick/standard/thorough,默认 standard;thorough 复用现有 /code-review Workflow 不重造。仅用户显式触发,不自动跑。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
分级路由的代码审查:把多维度审查的「广度发现」层 offload 到 grok CLI(用 grok 订阅省 Claude 额度),Claude 只做高档对抗验证 + 综合。当多 agent 审查(pr-review-toolkit:* 子 agent)或 code-review workflow 被触发时,PreToolUse hook 会 deny 并把发现层改道到本 skill 的 grok 编排器。grok-only MVP(agy 第三腿暂缓)。
用户说「merge 收尾」时的固定收尾 SOP(step0-6):stacked child PR base 解耦、squash merge、.app 转移加 test 前缀、清理远端/本地/worktree 并逐项 verify、关联 GitHub issue、Linear MOC transition + step6.2 强制扫描未完成 issue 挂强相关。含搭车改动补 Done issue、外部 contributor workflow approve、fork PR 收尾差异、深层 stacked squash、reviewThreads 分页坑等变体。没听到「merge 收尾」明确指令绝不主动 merge。
发版/release 全流程 SOP:dispatch 前预发布微 PR(版本号全盘 grep bump、双语 release notes 硬模板 2500-3200 字符、release-notes/vX.Y.Z.md CI 门禁)、release.yml workflow_dispatch 版本校验、merge cleanup 顺序、build 完保持 draft 等用户显式确认才转 Latest。用户说「发版/准备 release/触发 release workflow」时使用。
本地 Plane work item 索引(Plane Cloud)。需要定位、查找、回忆 Plane work item 时(按编号/关键词/状态/标签/project/归档),先查本地索引再按需 MCP 拉详情;也负责索引的增量/全量刷新。与 linear-index 同构,但适配 Plane(原生归档、无限 issue、PQL、external_id 回链 Linear)。
通过 CDP 注入驱动真实运行的 Codex Desktop 跑一轮对话并读回 assistant 回复,对 codex-app-transfer 的 Codex 集成做 E2E/冒烟测试(验证 provider 路由 / 协议适配 / 注入 / 代理链路端到端是否真的工作),替代很多手搓 E2E。默认新建独立会话测试、结束精准归档,绝不动用户已有会话。当需要"在真实 Codex 里发一句 prompt 看实际效果"而不仅是跑单测时使用。
本地 Linear issue 索引。需要定位、查找、回忆 Linear issue 时(按编号/关键词/状态/标签/里程碑/归档状态),先查本地索引再按需 MCP 拉详情;也负责索引的增量/全量刷新。merge 收尾扫描相关 issue 时同样先走本索引筛候选。
| name | adaptive-review |
| description | 用户显式触发的本地代码审查:按 diff 特征自动从 lens 池选 3-6 个相关审查维度(不是固定 3-agent、也不是几十 agent 的 workflow),跑 Route→Fan-out→Verify→Synthesize,对抗式 verify 杀假阳性后按严重度出报告。替代项目「固定 3-agent 本地审查」约定。三档 quick/standard/thorough,默认 standard;thorough 复用现有 /code-review Workflow 不重造。仅用户显式触发,不自动跑。 |
把「提交前本地审查」从固定 3-agent(死板、不按改动选)升级成按 diff 特征自动选 3-6 个相关 lens 的自适应审查:既比固定 3-agent 全面(该上的维度自动上),又比 /code-review 的几十 agent workflow 省额度(只跑相关的、用 Agent subagent 不走 Workflow)。
来源:MOC-303(2026-07-08 定案,grok PR #590 收尾后落地)。替代项目 CLAUDE.md 里「本地 3-agent 审查」约定。 仍是用户显式触发(遵 2026-07-05「多 agent 审查不自动跑、用户显式触发」决策)——不在每次写完代码后自动跑。
/adaptive-review;或 SOP(如 grok PR 那样)到了「提交前本地审查」这一步。/code-review ultra(云端、计费,用户自己触发)。git diff,启发式 grep 出改动信号 → 选中「恒跑核心 + 命中信号」的 lens(典型 3-6 个)。歧义时才花 1 个便宜 router agent 微调。CONFIRMED / PLAUSIBLE / REFUTED;REFUTED 丢弃,PLAUSIBLE 标注保留。standard 档默认带。| 档 | lens 数 | verify | 用途 | 承载 |
|---|---|---|---|---|
| quick | 2-3(恒跑核心 + top1-2 信号) | 无(单票) | 小改动 / 快速冒烟 | Agent subagent |
| standard(默认) | 3-6(恒跑核心 + 全部命中信号,封顶 6) | 带(每 finding 1 verifier) | 提交前常规审查 | Agent subagent |
| thorough | 全相关 lens + 多票对抗 + sweep | 多票 | 高风险/大重构/安全面 | 复用现有 /code-review Workflow,不在本 skill 重造 |
/code-review,或其 ultra 变体)。启发式 = 对 git diff(默认)或目标 range 做 grep,命中信号则点亮对应 lens。correctness-linescan 恒跑。
| lens | 触发信号(grep 本次 diff) | 承接 agent |
|---|---|---|
| correctness-linescan | 恒跑 | pr-review-toolkit:code-reviewer |
| silent-failure | 新增 catch/unwrap_or/.ok()/? 吞错/fallback/空 except/|| default/rescue | pr-review-toolkit:silent-failure-hunter |
| type-design | 新增 struct /enum /interface /type /trait | pr-review-toolkit:type-design-analyzer |
| comment-accuracy | 新增断言协议/wire/版本/字段/端点的注释 | pr-review-toolkit:comment-analyzer |
| test-coverage | 非测试文件加了逻辑,无对应 test 文件改动 | pr-review-toolkit:pr-test-analyzer |
| simplification | 大新增(>~80 净增行)或疑似重复/镜像代码 | pr-review-toolkit:code-simplifier |
| removed-behavior | 有实质删除行(^- 去掉非空非注释的逻辑) | codex-angle finder(下方) |
| cross-file-impact | 改了函数/方法签名、pub/导出接口、公共类型 | codex-angle finder |
| language-pitfall | 语言特有危险:Rust .unwrap()/.expect(/as /mem::;TS any/==/! 非空断言;Go 忽略 err | codex-angle finder |
| wrapper-proxy | 新增 wrapper/proxy/adapter/middleware 型转发代码 | codex-angle finder |
| dependency | Cargo.toml/package.json/*.lock 改动 | codex-angle finder |
| concurrency | 新增 async/await/Mutex/RwLock/Arc/spawn/tokio::/Ordering:: | codex-angle finder |
前 6 个 lens 直接映射到 pr-review-toolkit 的 6 个专用 agent(subagent_type 用表里的名字)。
后 6 个 codex-angle lens 没有专用 agent → 用 general-purpose subagent,prompt 收窄到该 angle(见下方 Fan-out 模板),对齐 codex-review「多 correctness angle finder」的做法。
# 取本次改动(默认:未提交 + 已暂存的近期工作);也可传 PR / commit range
DIFF=$(git diff HEAD) # 或 git diff <base>...<head> / gh pr diff <PR#>
FILES=$(git diff --name-only HEAD)
对 $DIFF / $FILES 逐信号 grep(零额外 agent),点亮 lens。示例判据:
silent-failure:git diff HEAD | rg '^\+' | rg 'unwrap_or|\.ok\(\)|catch|fallback|except|\|\| *(default|null|None)'type-design:rg '^\+.*\b(struct|enum|trait|interface|type) 'dependency:echo "$FILES" | rg 'Cargo\.toml|package\.json|\.lock$'cross-file-impact:diff 里有 ^[+-].*\bfn |^[+-].*\bpub |^[+-].*(export |function ) 且签名行两侧都动concurrency:rg '^\+.*(async|await|Mutex|RwLock|Arc<|tokio::|spawn|Ordering::)'removed-behavior:git diff HEAD | rg '^-' | rg -v '^--- ' | rg -v '^-\s*(//|#|\*|$)' 有实质删除选择规则:correctness-linescan 恒进;每个命中信号的 lens 进;standard 封顶 6(超了按严重度优先级保留:silent-failure > correctness > cross-file-impact > removed-behavior > type-design > concurrency > language-pitfall > dependency > 其余,并 log()/在报告里说明砍了哪些)。quick 封顶 3(核心 + top2)。
歧义才上 router agent(默认不上):当 diff 大而杂、信号交叉难定 top-N 时,派 1 个便宜 general-purpose(可 model: haiku)agent:「给你 diff 的文件清单 + 信号命中表,从 lens 池选最相关的 3-6 个并排序,只回 JSON」。否则纯启发式即定。
发现层改走 grok CLI([[tiered-review]] skill,2026-07-12 定案 option A):不再 spawn pr-review-toolkit / general-purpose finder 子 agent(那烧 Claude 额度)。把 Route 选中的 lens 一次性交给 grok 编排器,用 grok 订阅出结构化 findings:
bash ~/.claude/skills/tiered-review/tiered-review.sh \
--dims <Route 选中的 lens 逗号拼,如 correctness-linescan,silent-failure,test-coverage> \
--diff <Step 1 的 DIFF 文件> # 或 --base <ref>;缺省审工作区 git diff
--dims 用 Route 选中的 lens 名(= tiered-review config.lens_prompts 的 key,含 6 pr-toolkit + 6 codex-angle 全部 lens)。{lens, backend:"grok", findings:[{file,line,severity,summary,failure_scenario}]};grok 用 --json-schema 约束结构化,可靠可解析。error 的 lens 在报告里显式说明「grok 该维度未审(原因)」,不当作无问题。grok login(auth ~/.grok/auth.json)。未装/未登录 → tiered-review.sh 对该 lens 回 error;此时回退老路(spawn subagent)或提示用户登录。tiered-review/hooks/route-review.py 会 deny 直接 spawn 的 pr-review-toolkit:* 子 agent 作兜底守门(防漏走成 Claude 额度)。验证/综合仍用 Claude(见 Step 3/4),别在那里 spawn pr-review-toolkit(会被再 deny)。收齐所有 lens 的 findings,每条派 1 个独立 general-purpose verifier(和 finder 不同 agent,避免自证):
逆向核验这条 finding:。回到
<file:line>真实代码,尝试证伪它。判定CONFIRMED(能给出具体触发输入→错误结果)/PLAUSIBLE(合理但无法坐实)/REFUTED(假阳性/读错代码/pre-existing/不适用)。不确定倾向 REFUTED。回{verdict, reason, (CONFIRMED 时)repro}。
## adaptive-review(standard 档,跑了 N 个 lens:<列出>)
### 🔴 BLOCKER / HIGH
- `file:line` [lens] 一句话问题 → 触发场景 → 修法
### 🟡 MEDIUM / LOW
- …
### ⚠️ PLAUSIBLE(verify 未坐实,待你判断)
- …
> 砍掉的 lens:<若封顶砍了哪些>;REFUTED 假阳性:<N 条,不列>
/code-review 承载)。/code-review 的全量 angle×verify×sweep。/code-review(或 /code-review ultra 云端计费版),本 skill 不复制其 Workflow。