SuperAPI AI 工具集

blast-radius

编程与开发

查看项目

更新于 11-19 03:05

技能介绍

Blast radius 是一个变更影响分析技能,用于在改动发布前找出它可能在别处破坏什么。适用场景包括询问“X 的影响范围”“这个改动可能破坏什么”,或审查一个你还不放心的小 diff。

定位:它是 how 和 why 的配套技能。how 说明代码做什么,why 说明代码为何是这种形态,Blast radius 则说明改动会在别处破坏什么。资料强调,列出调用者并不是它的职责,代理用 grep 一秒就能做到;它的职责是发现 grep 看不到的破坏。

核心理念:不要信任自己的书面分析。资料认为,一份听起来正确的 blast-radius 分析无论真假都显得有说服力,因此不应只交回书面报告,而要找出整个判断所依赖的一两个事实,并通过运行代码来证明。

确信度分级:对改动安全性所依赖的每个事实,尽量以低成本推进到下列更高级别,并说明停在哪一级:你说过(单独来看没有价值);你指出了行(真实的 file:line 或库自身源码);你展示坏情况不会发生(逐步走一遍失败路径,确认无法到达);你运行过(脚本或测试调用真实代码,判断错误时大声失败);你在运行中的应用里复现过。资料指出,第 4 步通常是一个小脚本,导入应用发布的同一库,调用你担心的确切函数。

步骤:1. 阅读改动:包括 diff、新增/修改/删除的符号、现在行为有何不同,以及 diff 未明说的部分;可借助 why 第 2 步拉取 PR 和提交。2. 找出它因之安全的那一个事实:多数看似有风险的改动,之所以安全往往只因为一个事实,例如“这个调用只丢弃已经失效的缓存条目,不做别的”;找到它,若成立则多数风险场景一次性排除,应把时间花在这里而不是长串的“可能”。3. 看 grep 停下的地方:阅读所调用库的源码,检查其锁定版本和本地补丁;弄清运行时机(微任务、卸载与清理、Solid 与 React 的差异);追踪符号搜索漏掉的东西,如 API 返回的 JSON、数据库列、线格式、读取同一字节的其他语言、功能开关、下游三跳的代码。4. 诚实对待每个风险:给出真实的发生概率和真实代价;保留已确认的风险,单独列出已检查并排除的;引用真实 file:line,搜索无结果也是答案,绝不编造调用者或 API。5. 证明那一个事实:写脚本或测试运行真实代码,运行并粘贴结果。对于大范围或广泛改动,可作为“竞技场”运行:让多个模型回答同一问题并合并答案,不同模型能发现不同的真实缺陷。

交付内容:它做什么(改了什么,包括不明显部分);它因之安全的那一个事实(陈述该事实、说明达到哪一级、展示证据;若无法证明则标注 unproven);风险(每项说明如何破坏、file:line、可能性与严重度、如何检查,重要的附上证据);已排除项(检查了什么、为何没问题);合并前(能抓住真实缺陷的最便宜测试或复现,包括你写的脚本)。资料还建议通过 unslop 撰写,引用真实代码,并在公开前移除任何私密内容。

回复形式:上述书面分析,其中那一个安全事实要么已证明,要么标注为 unproven。