SuperAPI AI 工具集

gitnexus-impact-analysis

编程与开发

查看项目

更新于 10-16 10:28

技能介绍

用途

GitNexus 影响分析用于在代码变更前评估安全性,回答类似“修改这个函数安全吗”“改 X 会破坏什么”“影响范围(blast radius)有多大”“谁在使用这段代码”等问题。它适合在做出非平凡(non-trivial)代码修改之前,以及在提交(commit)之前使用,以理解改动会影响哪些部分。

主要能力

该技能围绕两个工具展开:

  • gitnexus_impact:核心工具,用于分析符号的影响范围(blast radius)。可指定目标符号、方向(如 upstream)、最小置信度(minConfidence)和最大深度(maxDepth)。输出按深度分级:
    • d=1(WILL BREAK,确定会断裂):直接调用者或导入者
    • d=2(LIKELY AFFECTED,可能受影响):间接依赖
    • d=3(MAY NEED TESTING,可能需要测试):传递性影响
  • gitnexus_detect_changes:基于 git diff 的影响分析,可按范围(如 staged)检测当前改动映射到哪些受影响的执行流程。

输出中会标注每个依赖关系的类型与置信度(例如 [CALLS, 100%]),并给出文件路径与行号。

使用方式

推荐工作流:

  1. 运行 gitnexus_impact({target: "X", direction: "upstream"}),找出依赖该目标的内容。
  2. 读取 gitnexus://repo/{name}/processes,检查受影响的执行流程。
  3. 运行 gitnexus_detect_changes(),将当前 git 改动映射到受影响的流程。
  4. 评估风险并报告给用户。

如果提示“Index is stale”(索引过期),需要在终端运行 npx gitnexus analyze。

调用示例

gitnexus_impact({ target: "validateUser", direction: "upstream", minConfidence: 0.8, maxDepth: 3 })

输出示例:

→ d=1 (WILL BREAK):

  • loginHandler (src/auth/login.ts:42) [CALLS, 100%]
  • apiMiddleware (src/api/middleware.ts:15) [CALLS, 100%]

→ d=2 (LIKELY AFFECTED):

  • authRouter (src/routes/auth.ts:22) [CALLS, 95%]

gitnexus_detect_changes({scope: "staged"})

→ Changed: 5 symbols in 3 files → Affected: LoginFlow, TokenRefresh, APIMiddlewarePipeline → Risk: MEDIUM

适用场景

  • 在修改某个函数前,确认其调用者与影响范围。
  • 在提交前,理解当前改动会波及哪些执行流程。
  • 需要评估变更风险等级,尤其是涉及关键路径(如认证、支付)时。

检查清单与风险评估

检查清单:

  • 使用 gitnexus_impact({target, direction: "upstream"}) 查找依赖者
  • 优先审查 d=1 项(这些确定会断裂)
  • 检查高置信度(>0.8)的依赖
  • 读取 processes 检查受影响的执行流程
  • 使用 gitnexus_detect_changes() 进行提交前检查
  • 评估风险等级并报告给用户

风险等级判定:

  • 受影响符号少于 5 个、涉及流程较少:LOW
  • 受影响符号 5 到 15 个、涉及 2 到 5 个流程:MEDIUM
  • 受影响符号超过 15 个或涉及大量流程:HIGH
  • 处于关键路径(认证、支付):CRITICAL

限制

资料中未提供关于支持的语言、仓库规模上限、安装配置要求、收费方式等细节,暂未提供。