用途:review-pr-judgment 由 review-pr 在两种模式下调用,做整体 PR 的前提判断,而非行级缺陷检查。它回答一个问题:该变更的存在、方案与影响面,是否对得起它声称解决的痛点,痛点所需的东西是否缺失。
主要能力:接收 PR 描述、PR 讨论、代码库方向、完整 PR head 差异(base..head),在 manifest 模式下还接收 manifest 的 Intent 作为所述痛点。它始终以整个 PR 为高度,不针对单个未用参数或窄小辅助函数。触发条件包括:必要性(重复已有能力、守卫不可能发生的条件、无真实消费者)、痛点不可重建、影响面不成比例、存在更简单直接的方案、遗漏痛点必需项、触及单向门表面(schema 迁移、公共 API 签名、持久化格式、安全边界)、引入会被复制的模式。每条发现只含触发条件、具体证据、面向作者的问题,不带严重级别。
使用方式:由 review-pr 调用,调用方决定运行位置并将生成限制为每个 PR 一次;发现通过现有单批审查与隐藏自标记发布,不新增发布路径。
限制:非阻塞,永不阻止合并、不提交 request_changes、不自动批准;manifest 模式下严格附加,不影响 manifest 契约的 PASS/FAIL 计算。证据不足时保持沉默,不因个人偏好触发。多个触发指向同一根因时合并为一个问题。