SuperAPI AI 工具集

gs-blast-radius

编程与开发

查看项目

更新于 11-15 16:33

技能介绍

用途:gs-blast-radius 用于在代码变更上线前,评估“爆炸半径”,即找出一个小改动可能在别处造成的影响,而不仅仅停留在代码 diff 本身。它适用于“X 的爆炸半径”“这可能会破坏什么”这类问题,或审查一个你还不放心的小 diff。

主要能力:它不会只列出调用方,因为这类信息用 grep 很快就能找到;它关注的是 grep 无法显示的破坏:所调用库的源码、锁定版本与本地补丁;代码运行时机(微任务、卸载与清理、Solid 与 React 的差异);符号搜索容易漏掉的部分,例如 API 返回的 JSON、数据库列、线格式、其他语言读取同一字节、功能开关,以及下游若干跳的代码。它会阅读变更本身,包括 diff、新增/修改/删除的符号、行为变化以及 diff 未明说的部分,并结合 PR 正文、讨论和通过 git log、git blame、gh pr view 获取的提交信息。

使用方式:核心方法是找出“这项变更之所以安全”所依赖的一两个关键事实,并尽可能把该事实证明到更高层级。证明层级依次为:你口头说过(单独无用);指向真实 file:line 或库自身源码;逐步演示坏情况无法发生;运行真实代码的脚本或测试(若判断错误会明显失败);在运行中的应用里复现。第 4 步通常是一个小脚本,导入应用实际使用的同一库并调用你担心的那个函数。对每个风险,都需要给出它如何破坏、file:line、发生概率与影响程度,以及如何检查;已确认的风险保留,已检查并排除的单独列出。对于重要风险,需附上证明。对大范围变更,可用子代理工具让多个模型回答同一问题并合并结果;若环境只能访问一个模型,则跳过并说明。

交付内容:包括变更做了什么(含不明显部分);安全所依赖的关键事实、证明到哪一层及证据(无法证明则写 unproven);风险清单(触发方式、file:line、概率、影响、核查方式);已排查排除项及原因;合并前成本最低且能捕获真实 bug 的测试或复现,包括所写脚本。要求引用真实代码,不得编造调用方或 API,检索无结果也算答案;写作上如安装了 gs-unslop 技能则按其风格,对外公开前去除私有信息。

适用场景:审查小 diff、评估改动对下游代码与数据格式的潜在影响、检查运行时顺序或生命周期问题、在合并前寻找成本最低的验证手段。

限制:资料未提供具体安装方式、支持平台、收费或价格信息;部分步骤依赖可运行代码、git/gh 环境和多模型子代理能力;未证明的安全事实必须如实标记为 unproven。