SuperAPI AI 工具集

review-pr-thread-verify

通用与其它

查看项目

更新于 10-16 05:48

技能介绍

用途:review-pr-thread-verify 用来判定某一条已发布的审查发现(review finding)在提出之后发生了什么变化。它由 review-pr 针对其作者提交的每个未解决审查线程调用,接收全部上下文,只做判断并返回结果,自身绝不发布、解决或编辑任何评论。

主要能力与接收内容:原始发现(锚点、正文、审查时对应的提交或 head SHA,以及所提出的具体问题);自上次发言以来作者在该线程上的全部回复,以及此前我们发布的所有回复;锚点处的当前代码及邻近上下文,以及原始审查后触及相关范围的提交;完整的 PR 历史(所有评论、审查线程、提交信息、当前 PR 描述、我们此前的审查与评论正文);每个关联 PR 的上下文(diff、描述、顶层对话);以及调用方的 voice profile,用于约束此处起草回复的写法。

判断方式:先固定具体问题,判断该失败模式是已消除、已认可、被证伪,还是依然存在,而不是判断线程是否被讨论过。代码变更只有在触及相关范围并消除该失败模式时才计入;回复只有在一位公正的人类审查者会认可时才计入。仅在有新信号(新的作者回复或代码变更)时推进,且只聚焦争议的具体点,不重复线程上已提出的论点。

返回的处置结论:addressed-by-fix,即审查后的提交修改了相关代码并消除了具体失败模式,直接明确的代码修复通常无需回复,除非此前有活跃讨论;addressed-by-valid-reply,即作者以公正审查者会认可的理由回复,起草简短认可;false-positive-or-stale,即我们的评论有误、过时或被当前 PR 历史证伪,起草简短更正并承认失误;needs-our-pushback,即作者已回复或改代码,但具体问题仍存在,针对该点起草简短回复;still-pending,即无相关新回复也无相关代码变更,不起草任何内容。

返回结构:处置名称、一条简短理由(证据为提交、回复或二者缺失),以及在需要时按所提供 voice profile 写成的回复草稿。限制:资料未提供具体安装方式、命令行用法、支持平台或收费信息。