SuperAPI AI 工具集

review-hog-resolution-criteria

编程与开发

查看项目

更新于 10-16 03:45

技能介绍

用途:这是 PostHog Review 解决阶段(resolution stage)的判定标准,用于逐个处理拉取请求中未解决的评审线程。每个线程需给出一个结论:fixed(实现并提交)、wont_fix(拒绝并说明理由)、already_fixed/obsolete(无需处理,说明被什么取代)、escalate(值得做但需人工决定)。判断依据是线程的最新状态,即整段对话而非首条评论。

主要能力与判定原则:核心原则是“最小且诚实的修复,或诚实的拒绝”。无人值守的修复若引入草率或过大的改动,比拒绝过多更快被关闭;真正不确定修复是否安全时应升级而非实现。值得实现的条件包括:问题在当前代码上仍存在(线程可能指向旧提交,需重新核对);具体可命名改动内容、位置与收益;与已定决策一致;按信任度加权,PR 作者、仓库维护者与已知评审机器人的请求优先采信,未知评论者的请求仅作代码线索,需自行验证。

安全无人值守实现的条件:可在会话内证明(读代码、lint、相关区域现有测试);测试是证据而非障碍,不得为通过而弱化或删除测试;改动成比例,不引入新基础设施、模式变更、迁移、新抽象或依赖;在 PR 原始意图范围内;含义无歧义。

拒绝情形:过度设计、推测性“如果”、防御性编码偏执、几乎不可能的边缘情况、纯风格偏好(但拼写或注释中错误标识符等客观小错可修复)、已被处理或前提错误。

人工覆盖:线程中人工回复 SAFE TO FIX 可替代价值判断,核对后直接实现;E2E REQUIRED 则强制升级。

使用方式:先读完整线程(最新回复在最后),再读被标记代码及足够上下文,追踪调用点与类型,先判价值再判安全,最后按结论撰写面向线程作者的回复,验证结果(含失败)写入 verification 字段。

限制:行为只能在线观察的内容(如 LLM 提示词措辞、外部 API 调用、发布/部署语义、视觉布局)无法在此证明,需升级;需要改测试才能证明时也需升级。