用途:对单个变更集执行只读、多智能体代码审查。可接受 GitHub PR URL 或编号、分支、显式 base/head 对、Git 范围或当前分支。默认审查已提交变更并在当前智能体会话中报告;仅当用户明确要求时才纳入暂存、未暂存或未跟踪内容,且仅当目标是 PR 并明确要求发布时才发布 GitHub 审查或评论。绝不修改工作树、修复问题、推送、批准、请求更改、合并或关闭目标,除非用户另行授权。
运行前提:需要真实的独立子智能体能力。先检查运行时的委派 schema 与并发上限;仅当暴露原生子智能体和真实模型选择器时才使用,否则将模型记为继承或未知。一个可用子智能体即可:按波次顺序运行专家与验证者角色。若无独立子智能体,报告 BLOCKED,并说明普通内联审查只能在该技能的独立性契约之外进行。绝不在单一上下文中模拟多个独立审查者。
解析目标:PR 用 gh pr view 解析仓库、元数据、base SHA 与 head SHA;显式 base/head 用 git diff <base>...<head> 验证;显式 Git 范围保留用户的两点或三点语义;仅 WIP 请求以当前 HEAD 为锚点,提交比较 diff 定义为空;命名或当前分支无 base 时,先查关联 PR,否则检查默认分支与上游配置,询问用户比较对象,绝不静默假定 main、master、develop 或上游跟踪分支。
工作流:确认独立子智能体能力后解析目标;PR 目标确认本地仓库匹配远程,必要时只读克隆到临时目录;仅 PR 目标检查资格,跳过已关闭、草稿、自动化、明显琐碎或已审查的 PR,除非用户要求重跑;从 PR 文本、分支名、提交信息、关联 issue、用户路径与仓库文档中发现来源 issue、PRD 或规格,记录权威来源与验收标准,无正式来源时仅用用户明确意图并注明缺口;构建中立证据包;将六个专家审查分派给独立子智能体,使用最小任务局部上下文,按并发上限并行、必要时分波,专家之间不得看到彼此结论;合并、去重、规范化候选发现,拒绝变更行之外的内容,除非变更代码直接导致问题;用独立置信度子智能体验证每个可操作候选;仅保留评分至少 80 的可操作发现;报告前刷新目标 head SHA 并重跑 PR 资格;若 head 或明确纳入的工作树证据变化,刷新证据并重新验证。
六个专家角色:标准与设计信号(读取适用的 AGENTS.md 与 CLAUDE.md,仅标记变更集引入的具体标准违规,并检查 Fowler 坏味道基线,通用坏味道视为建议性判断而非缺陷);正确性(检查 diff 与最小周边代码,识别运行时、数据、安全、并发、状态或边界缺陷,避免风格反馈与推测性改进);规格保真(对照来源 issue、PRD、规格与验收标准,识别缺失、部分、错误或未请求行为,引用确切需求并展示可观察不匹配,不推断未声明需求);历史与 blame(检查 git blame、相关提交与周边历史,识别有历史证据支持的回归或违反不变量);先前 PR(有 GitHub 远程时查找修改相同文件或行为的先前 PR 并检查其审查讨论,否则跳过并记录验证缺口);代码契约(读取变更代码直接引用的注释、测试、类型、schema、ADR 与附近不变量,验证变更保持这些契约)。
每个专家返回零个或多个候选,包含:简洁问题陈述;严重性 P0、P1、P2 或 P3;确切变更文件与行范围;具体失败场景;主要证据与来源链接;为何由本变更集引入;发现它的审查视角。候选分类为正确性、规格或设计信号,以及可操作或建议性。可操作候选包含上述全部字段;建议性设计信号包含命名坏味道、确切变更位置、证据、维护权衡及为何值得注意,不得使用 P0-P3 严重性,也不得表述为必需更改。
置信度验证评分标准:0 为误报、无支持、先前存在或与证据矛盾;25 为合理但未验证,可能风格化或推测;50 为真实但次要、罕见或相对变更集不够重要;75 为极可能且重要,但仍有一项实质不确定性;100 为直接证据证明频繁或确定性实质失败,或证明具体指令违规。验证者须检查问题由审查目标引入、实际可达、未被其他地方阻止、位于变更行。过滤低于 80 的可操作评分。建议性设计信号不作为缺陷评分。
应拒绝的误报:非变更集引起或暴露的先前存在问题;符合审查目标声明目的的有意行为;格式化、lint、类型、编译器或测试失败等工具会直接报告的问题;无具体缺陷的通用更多测试、文档、重构或加固请求;适用指令未明确要求的风格偏好;无可达失败路径的理论安全或性能担忧;被有意且合理局部指令静默的问题;同一根因的重复症状。除非用户要求,不运行构建、linter、类型检查或测试套件;静态审查不应声称这些门禁通过。
输出:按顺序使用三个部分:正确性、规格、设计信号。前两部分以可操作发现开头。每个可操作发现提供:[P1] 简短祈使标题 — 90 置信度;为何在实践中失败,包括触发场景;变更行链接:可用时为完整 SHA 的 GitHub URL,否则为绝对本地文件链接;证据:适用指令、历史、先前 PR、评论、测试、类型、schema 或代码契约。设计信号中先以可操作格式列出已验证的可操作仓库标准违规,再提供建议性坏味道,含坏味道名称、位置、具体证据与维护权衡,明确标注为建议性。建议性设计信号不得取代、夸大或改变正确性或规格发现的严重性。有 GitHub 远程时,在 GitHub blob 链接中使用完整提交 SHA 与紧凑行范围并至少一行上下文;无 GitHub 远程时,使用带行号的可点击绝对本地文件链接;明确纳入的未提交变更使用本地文件链接并标注不稳定。发现之后添加紧凑的审查覆盖说明,并明确说明任何不可用的 PR 元数据、先前 PR 上下文、规格来源或发布能力。当目标是 PR 且用户明确要求发布时,发布一条仅含存活发现的简洁 PR 评论;发布前立即重新检查 head SHA;若无发现存活,除非用户明确要求无发现评论,否则不发布。非 PR 目标在当前会话报告,并说明 GitHub 发布需要 PR。