SuperAPI AI 工具集

blast-radius

编程与开发

查看项目

更新于 11-06 21:02

技能介绍

用途

Blast Radius 用于在代码变更发布前,找出这次改动可能在别处破坏什么。它适用于“X 的爆炸半径是什么”“这可能会破坏什么”这类问题,也适用于审查一个你还不完全信任的小型 diff。

它是 how 和 why 的配套技能:how 告诉你代码做了什么,why 告诉你代码为什么长这样,而 Blast Radius 告诉你它会在别处破坏什么。

主要能力

该技能的核心主张是:列出调用方不是它的工作,agent 一秒就能 grep 出来。它的工作是找出 grep 无法显示的破坏点。

它要求不要信任自己写出的报告——一份听起来正确的爆炸半径报告,无论真假都同样有说服力。因此不能只交回文字报告,而要找出整个变更安全性所依赖的一两个事实,并通过运行代码来证明它们。

使用方式

技能定义了一套流程:

  1. 阅读变更:查看 diff、新增/修改/删除的符号,以及它现在行为有何不同,包括 diff 没有明说的部分。可借助 why 的步骤 2 拉取 PR 和提交。

  2. 找出它之所以安全的那一个事实:大多数看起来有风险的变更,其实是因为某一个事实才安全,例如“这个调用只丢弃已经失效的缓存条目,不做其他事”。如果这个事实成立,大多数风险情况会一次性排除。应把时间花在这里,而不是列一长串可能项。

  3. 查看 grep 止步的地方:阅读所调用库的源码,检查其固定版本和任何本地补丁。弄清运行时机:微任务、卸载与清理、Solid 与 React 的差异。追踪符号搜索会漏掉的东西:API 返回的 JSON、数据库列、线格式、另一种语言读取相同字节、功能开关、下游三跳之外的代码。

  4. 诚实评估每个风险:给出真实的发生概率和真实代价。保留已确认的风险,单独列出已检查并排除的风险。引用真实的 file:line;搜索无结果也是一种答案;绝不编造调用方或 API。

  5. 证明那一个事实:编写一个脚本或测试,运行真实代码,并粘贴运行结果。

对于大型或广泛的变更,可以把它当作“竞技场”来运行:向多个模型提出同一个问题并合并答案,不同模型会捕捉到不同的真实 bug。

适用场景

适用于代码审查、变更影响评估、发布前风险检查,尤其是当你面对一个小型但不太信任的 diff,或需要判断某个改动是否会在别处引发问题时。

限制

该技能明确要求:不要只交回文字报告;必须证明关键安全事实,否则标记为 unproven。它强调引用真实代码,搜索无结果也是答案,绝不编造调用方或 API。最终交付内容应包含:变更做了什么(包括不明显部分)、它之所以安全的那一个事实(说明证明到哪一步并展示证据,无法证明则写 unproven)、风险(每个风险说明如何破坏、file:line、可能性和严重程度、如何检查,重要项附上证明)、已排除项(检查了什么以及为什么没问题)、合并前的最小测试或复现(包括你写的脚本)。此外,应通过 unslop 撰写,引用真实代码,并在公开前剥离任何私密内容。

关于该技能的安装方式、收费模式、支持平台等具体信息,资料中暂未提供。