资讯动态

claude-code-system-prompts 源码解析:/code-review 高投入(high effort)模式的召回优先审查流水线

发布时间:2026/10/9 7:31:32 来源:尧图企业网站定制
文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载导读/code-review是 Claude Code 内置的代码审查斜杠命令本文聚焦其high effort高投入档位的 Agent Prompt 设计——来自 claude-code-system-prompts 仓库中 agent-prompt-code-review-part-7-high-effort-mode.md 一份真实运行于 Claude Code v2.1.288 的提示词切片。读完本文你将掌握 high effort 模式的完整审查流水线8 个独立查找角度并行产出候选、单票召回偏向验证、一次 ReportFindings 调用输出最多 10 条按严重度排序的 JSON 结论并能对照 low / medium / extra-high / max 档位理解其设计取舍。一、这份文档在仓库中的位置模块化拼装的高投入档位切片Claude Code 的系统提示词并非单一字符串而是大量按环境与配置条件拼接的模块。仓库 README.md 明确说明这些提示词是从最新 npm 版 Claude Code 的编译产物中直接提取的与官方实际运行时完全一致。/code-review的提示词被拆成 10 个 part 文件high effort 档位正是其中的 part 7README 标注其规模为511 tokens。part 7 本身是一个骨架模板文件头的 front matter 声明了 9 个待注入变量正文通过${VAR}占位符引用兄弟文件中的内容块运行时由 Claude Code 的主进程完成拼装变量作用定义所在DIFF_GATHERING_PHASE收集待审查 diffPhase 0skill-code-review-phase-0-gather-the-diff.mdBASE_FINDER_ANGLES_BLOCK3 个基础正确性查找角度agent-prompt-code-review-part-1-base-finder-angles.md、skill-code-review-correctness-finder-angles.mdCLEANUP_AND_ALTITUDE_CANDIDATES_NOTE清理/海拔/约定角度的候选纪律part 7 自身与 agent-prompt-simplify-slash-command.mdRECALL_BIASED_VERIFY_PHASE召回偏向的单票验证阶段agent-prompt-code-review-part-5-recall-biased-verification-phase.mdOUTPUT_FORMAT_FN(MAX_FINDINGS)输出格式与条数上限agent-prompt-code-review-part-10-reportfindings-output-format.mdAGENT_TOOL_NAME/AGENT_UNAVAILABLE_INSTRUCTIONS子代理工具名与不可用时的降级指令agent-prompt-code-review-unavailable-agent-inline-mode.md理解了这种拼装机制就能读懂 part 7 正文为何如此精炼——它只负责定义 high effort 档位的审查哲学、阶段编排与预算约束具体招式角度、验证细则、输出契约由注入的块提供。二、一图看懂流水线一行公式浓缩全部流程part 7 正文第 16 行给出了整个 high effort 模式的浓缩定义high effort → 35 angles × 6 candidates → 1-vote verify (recall-biased) → ≤10 findings逐段拆解审查目标recall召回率优先。正文开门见山You are reviewing forrecallat high effort: catch every real bug a careful reviewer would catch in one sitting. At this level, catching real bugs matters more than avoiding false positives. Err on the side of surfacing.你在以高投入审查召回率抓住一位细心审查者在一次评审中能抓到的每一个真实 bug。此档位下抓住真实 bug 比避免误报更重要宁可多报。8 个角度353 个正确性角度 3 个清理角度 1 个海拔altitude角度 1 个约定conventions角度 8 个独立查找角度。每个角度最多 6 个候选全流程理论候选池上限为 8×6 48 条。单票召回偏向验证每条候选由一个验证子代理投出 CONFIRMED / PLAUSIBLE / REFUTED 三态之一其中 PLAUSIBLE 默认成立仅 REFUTED 被丢弃。输出最多 10 条通过一次 ReportFindings 工具调用提交按严重度降序。对比同一仓库中 medium 档位part 6的公式medium effort → 35 angles × 6 candidates → 1-vote verify → ≤8 findings两者角度配置与候选预算完全相同差异集中在两点medium 目标是precision精确率every finding you surface should be one a maintainer would act on因此采用更严格的三态验证而 high 档位把验证切换到默认可信的召回偏向并把结论上限从 8 提到 10。这正是高投入档位宁多勿漏在预算层面的量化体现。三、Phase 0收集 diff划定审查范围DIFF_GATHERING_PHASE注入的 Phase 0 来自 skill-code-review-phase-0-gather-the-diff.md是所有档位共用的第一步# 有 upstream 时的标准做法合并 upstream 到 HEAD 的全部改动 git diff {upstream}...HEAD # 无 upstream 时的回退 git diff main...HEAD # 或审查最近一次提交 git diff HEAD~1关键细节未提交改动同样纳入范围如果存在未提交改动或范围 diff 为空审查常常发生在提交之前需追加git diff HEAD并把工作区改动纳入审查。显式目标优先如果命令行传入了 PR 编号、分支名或文件路径则改为审查该目标而非默认 diff。该 diff 即审查范围的唯一权威依据后续所有角度都在此范围内作业。四、Phase 18 个独立查找角度每个最多 6 条候选part 7 的 Phase 1 标题明确写出角度构成3 correctness angles 3 cleanup angles 1 altitude angle 1 conventions angle, up to 6 each。执行方式是通过${AGENT_TOOL_NAME}即 Claude Code 的 Agent/Task 子代理工具运行 8 个相互独立的查找代理每个代理独立产候选互不干扰每条候选必须携带四要素file文件路径line行号summary一行话概括问题failure_scenario具体的失败场景什么输入/状态 → 什么错误输出或崩溃4.1 三个正确性角度BASE_FINDER_ANGLES_BLOCK由 part 1 与 skill-code-review-correctness-finder-angles.md 定义Angle A — 逐行 diff 扫描逐行读取 diff 的每个 hunk再读取每个 hunk 所在的外层函数——被改函数中未改动的行若有 bug 同样在范围内因为 PR 重新暴露了它或本应修复却未修复。对每一行都追问什么样的输入、状态、时序或平台会让这一行出错重点寻找条件写反/写错、差一错误off-by-one、空值/未定义解引用、缺失await、falsy-zero 判断、复制粘贴错变量、catch 中吞掉错误、正则元字符未转义。Angle B — 被删除行为审计见 skill-code-review-angle-b-removed-behavior-auditor.md对 diff 中每一行被删除或被替换的代码先说出它原本保证的不变量或行为再在新代码中寻找该不变量被重新建立的位置。找不到那就是候选被移除的守卫、被丢弃的错误路径、被收窄的校验、被删除但确实覆盖了真实场景的测试。Angle C — 跨文件追踪见 skill-code-review-angle-c-cross-file-tracer.md对 diff 改动的每个函数用 Grep 找到它的调用方检查改动是否破坏了调用点的契约——新增的前置条件、改变的返回结构、新增异常、时序/顺序依赖同时检查被调函数同一 PR 中的并行改动是否让某个调用变得不安全。4.2 三个清理角度cleanup清理角度承接 agent-prompt-simplify-slash-command.md 中定义的 reuse / simplification / efficiency 三类问题altitude 在 code-review 中被单列Reuse复用新代码重复了 diff 上下文中可见的既有 helper或本可复用的实现被复制粘贴。Simplification简化存在更简单、更易维护的等价写法。Efficiency效率按 skill-code-review-efficiency-dimension.md标记 diff 引入的浪费——冗余计算或重复 I/O、本可并行的操作被串行执行、启动路径或热路径上新增阻塞工作以及由闭包或捕获环境构造的长生命周期对象对象存活期间整个外层作用域无法释放若作用域持有大值即内存泄漏应改为只拷贝所需字段的 class/struct。每个效率候选须指出更省成本的替代方案。4.3 海拔altitude角度检查改动所处抽象层级是否恰当——在错误的层级做了本应在更合适位置做的事例如把领域逻辑塞进 UI 层、或把通用能力写进一次性调用处。它与清理角度共同构成CLEANUP_AND_ALTITUDE_CANDIDATES_NOTE注入块的内容。4.4 约定conventions角度以 CLAUDE.md 为规则源按 skill-code-review-conventions-dimension.md此角度只审查被改动代码受其管辖的 CLAUDE.md用户级~/.claude/CLAUDE.md、仓库根目录CLAUDE.md以及改动文件所有祖先目录中的CLAUDE.md/CLAUDE.local.md一个目录的 CLAUDE.md 只适用于该目录及以下文件。只允许在能同时引用出确切规则原文与违规行原文时标记违规——不查风格偏好不做文档精神式的模糊推断结论中必须给出 CLAUDE.md 路径并引用规则原文便于报告引用。若没有适用的 CLAUDE.md该角度返回空结果。4.5 候选纪律有名字的失败场景必须放行part 7 正文对 Phase 1 提出了最关键的纪律要求Pass every candidate with a nameable failure scenario through — finders that silently drop half-believed candidates bypass the verify step and are the dominant cause of misses.让每一个具有可命名失败场景的候选通过——那些悄悄丢弃半信半疑候选的查找器绕过了验证步骤而这正是漏报的主因。这条规则直接服务于 recall 目标查找阶段宁可让半信半疑的候选进入验证阶段也绝不在源头静默丢弃——因为验证阶段有专门的回召偏向规则兜底而源头丢弃则直接造成漏报。五、Phase 2单票召回偏向验证1-vote, recall-biasedPhase 2 的注入块来自 agent-prompt-code-review-part-5-recall-biased-verification-phase.md执行流程由 skill-code-review-phase-2-verify-recall-biased.md 定义先去重合并近重复候选同一缺陷、同一位置、同一原因 → 保留一条。每候选一个验证子代理通过 Agent 工具把 diff、相关文件和候选交给验证者验证者必须且只能返回CONFIRMED / PLAUSIBLE / REFUTED三态之一。保留 CONFIRMED 与 PLAUSIBLE丢弃 REFUTED。5.1 PLAUSIBLE 默认成立别用太投机当借口召回偏向规则的核心是给不确定性定了一个默认放行的基调PLAUSIBLE by default— do not refute a candidate for being speculative or depends on runtime state when the state is realistic.默认视为 PLAUSIBLE——当候选所依赖的运行时状态是现实存在时不得以太投机或依赖运行时状态为由反驳它。part 5 明确列举了这些现实存在的典型情形并发竞态concurrency races在少见但可达路径上的空值/未定义错误处理器、冷缓存、缺失的可选字段falsy-zero 被当作缺失处理代码并未排除的边界上的差一错误重试风暴 / 部分失败丢了锚点的正则或白名单。这些场景意味着验证者不能以也许不会发生为由否决候选——这正是 high effort 与 medium 档位在验证哲学上的分水岭。5.2 REFUTED 的四种从代码可构造情形作为对照part 5 规定只有以下四种情况才允许给出 REFUTED且每条都必须从代码本身可构造、可引用情形证据要求事实错误引用实际代码行证明代码并非如此可证明不可能由类型/常量/不变量推出矛盾并展示推导本 diff 中已处理引用具体的守卫代码纯风格、无可观察影响不构成缺陷注意与 三态验证part 4 的差异part 4 的 CONFIRMED 要求能说出触发它的输入/状态以及错误输出或崩溃并引用该行PLAUSIBLE 要求机制真实、触发不确定时序、环境、配置并说明什么能确认它——这是 mediumprecision档位的更严口径而 high 档位的 part 5 把机制真实放宽为默认成立使更多不确定候选得以存活。六、输出一次 ReportFindings最多 10 条按严重度排序的结论输出契约由OUTPUT_FORMAT_FN(MAX_FINDINGS)注入来自 agent-prompt-code-review-part-10-reportfindings-output-format.md。high effort 档位的MAX_FINDINGS为10README 与 part 7 文件头描述均为up to ten JSON findings。6.1 调用方式审查结束时只调用一次ReportFindings 工具携带{level, findings}findings是最多 10 条、按严重度降序的数组。两点硬性约束验证后存活超过 10 条时只保留最严重的 10 条一条都没存活时以空数组调用不得再以文本形式打印结论不得创建或发布审查 artifact——工具调用本身就是报告这与 tool-description-report-code-review-findings.md 的描述一致。6.2 每条结论的字段字段含义file文件路径line起始行号summary问题的一句话陈述short_summary压缩到≤60 字符的断言不含理由或后果从句failure_scenario具体的失败场景category产生该结论的角度对应的短 kebab-case 标签verdict验证阶段产生的三态结论如有category的标准取值包括correctness、simplification、efficiency、reuse、altitude、conventions或更具体的标签如test-coverage。一个符合契约的结论条目示意字段结构来自上述文档{ file: path/to/file.ext, line: 123, summary: 错误处理分支中解引用可能为空的对象, short_summary: 错误路径空指针解引用, failure_scenario: 上游返回错误且 payload 缺失时 → 直接崩溃而非返回错误, category: correctness, verdict: CONFIRMED }七、high effort 在 /code-review 努力档位矩阵中的定位/code-review命令本身见 tool-description-code-review-command.md支持多档努力水平从少数高置信结论到许多部分不确定结论不传档位时复用你上一次输入的档位。结合本文与仓库中各档位文档可得到完整对照档位哲学角度数×候选上限验证方式结论上限关键文档minimal单次谨慎 diff 扫描1 次扫描无独立验证15partminimal modelow仅 hunk 可见的运行时正确性1 次 diff 扫描无验证4part 2 low effortmediumprecision精确率8 角度 × 6 候选三态验证8part 6highrecall召回率8 角度 × 6 候选召回偏向验证PLAUSIBLE 默认成立10本文part 7extra-high / maxrecall追加缺口清扫10 角度 × 8 候选单票验证 gap sweep由 MAX_FINDINGS 注入xhigh 内联默认 15part 3、skill-code-review-inline-xhigh-mode.mdextra-high/max 档位part 3在 high 的基础上再进一步正确性角度从 3 个扩到 5 个新增Angle D 语言陷阱专家与Angle E 包装器/代理正确性见 skill-code-review-angle-d-language-pitfall-specialist.md 与 skill-code-review-angle-e-wrapper-proxy-correctness.md候选上限从 6 提到 8并追加gap sweepskill-code-review-phase-3-sweep-for-gaps.md以全新审查者身份重读 diff只找尚未列出的缺陷最多再补 8 条不硬凑。由此可见 high effort 处于8 角度全覆盖 宽容验证的中坚位置角度覆盖与 medium 相同验证口径与 extra-high 同向是一次坐下来仔细审查能抓到的所有真实 bug的落点。八、实战配套--comment 与 --fix以及 Agent 不可用时的内联降级high effort 模式产出的结论列表还可以被命令开关进一步加工--commentPR 评论模式若审查目标是 GitHub PR逐条把结论发为行内 PR 评论每条一次mcp__github_inline_comment__create_inline_comment调用仅当建议块能完整修复问题时才附建议块工具不可用时回退gh api目标是 GitLab MR 时则以一条glab mr note汇总评论见 part 8 GitHub 与 GitLab 评论。非 PR 目标则打印结论并注明--comment被忽略。--fix修复模式产出结论列表后直接修改工作区——正确性 bug 与 reuse/simplification/efficiency 清理一并修复跳过会导致行为改变、超出 diff 范围或判定为误报的条目并逐条说明跳过原因见 part 9。--max-findings n/--max-findings all覆盖结论上限设置会持续生效直到显式传--max-findings default。Agent 不可用时的内联降级若会话中没有 Agent 工具AGENT_UNAVAILABLE_INSTRUCTIONS会切换为内联模式——在当前上下文中按顺序自行跑完各角度不派子代理、仅去重并自查、可选做 gap sweep同样以{level, findings}上报内联 medium/high 模板见 skill-code-review-inline-medium-high-template.md其 Phase 2 为仅去重、不验证、不重新评判。九、延伸阅读仓库中的相关文件导航如需把 high effort 模式的每一块拼图读全可按下列相对路径继续深入档位本体agent-prompt-code-review-part-7-high-effort-mode.md511 tokens注入块part 1 基础角度、part 4 三态验证、part 5 召回偏向验证、part 10 输出格式档位对照part 2 low、part 6 medium、part 3 extra-high/max、minimal mode技能化实现Phase 0 收集 diff、召回偏向验证、三态验证、gap sweep、角度 A–E、conventions 维度、efficiency 维度命令与工具契约code-review 命令说明、ReportFindings 工具总的来说high effort 档位是 Claude Code 在召回率与成本之间找到的平衡点用 8 个互不干扰的角度把候选池铺满再用默认可信、证据反驳的单票验证最大限度保留真实缺陷最后以 ≤10 条、按严重度排序的结构化结论交付给宿主 UI 渲染。理解这份提示词的拼装方式与验证哲学也能帮助你为自己的审查类 Agent 设计类似的多角度查找 宽容验证 结构化上报流水线。赞分享文档提示工程人工智能【免费下载链接】claude-code-system-promptsAll parts of Claude Codes system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.项目地址https://gitcode.com/gh_mirrors/cl/claude-code-system-prompts点击查看免费下载相关推荐解析 Claude Code /code-review 的 high 档评审提示词system_prompts_leaks 中的多视角代码审查流水线解析 Claude Code /code review 的 high 档评审提示词system_prompts_leaks 中的多视角代码审查流水线 本篇以文档知识库挖掘每个真实缺陷解读 Claude Code /code-review xhigh 档位的多角度高召回审查流水线挖掘每个真实缺陷解读 Claude Code /code review xhigh 档位的多角度高召回审查流水线 导读 xhigh 是 Claude Code文档知识库拆解 Claude Code /code-review 的 max 档系统提示词十角度并行发现、1 票三态验证与缺口扫描的召回优先审查流水线拆解 Claude Code /code review 的 max 档系统提示词十角度并行发现、1 票三态验证与缺口扫描的召回优先审查流水线 本文以 Anth文档知识库上一篇m4s转MP4终极指南如何永久保存你珍藏的B站视频下一篇终极指南5分钟掌握FanControl免费风扇控制软件彻底解决电脑噪音烦恼创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

读完文章,也想定制专属网站?

尧图设计师 24 小时内与您沟通定制方案

免费获取报价 →
↑