SuperAPI AI 工具集

gitnexus-impact-analysis

通用与其它

查看项目

更新于 10-16 01:17

技能介绍

用途:回答“改这个函数安全吗”“改 X 会破坏什么”“谁在用这段代码”等问题,在非平凡代码改动前或提交前做安全影响分析。

主要能力:impact 工具按符号查找依赖方,支持 direction(如 upstream)、minConfidence、maxDepth 参数;输出按深度分级:d=1 为直接调用者/导入者(WILL BREAK),d=2 为间接依赖(LIKELY AFFECTED),d=3 为传递影响(MAY NEED TESTING)。detect_changes 基于 git diff 做影响分析,可指定 scope(如 staged),列出变更符号、受影响执行流与风险等级。还可读取 gitnexus://repo/{name}/processes 查看受影响的执行流。

使用方式:典型流程为先用 impact({target: "X", direction: "upstream"}) 找依赖方,再读取 processes 检查受影响执行流,然后用 detect_changes() 映射当前 git 变更,最后评估风险并报告。若提示“Index is stale”,在终端运行 node .gitnexus/run.cjs analyze。检查清单包括:优先查看 d=1 项、关注置信度高于 0.8 的依赖、检查受影响执行流、提交前用 detect_changes、评估风险等级。

风险判定参考:受影响符号少于 5 个且执行流少为 LOW;5–15 个符号、2–5 条执行流为 MEDIUM;超过 15 个符号或大量执行流为 HIGH;涉及认证、支付等关键路径为 CRITICAL。

适用场景:改动前评估、提交前检查、排查代码使用者。限制:依赖 GitNexus 索引,索引过期需重新分析;具体安装与配置方式资料未提供。