SuperAPI AI 工具集

blast-radius

编程与开发

查看项目

更新于 11-01 16:53

技能介绍

blast-radius 是一个面向代码审查的智能体技能,核心目标是在改动上线前,找出它可能在别处引发的破坏。资料强调,仅仅列出调用方并不是它的工作,因为智能体可以很快用 grep 找到那些调用方;它真正要发现的是 grep 无法显示的破坏。

用途方面,它适用于以下场景:分析某处改动的影响范围(blast radius of X)、判断某处改动可能破坏什么、审查一个还不太放心的小型 diff。资料将其定位为 how 与 why 的配套技能:how 告诉你代码做了什么,why 告诉你代码为什么长成那样,而 blast-radius 告诉你它会在别处破坏什么。

主要能力体现在几个方面。第一,它要求不要信任自己写的分析报告:一份听起来正确的 blast-radius 报告,无论真假都显得很有说服力,因此不能只交回文字报告,而要找出整个结论所依赖的一两个事实,并通过运行代码来证明。第二,它为每个安全所依赖的事实给出确信度阶梯,从低到高依次为:只是你这么说、你指出了具体行(真实的 file:line,或库自身的源码)、你展示了坏情况不可能发生(逐步推演失败路径且并未触达)、你实际运行了它(调用真实代码并在判断错误时大声失败的脚本或测试)、你在运行中的应用里复现了它,并要求说明停在阶梯的哪一级。第三,它要求不仅看 diff,还要看 diff 没有明说的部分,比如新增、修改、删除符号后行为有何不同;查看所调用库的源码、其固定版本和本地补丁;弄清运行时机,如微任务、卸载与清理、Solid 与 React 的差异;追踪符号搜索会漏掉的东西,如 API 返回的 JSON、数据库列、线格式、其他语言读取相同字节、功能开关、下游三跳的代码。第四,对每个风险要诚实给出实际发生概率和真实代价,确认的风险单独保留,已检查并排除的风险另列,引用真实 file:line,搜索无结果也是答案,绝不编造调用方或 API。第五,用脚本或测试运行真实代码来证明关键事实,并粘贴实际结果。对于大范围改动,可以把它当作竞技场,让多个模型回答同一个问题并合并答案,不同模型能发现不同的真实缺陷。

使用方式上,资料说明以粗体、反引号形式命名的技能,或以 /<name> 形式运行的技能,对应本技能目录旁的 ../<name>/SKILL.md 文件;不带前缀的 principle 对应 ../principle-<name>/SKILL.md,读取该文件并遵循。大多数 pstack 技能仅供用户使用,因此智能体的技能工具无法加载它们。

交付内容方面,它要求给出:改动做了什么(包括不明显的部分);改动之所以安全所依赖的那一个事实(陈述它、说明达到阶梯的哪一步并展示证明,若无法证明则写 unproven);风险(每个风险说明如何破坏、file:line、可能性和严重程度、如何检查,重要风险附上证明);已排除项(检查了什么、为何没问题);合并前(能抓住真实缺陷的最便宜测试或复现,包括你写的脚本)。最后要求通过 unslop 撰写、引用真实代码,并在公开前删除任何私密内容。

限制与暂未提供:资料没有给出该技能的安装命令、依赖环境、支持的语言或框架清单、收费信息、价格或平台支持情况,这些内容暂未提供。