SuperAPI AI 工具集

change-review-workflow

办公与效率

查看项目

更新于 10-15 21:41

技能介绍

用途:在一个连贯的完成节点上评估是否需要独立审查,而不是每次编辑或提交后都审查。单独的审查请求不授权进行修复、提交或发布。

选择审查范围:对照基线与预期结果检查完整变更,而非只看最后一处补丁。遵循明确指定的角色和调用方/仓库的强制门禁。可选范围包括:跳过(常规且易理解、无实质行为、契约、归属、结构或验证风险的变更);实现审查(实质正确性、验收、失败处理、兼容性、安全性或行为证明问题);质量审查(较大的结构或抽象变更,且无实质行为或契约不确定性);两者(同时存在行为与结构风险)。判断依据是后果与不确定性,而非文件后缀、行数或是否存在测试。跳过表示未运行独立审查,不是审查通过;仍须完成必需的本地检查。

运行所选角色:确定任务、基线与 head。Harness 审查 merge-base(base, head)..head,不含暂存、未暂存和未跟踪变更;本地工作须使用获授权的临时审查 ref/commit,否则报告未覆盖范围,且不得为运行器提交无关工作。查找可用的 harness、.harness/bin/harness 或源码可执行文件,并查看帮助中的标志。使用 --steps implementation、--steps quality 或 --steps implementation,quality;不带参数的命令默认两者,但这不是每个任务都必须运行两者的要求。相关时加上 --plan。审查可能耗时最多约 20 分钟,小任务每 1–2 分钟轮询,较大任务每 3–5 分钟轮询,而非每 30 秒。运行器不可用时报告限制,不得声称 Harness 已运行。

发现与修正:只报告有证据表明对验收任务有具体后果的发现,合并重复问题并保留来源,省略吹毛求疵与推测性加固。阻塞项须说明为何妨碍安全验收。实质发现给出有证据支持的 Implement、Adapt 或 Decline 处置;获授权修正时做最小修正并运行相关检查。

后续与完成:只重跑结论可能被实质推翻、需独立确认阻塞项或执行失败的角色;不因 HEAD 变化而重跑。总运行次数最多三次(初次加两次后续)。完成条件是所选必需角色通过、实质发现已解决或有证据处置,且后续编辑未使证据失效。发布是独立步骤,需要任务授权。

限制:本地未提交变更不在默认审查范围内;运行器与仓库级权限、审查范围及可用性受环境约束;资料未提供具体收费、价格或平台信息。