ARTICLE DETAIL

资讯详情

深耕网站视觉设计与运营推广的一线实战洞察。

挖掘每个真实缺陷:解读 Claude Code `/code-review` xhigh 档位的多角度高召回审查流水线

挖掘每个真实缺陷:解读 Claude Code `/code-review` xhigh 档位的多角度高召回审查流水线 挖掘每个真实缺陷解读 Claude Code/code-reviewxhigh 档位的多角度高召回审查流水线【免费下载链接】system_prompts_leaksExtracted system prompts from Anthropic - Claude Fable 5.1, Opus 5, Claude Design, Claude Code. OpenAI - ChatGPT GPT-6-Astra, Codex. Google - Gemini 3.8 Flash, 3.1 Pro, Antigravity. xAI - Grok, Grok Bot, Cursor, Kimi and more! Updated regularly.项目地址: https://gitcode.com/GitHub_Trending/sy/system_prompts_leaks导读xhigh是 Claude Code 内置/code-review技能skill中仅次于max的高强度代码审查档位其提示词被设计成一条面向高召回recall的完整审查流水线先以 10 个相互独立的“查找角度”并行寻找候选缺陷再以“单票三态”验证去伪存真随后补一轮缺口清扫最终输出最多 15 条、按严重度排序的结构化 JSON 结果。阅读本文后你将能理解该流水线每个 Phase 的设计意图与执行细节、10 个查找角度的分工差异以及它与low/medium/high/max各档位之间在候选数量、角度数量与验证策略上的量化差别并学会在复现或移植这套审查方法论时正确复刻其每一步骤。本文的文档主体为 Claude Code skill 目录下的 xhigh.md并以其同目录姊妹文档 README.md、SKILL.md、max.md 及 report-findings-tool.md 作为交叉佐证。一、文档定位xhigh 是/code-review的五档流水线之一在 code-review/README.md 的“Files”表格中xhigh 被明确列为/code-review的默认提示词档位矩阵的一员提示词文件流水线特征low.md1 遍 diff 直读、无子代理、无验证 → ≤4 条medium.md8 个查找角度 × 6 个候选、单票验证精度倾向→ ≤8 条high.md8 个查找角度 × 6 个候选、单票验证召回倾向→ ≤10 条默认档xhigh.md10 个查找角度 × 8 个候选、验证 缺口补扫 → ≤15 条max.md与 xhigh 逐字相同仅首行措辞不同由 API 推理档位区分xhigh 与 max 在提示词层面内容完全一致。对比 xhigh.md 与 max.md 可以确认两者仅在首行标头xhigh effort → …/max effort → …上不同。也就是说用户切到max时真正变化的只是底层模型的 API reasoning effort审查指令本身保持同一套 xhigh 级流程。此外README.md 说明这五个文件是模型家族没有专属提示词时的default列内容实际下发哪一份还会依据模型家族路由例如claude-sonnet-5、claude-opus-4-8、claude-opus-5各有不同的单元格覆盖。这也提醒读者xhigh.md 描述的是该档位在“默认列”下的完整形态。二、总览xhigh 的单行流水线摘要文档开头的第一行就是整套流程最凝练的摘要xhigh effort → 55 angles × 8 candidates → 1-vote verify → sweep → ≤15 findings拆解为55 angles10 个独立的查找角度finder angles其中前 5 个专职于正确性缺陷correctness后 3 个为清理项cleanup另加 1 个“实现深度”角度与 1 个“约定符合性”角度× 8 candidates每个角度最多产出 8 条候选发现1-vote verify每个候选只跑一次验证三态投票详见 Phase 2sweep验证后追加一轮“缺口补扫”以独立的新审查者身份寻找漏网之鱼≤15 findings最终输出上限为 15 条 JSON 对象。定位陈述同样直白xhigh 为召回recall而审查——“catch every real bug”。在这一档位漏掉真实缺陷missed bug ships的代价大于误报false positive因此策略整体倾向“宁可多报”Err on the side of surfacing。这与 medium 档“precision精度导向、只报维护者会行动的发现”形成鲜明对照见 medium.md。三、Phase 0 —— 收集审查对象把 diff 当作审查范围在进入任何查找角度之前必须先确定“审什么”。Phase 0 的规则是xhigh.md优先执行git diff {upstream}...HEAD获取待审查的 unified diff若没有 upstream退而使用git diff main...HEAD或git diff HEAD~1若存在未提交改动或上述 range diff 为空则再执行git diff HEAD把工作区working-tree改动一并纳入审查范围——文档特别点明审查往往发生在提交之前the review often runs before the commit如果传入的参数是 PR 编号、分支名或文件路径则改审该目标最终把这份 diff 视为本次审查的全部范围review scope。这一阶段的实用性在于兜住三类典型场景尚未 commit 就发起的本地审查、已推到远端分支的 PR、以及只针对单个文件/路径的定点复查。四、Phase 1 —— 用 10 个独立查找角度寻找候选核心约束是两条xhigh.md每个查找角度通过Agent工具独立运行各自最多产出8 条候选每条候选含file/line/summary及具体failure_scenario角度之间不得互相压制即便两个角度针对同一行代码、因不同原因都报了问题也要两条都记入Do NOT let one angles conclusions suppress anothers。同时文档提供了降级条款如果当前工具集里没有Agent工具不得报错——改为在当前上下文里按顺序自行逐一执行每个角度以及后续的每次验证。4.1 正确性五角度Angle A–EAngle A —— 逐行 diff 扫描line-by-line diff scan逐行阅读 diff 的每个 hunk然后回读每个 hunk 所在的封闭函数。注意这里的审查边界被刻意放宽被改动函数中未改动行上的缺陷也属于审查范围——因为“PR 重新暴露了它或者没有修复它”。对每一行都要追问什么样的输入、状态、时序或平台会让这行出错并重点寻找条件倒置/写错inverted/wrong conditions、off-by-one、空/未定义解引用、缺失await、falsy-zero 误判、复制粘贴错变量、catch 里吞掉错误、正则元字符未转义。Angle B —— 删除行为审计removed-behavior auditor对 diff 中每一条被DELETE或替换的行先命名它所强制执行的不变量或行为再到新代码里寻找该不变量在哪里被重新建立。若找不到即是一条候选被删掉的守卫、丢失的错误路径、被收窄的校验、以及一条原本在覆盖真实用例却被删除的测试。Angle C —— 跨文件追踪cross-file tracer对每个被改动的函数用 Grep 找到它的所有调用方检查改动是否破坏调用点新增前置条件、返回值形状改变、新增异常、时序/顺序依赖。同时反向检查被调方callees同一 PR 内并行的改动是否让某次调用变得不安全。Angle D —— 语言陷阱专家language-pitfall specialistxhigh/max 独有扫描 diff 所用语言/框架的经典陷阱文档给出的清单包括JavaScriptfalsy-zero0被当作缺失、隐式强转、闭包捕获循环变量Python可变默认参数、闭包晚期绑定Go向 nil map 写入、range 变量捕获SQL注入其他时区/DST 漂移、浮点相等比较。凡 diff 引入的实例都要标记。Angle E —— 包装/代理正确性wrapper/proxy correctnessxhigh/max 独有当 PR 新增或修改一个包装其他类型的类型cache、proxy、decorator、adapter时检查每个方法是否都路由到被包装实例而不是绕回 registry/session/global。文档给出一个极具代表性的反例一个缓存 provider 持有delegate字段但内部却用session.get(...)而非delegate.get(...)来解析 ID就会重新进入缓存或无限递归。同时还要检查包装层是否把调用方真正使用的方法全部转发完整。4.2 清理与架构三角度Reuse / Simplification / Efficiency这三个角度专职在被改动代码中寻找清理机会不查正确性Reuse复用标记新代码“重复实现了代码库已有的东西”——Grep 共享/工具模块以及改动相邻目录中的文件并指名应调用的现有 helperSimplification简化标记 diff 引入的多余复杂度冗余或可推导的状态、带微小变体的复制粘贴、过深嵌套、遗留死代码并点出能达到同样效果的更简形式Efficiency效率标记 diff 引入的浪费重复计算或重复 I/O、可并行却串行的独立操作、被塞进启动路径或热路径的阻塞工作。此外专门提到一类内存泄漏模式由闭包或捕获环境构造的长生命周期对象会令整个外围作用域随对象的生命期一起存活当该作用域持有大对象时即构成泄漏应优先改用只拷贝所需字段的 class/struct并给出更省的替代方案。4.3 Altitude实现深度检查每个改动是否实现于正确的深度而非脆弱的创可贴叠加在共享基础设施上的特判special case往往是修复不够深的信号——相比“增加特判”更应倾向泛化底层机制。4.4 ConventionsCLAUDE.md 约定审计按文档定义Conventions 角度的正确执行顺序是先找到管辖被改动代码的全部 CLAUDE.md——用户级~/.claude/CLAUDE.md、仓库根 CLAUDE.md以及任何位于被改动文件祖先目录中的 CLAUDE.md 或 CLAUDE.local.md目录级 CLAUDE.md 只约束其下及其子目录内的文件逐一读取后检查 diff 是否存在对其中规则的明显违反。约束非常严格只有能同时引用精确规则原文与被违反的精确行时才允许报违反项——不报风格偏好不做“文档精神”式的模糊推断上报时必须在 finding 中点名 CLAUDE.md 路径并引用规则原文便于报告引用。若没有适用的 CLAUDE.md本角度返回空。4.5 汇总与排序约束清理、深度与约定类候选沿用与正确性相同的file/line/summary结构唯一区别在failure_scenario中应陈述具体代价哪里重复、哪里浪费、哪里更难维护、或违反了哪条 CLAUDE.md 规则而不是崩溃描述。当输出上限被迫裁剪时正确性缺陷永远优先于清理、深度与约定类发现。五、Phase 2 —— 单票三态验证1-vote, 3-state先去重指向同一行/同一机制、且理由相同的候选合并保留 failure scenario 最具体的一条。随后对每条剩余候选通过Agent工具运行一次验证器one verifier输入为 diff、相关文件与候选输出严格限定为以下三态之一xhigh.mdCONFIRMED—— 能指名触发它的输入/状态、以及错误的输出或崩溃须引用具体代码行PLAUSIBLE—— 机制真实存在但触发条件不确定时序、环境、配置须说明什么条件下可确认它REFUTED—— 事实有误代码并非如此或在别处已被守卫须引用能证明该结论的代码行。保留规则高度宽松CONFIRMED 与 PLAUSIBLE 均保留只丢弃 REFUTED。文档明确警告这是召回模式——“一个未被 REFUTED 的投票即可保送该发现不要在不确定性上自行丢弃”a single non-REFUTED vote carries the finding; Do NOT drop on uncertainty。将这一验证策略与 high.md 对比会发现high 档多了一句显式的“PLAUSIBLE by default”清单并发竞态、罕见路径上的 nil/undefined、falsy-zero 视为缺失、未排除边界的 off-by-one 等均属 PLAUSIBLE而 xhigh 档的写法更为精简但同样是单票召回偏置——这也与 Phase 1 的“各角度独立上报、不得互相压制”在设计上前后呼应。六、Phase 3 —— 缺口补扫gap sweep这是 xhigh/max 独有的一道工序high 档没有。以“持有已验证清单的全新审查者”身份再运行一次 finderxhigh.md重新通读 diff 与其封闭函数只找尚未列出的缺陷不去重复推导或重新确认清单上已有的内容。文档提示第一轮最容易漏掉的模式包括被移动/提取的代码丢掉了守卫或锚点二线坑点second-tier footgunsdataclass 默认值只求值一次、hash()非确定性、锁作用域被缩小、带副作用的谓词方法测试中的 setup/teardown 不对称配置默认值被翻转。本轮最多补报8 条新候选若确实没有新发现返回空 sweep禁止凑数do not pad。七、输出契约结构化 JSON 与优先级裁剪无论候选规模多大最终都输出最多 15 个对象的 JSON 数组xhigh.md每条对象结构固定[ { file: path/to/file.ext, line: 123, summary: one-sentence statement of the bug, failure_scenario: concrete inputs/state → wrong output/crash } ]约束要点按严重度降序排列Ranked most-severe first超过 15 条存活时只保留最严重的 15 条若无一存活返回[]即使环境中存在ReportFindings工具也禁止调用——本次审查的输出契约就是上面这段 JSON 块。值得注意的是该 JSON 仅是“默认列”的输出通道。根据 report-findings-tool.md 与 code-review/README.md 的说明二进制内还存在一个姊妹变体当宿主 UI 能渲染类型化发现时会附加ReportFindings工具其 schema 中带level/findings每条 finding 可含short_summary≤60 字符、category、verdictCONFIRMED/PLAUSIBLE、outcomefixed/skipped/no_change_needed等扩展字段上限为 32 条以及将发现渲染为可分享 HTML 的工作流编排形态。xhigh.md 的“一律输出 JSON”指令仅在未启用这些替代通道的前提下成立。八、调用方式与触发入口xhigh不是单独存在的工具而是 Claude Code 内置/code-review斜杠命令的档位参数。综合 SKILL.md frontmatter 与 code-review/README.md 的用法说明/code-review xhigh [target]level为low、medium、high默认、xhigh、max之一target可选PR 编号、分支、ref range如main...HEAD或具体路径附加选项--comment将发现作为 PR 内联评论发布--fix在审查结束后把发现应用到工作区不带任何参数时注入的提示块直接以档位头部开始带参数时提示块前会加上Review target: args前缀与空行SKILL.md 还说明--fix的应用动作发生在审查输出之后属于独立工作流。档位在交互期间也可被记录为会话上下文在相关模型提示如 statusline-setup.md中可以看到会话的 live effort 等级字段同样取low | medium | high | xhigh | max这五个枚举值xhigh正是最高本地推理档位之一。无 Agent 工具的降级路径同目录所有档位含 xhigh都内置了无子代理兜底README.md 说明当Agent工具缺失时同样的角度改为内联、单遍执行且不进行子代理验证。这与 xhigh.md 自身的降级声明一致不得报错而是由当前模型依序自行跑完每个角度。九、xhigh 与相邻档位的量化差异把 xhigh 放入同一坐标系可得出清晰的档位梯度依据 code-review/README.md 的 Files 表与各文件首行维度mediumhigh默认xhighmax审查目标precisionrecallrecallrecall查找角度数8810新增 D/E 两角度同 xhigh每角度候选上限6688验证单票单票召回偏置单票三态单票三态缺口补扫 sweep无无有最多补 8 条同 xhigh输出上限≤8≤10≤15≤15与 xhigh 的关系———与 xhigh 仅首行措辞不同由此可见 xhigh 相对默认的 high 档提升体现在三处可量化的环节角度数 2引入语言陷阱与包装/代理两个正确性专项、每角度候选上限 2、验证后追加一次缺口补扫——最终输出上限从 10 条放宽到 15 条。而max在提示词上与xhigh完全同构二者差异只在模型 API 的推理强度上这解释了为何 README 称 xhigh/max 属于同一档提示词内容的不同“标签”。十、方法论复盘这套流水线对工程实践的启示抛开其作为 Claude Code 内置提示词的用途xhigh.md 本身是一份可迁移的高召回代码审查方法论模板值得在人工或团队 Code Review 流程中借鉴的要点包括用多角度并行取代单遍通读把“正确性”拆成逐行、删除行为、跨文件、语言陷阱、包装代理五个正交子任务降低单一视角的系统性盲区设置“报告不设防”机制各角度独立、互不压制宁可候选冗余交由验证阶段统一裁决——xhigh 里“不要自行丢弃半信半疑的候选”这一规则在 high 档显式写出是减少漏报的关键设计强制显式的三态结论每条候选必须以 CONFIRMED/PLAUSIBLE/REFUTED 终态收口且 REFUTED 必须引用证明行迫使验证者给出可审计的证据而不是模糊感受单票召回偏置 输出上限裁剪验证阶段对不确定性宽容PLAUSIBLE 保留最终靠“最严重 15 条”的硬性裁剪保底可用性让召回与信噪比在出口处达成平衡单独的补漏轮把“寻找盲区”与“逐条确认”彻底分离专门盯防移动代码丢守卫、锁作用域缩小、配置默认值翻转等第一轮系统性漏点清理项与正确性分轨Reuse/Simplification/Efficiency/Altitude 与正确性分开上报且裁剪时正确性优先——避免风格争论淹没真实缺陷。若要在自己的项目中复刻这套流程可将 xhigh.md 的 Phase 0–3 作为评审协议文本把 10 个角度交给不同的独立 Reviewer人或 AgentPhase 2 的验证、Phase 3 的补扫照其原样执行最终以相同 JSON 结构汇总——这正是该仓库所抽取的系统提示词在工程方法论层面最大的复用价值。参考资料本文主体Anthropic/claude-code/skills/code-review/xhigh.mdSkill 注册与默认档位说明Anthropic/claude-code/skills/code-review/SKILL.md档位矩阵与模型路由说明Anthropic/claude-code/skills/code-review/README.md交叉对比文件high.md、medium.md、low.md、max.md替代输出通道 schemaAnthropic/claude-code/skills/code-review/report-findings-tool.md【免费下载链接】system_prompts_leaksExtracted system prompts from Anthropic - Claude Fable 5.1, Opus 5, Claude Design, Claude Code. OpenAI - ChatGPT GPT-6-Astra, Codex. Google - Gemini 3.8 Flash, 3.1 Pro, Antigravity. xAI - Grok, Grok Bot, Cursor, Kimi and more! Updated regularly.项目地址: https://gitcode.com/GitHub_Trending/sy/system_prompts_leaks创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
返回列表