blast-radius 用于在变更发布前找出它在别处可能破坏什么,适用于“X 的影响范围”“这会不会破坏什么”或审查一个尚不信任的小 diff。它与 how、why 配套:how 说明代码做什么,why 说明为何如此设计,blast-radius 说明它在别处会破坏什么。列出调用者不是重点,重点是 grep 看不出的破坏。
核心做法是不轻信自己的书面结论,而是找出整个变更安全性所依赖的一两个事实,并通过运行代码来证明。可信度分档:仅口头声明最弱;指向真实 file:line 或库源码;逐步论证坏情况不会发生;运行脚本或测试调用真实代码并在出错时显式失败;在运行中的应用里复现。第 4 步通常是一个小脚本,导入应用所用的同一库并调用所担心的确切函数。
步骤:读取变更(diff、新增/修改/删除的符号及未明说的行为差异);找出它安全所依赖的那一个事实;查看 grep 止步之处(所调用库的源码、锁定版本与本地补丁、微任务与卸载/清理时序、Solid 与 React 差异,以及符号搜索遗漏的 JSON 返回、数据库列、线格式、其他语言读取同一字节、功能开关、下游三跳代码);诚实评估每个风险的发生概率与代价,保留已确认风险,单独列出已检查并排除的风险,引用真实 file:line,搜索无结果也是答案,不得编造调用者或 API;证明那一个事实,写脚本或测试运行真实代码并粘贴结果。大范围变更可作为 arena,让多个模型回答同一问题并合并答案。
交付内容:变更做了什么;安全所依赖的那一个事实及其证明步骤与证据,无法证明则写 unproven;风险(如何破坏、file:line、概率与严重度、如何检查);已排除项;合并前最便宜的测试或复现。写作需经 unslop,引用真实代码,公开前移除隐私内容。资料未提供具体安装命令、收费与平台信息。