SuperAPI AI 工具集

understand-diff

通用与其它

查看项目

更新于 10-15 22:16

技能介绍

用途:分析当前代码改动或 PR,判断改了什么、影响哪些组件、存在哪些风险。依赖项目根目录下的 .understand-anything/knowledge-graph.json 知识图谱;若不存在,需先运行 /understand 生成。

主要能力:读取改动文件列表后,在知识图谱中定位对应节点(含 file、function、class 及 config、document、service 等非代码节点),再沿 edges 做一跳关联,找出上游调用方与下游依赖,即受影响组件;同时匹配 layers 判断触及的架构层,并结合节点 complexity、跨层边数量与影响范围给出风险评估和重点审查建议。

使用方式:先确认知识图谱存在;获取改动文件列表,未提交改动用 git diff --name-only,特性分支用 git diff main...HEAD --name-only,或按用户指定的 PR 号取 diff;仅读取 project 元数据;用 Grep 在 JSON 中按 filePath 搜索匹配节点并记录 id;再按 id 在 edges 中搜索一跳关联,在 layers 中搜索受影响层;最后输出结构化分析,并把结果写入 .understand-anything/diff-overlay.json,字段包括 version、baseBranch、generatedAt、changedFiles、changedNodeIds、affectedNodeIds。写入后可运行 /understand-anything:understand-dashboard 查看 diff 叠加视图。

限制:分析质量取决于知识图谱是否完整、是否与当前代码同步;需避免一次性读取整个图谱,应先用 Grep 定位再按需读取;具体命令、参数与输出格式以资料为准,其他细节暂未提供。