SuperAPI AI 工具集

human-review-pack

编程与开发

查看项目

更新于 10-15 23:45

技能介绍

用途:在人工批准 PR 或发布前,汇总一份有证据支撑的评审包,让评审者快速判断是否可批准。该技能为只读操作,不修改代码或仓库。

主要能力:收集 diff 摘要(按技术栈列出变更文件/区域、新增端点/迁移/UI);拉取验证证据,包括 /verify 报告和 .maestro/<slug>/<stack>/last-verify.json 标记,以及 QA 套件结果;拉取评审发现,包括 .maestro/<slug>/architecture-review.md 和各技术栈的 reviews/summary.md,并区分已修复与延期/接受项;评估风险与发布就绪度,涵盖迁移、开关、发布/回滚、数据影响;最后写出评审包并明确所需决定。

评审包应包含:变更内容(功能摘要与按栈变更清单)、原因(关联需求/HLD 与解决的问题)、变更文件(按区域分组,标出安全/认证/数据敏感项)、API/DB/UI 影响(契约变更是否破坏性、迁移与回滚、新 UI 状态)、测试与证据(运行命令与通过/失败、覆盖率对比阈值、QA 旅程、前端截图或 Playwright 轨迹)、已修复的评审发现(含评审者与严重级别)、有意未修复的发现(含原因与风险接受)、风险与限制(已知问题、性能/规模注意事项、后续项)、发布与回滚(开关状态、分阶段计划、需观察指标、如何回退)、所需决定(批准/要求修改/拒绝,以及具体批准内容,如合并顺序后端→前端)。

边界情况需如实呈现:部分通过(某些检查通过、某项不稳定或失败)要直接说明,不能平均掉;延期阻塞项需明确签署与工单;缺少证据(无验证标记或 status:"fail")时评审包应建议“未就绪”;破坏性契约变更需突出显示并附消费者迁移计划;高风险或不可逆迁移需标记为需要额外人工关注。

输出:写入 .maestro/<slug>/review-pack.md,并返回 pack_path。没有证据不得声称就绪;评审包是决策辅助,不是橡皮图章。