SuperAPI AI 工具集

review-panel

智能体与模型

查看项目

更新于 10-15 21:52

技能介绍

用途:让未参与创作、且不共享创作会话上下文的评审者审查产物,再由主导者依据产物中的证据判定每条发现的价值,形成判定表,标注每条重要发现为有效、部分有效或驳回,并附已核查证据、在授权范围内应用的修复、重跑的检查以及需要用户回答的问题。发现是否成立只看产物中的证据,不看有多少评审者提出;评审者一致可能共享同一前提,单个有证据支撑的发现优先于两个无证据的一致意见。

覆盖范围:代码与 diff、研究与系统设计、设计文档、评估与结果、PR 正文与 Notion 页面等文档、计划与意图对照、技能与技能包、运营流程或系统。邻近请求应分流:在 GitHub PR 上发布内联评论属于 pr-review-comment;对已建成评估、基准、评判器或结果给出发布、暂停或报告结论属于 evaluation-audit;攻击某个既定想法属于 idea-critique;无需独立评审者的快速自检直接检查即可;大型产物拆分给多个评审者时由 orchestrate-subagents 提供调度机制。

选择评审者:用户明确指定评审者、模型或数量时以其为准。否则在两个模型族都可触达时使用两个不同模型族的评审者,通常为 Claude Fable 与 GPT-6 Astra;安装 codex-delegate 且用户点名 Codex 或要求跨族评审时,通过 Codex 以只读沙箱运行 GPT-6 Astra;其余席位用任意可信模型的独立子代理,评审者上下文干净时可用会话自身模型。模型与投入程度可用 model-routing 选择,否则用用户路由策略或框架默认值,并说明最终设置。请求的模型族无法触达时应说明并指出缺失的覆盖,不得静默替换。评审者一律只读:不编辑、不提交、不发布到 forge 或跟踪器、不运行改变状态或消耗预算的操作,未经用户授权不得联网。

选择标准与轴:按产物类型选择标准,并在拥有该产物的技能已安装时借用其标准,如代码用 coding-standards、设计用 design-doc 与 idea-critique、评估用 evaluation-audit、文档用 copydesk 与发布技能、计划对照用 work-plan 评审模式、技能用 skill-builder;拥有者技能缺失时直接把标准写入 packet。代码与设计分两个独立上下文审查两条轴:保真度(是否做到被要求或设计的事)与标准(是否符合适用标准)。保真度需要指定修订版本的意图来源;没有则说明主导者理解的意图并在 packet 中标记为待验证假设。轴与评审者相乘,四个上下文(每个模型族各负责一条轴)覆盖最强,两个上下文成本减半但失去每条轴的跨族检查;按漏检缺陷的代价选择,并在报告中说明所选覆盖。

编写 packet:每条轴写一个 packet,同一轴发给每位评审者同一份,使发现差异来自评审者而非 packet。packet 说明:审查对象(路径、修订或提交、diff 范围、范围外内容);产物存在的原因(目的、所有者目标、读者或用户);轴及其标准;覆盖旧记录的当前规则;限制(只读访问、网络、时间);要求的回复(按影响排序的发现,每条含 path:line 证据、为何重要、具体修复;已检查且无问题的部分;针对既定目的的结论)。不要把主导者结论放进 packet,待验证的怀疑只能作为假设标记。第一轮不要把某位评审者的发现传给另一位。

判定:在产物本身核实每条重要发现,打开引用位置、阅读适用规则或意图来源、运行能显示问题的低成本检查。评审者的引用只是线索而非证据。然后标记:有效(问题如所述存在,应用所提修复或更好修复);部分有效(问题真实但原因、范围或修复有误,记录成立与不成立之处并应用修正后的修复);驳回(该修订下问题不存在、引用位置说明相反,或与更新的用户决定或当前规则冲突,记录原因与证据)。需要未获授权的测量或访问才能定论时,列为待调查项并附可定论的检查。主张当前规则本身有误的发现作为问题交给用户。重复项合并为一条并列出所有提出者,判定只来自检查。绝不按一致程度分组、排序或加权,按对产物目的的影响排序。驳回的发现保留在表中并附原因。非重要项如措辞偏好,明显正确且在范围内可应用,否则用一行原因丢弃。要求新增测试的发现按项目测试政策判断,本包默认不新增测试。判定表列为 ID、发现、提出者、已核查证据、判定、行动,较长推理写在旁边注释。

应用与重查:用户要求查看或修复影响重大时,先展示判定表再应用。否则在用户已授予的范围内应用有效与部分有效修复,并重跑覆盖它们的检查。用户的问题连同判定表尽早一并提出。仅审查请求或审查他人产物时,返回判定表与建议修复而不编辑。修复大范围改变结构或行为时值得进行第二轮。

处理人工评论:PR、文档或设计上的人工评审评论遵循同一规则,先对照产物核实再实施;不清楚的先问再实施相关项;评论对本产物有误时用证据回应;与用户先前决定冲突的交给用户;回复只陈述修复或证据,不做表演式认同;在 forge 或跟踪器上回复或解决线程属于外部写入,需用户批准。

报告:先说明审查对产物下一步意味着什么,再给出判定表、已应用变更及路径、重跑的检查及结果、驳回的发现及原因、待调查项与用户问题,以及本次评审面板的运行情况:评审者、模型与投入、轴、授予的访问权限、独立性与覆盖的任何损失。

限制:资料未提供具体安装命令、收费与价格信息;评审者模型可用性取决于当前框架与已安装技能。