SuperAPI AI 工具集

blast-radius

通用与其它

查看项目

更新于 10-16 03:17

技能介绍

用途:在修改任何共享接口(函数返回值、签名、schema、标签集、配置默认值、常量、文件格式)之前,先弄清改动的“爆炸半径”,避免看似纯增量的改动在三个文件之外静默违反契约。编译与类型检查无法捕获位置或长度契约问题,结果可能是远处崩溃或更糟的静默错误输出。核心规则:改了共享接口,就要运行其消费方——阅读不等于运行。

主要能力与步骤:1)编辑前枚举消费方,grep 所有调用点、导入与下游引用,包括测试、notebook、脚本、文档及任何会重新生成已报告结果的代码;跨仓库、跨语言或生成物中的消费方要当场记下。跨仓库消费方按 commit SHA 固定本仓库,其验证凭据记录所构建的修订而非分支或版本字符串。2)明确即将改变的契约:参数个数/长度、名称与顺序、类型/单位/量纲、可空性与哨兵值、默认值、身份与排序保证。典型失败是返回向量从 6 个元素增至 7 个,而消费方与硬编码的 6 个标签配对,编辑处不报错,消费方却在远处抛错或错误循环标注。3)优先选择不会破坏契约的改动:具名增量优于位置增量,能控制消费方时按名称匹配,否则对接口做版本化而非原地加宽;不要用新数据自动推导标签/配置来“修复”不匹配。4)端到端运行消费方,每个不同消费方模式至少跑一条完整路径,优先跑会重新生成已报告数字的路径;双向验证新功能可用且旧输出未变,对比此前报告的输出,任何变动都要能说明原因。5)绿色结果在什么都没跑时没有信息量,确认检查确实执行且可能失败,必要时植入缺陷验证检查会变红。6)记录契约变更,在 NEWS/CHANGELOG、版本化接口说明或定义处注释中说明下游可假设什么;冻结输入并记录声明容差。

最小清单:grep 所有消费方;写下契约;尽量具名/版本化;每个消费方模式跑一条完整路径;对比已报告输出并解释变动;植入缺陷证明检查能失败;记录契约变更;将每个跨仓库消费方重新固定到新 SHA 并在本轮重新生成与验证。

适用场景:修改共享接口、发布或复用代码、跨仓库依赖、需要保证已发布数字可复现的工程流程。

限制:资料未提供该技能的安装方式、运行命令、平台支持、收费或价格信息,暂未提供。