SuperAPI AI 工具集

merge-risk

编程与开发

查看项目

更新于 10-19 17:54

技能介绍

用途

merge-risk 用于在合并 PR 之前评估合并风险,给出低、中、高三档风险结论,并列出各类别中会抬高风险的具体缺口。它的输出适合作为代码审查流程中的决策辅助材料。

主要能力

该技能按五个类别逐项评估:

  • 对齐(Alignment):代码是否与描述及来源问题一致;存在行为假设或顺带改动时,需要有记录。
  • 影响(Impact):改动范围是否受控、是否远离敏感代码路径。需要评估爆炸半径,包括布局偏移、对使用方造成的破坏、移动端适配等可能性。认证、权限、支付、PII、密钥、数据迁移、依赖升级、基础设施或配置变更等敏感区域,即使 diff 很小也风险偏高,需要标注出来;任何扩大访问范围、削弱校验或记录敏感数据的行为都要指出。
  • 验证(Verification):行为是否经过验证。用户体验改动需要截图或录屏作为端到端证据;可能显著影响性能的改动需要性能剖析;优先给出前后对比证据。边界情况需要测试,未测试时需要文档说明,并链接到相关代码。覆盖不足即视为失败。
  • 回滚成本(Rollback cost):合并后是否可逆。需要区分单向门与双向门:双向门可以退回,单向门不能。破坏性操作或难以逆转的决策属于单向门。
  • 错误检测(Error detection):关键流程是否有监控,故障能否在用户报告前被发现;需要留意吞掉错误或掩盖故障的兜底逻辑。不适用时记 N/A。

使用方式

调用后按固定格式输出:先给出“合并风险:低、中、高”,再逐类别列出判定与抬高风险的缺口(要点式、简洁,必要时附相关文件链接)。

评分规则:⚠️ 记 3 分,👀 记 2 分,✅ 记 1 分。权重为影响 2 倍、验证 2 倍、回滚成本 1.5 倍、错误检测 1 倍、对齐 1 倍。总分为加权平均分,低于 1.5 为低风险,1.5 至 2.25 以下为中风险,2.25 及以上为高风险。

适用场景

适用于在合并 PR 前需要量化风险、比较不同 PR 风险高低,或需要向团队说明“为什么这个改动风险大”的场景。

限制

该技能依赖评审者提供的代码、描述、测试证据与监控信息;资料中未提供自动化集成方式、支持平台或安装命令等细节。