用途:分析当前代码改动(Git diff 或指定 PR),并对照项目数据目录中的知识图谱(.ua/knowledge-graph.json,或已存在的旧目录 .understand-anything/knowledge-graph.json),理解改了什么、影响哪些组件、存在哪些风险。
主要能力:先解析数据目录 UA_DIR=$([ -d .understand-anything ] && echo .understand-anything || echo .ua),确认图谱文件存在,否则提示先运行 /understand。获取改动文件列表(未提交改动用 git diff --name-only,特性分支用 git diff main...HEAD --name-only,或按用户指定 PR)。读取图谱 project 元数据并用 gitCommitHash 判断图谱是否过期,比较时需带 -- . 路径限定,避免同级 monorepo 项目提交误判;忽略数据目录本身。随后用 Grep 在图中查找改动文件对应的节点(filePath 匹配),再查 1-hop 边找出上游调用者与下游依赖,即受影响组件,并定位涉及的架构层。最后输出结构化分析:改动组件、受影响组件、受影响层、基于复杂度与影响范围的风险评估及审查建议。
使用方式:按技能说明依次执行上述步骤;分析完成后写入 $UA_DIR/diff-overlay.json(含 version、baseBranch、generatedAt、changedFiles、changedNodeIds、affectedNodeIds),并提示可运行 /understand-anything:understand-dashboard 查看可视化叠加层。
限制:若图谱提交或 Git 元数据缺失、无效或不可用,只做简要提示并继续,不阻塞;图谱可能遗漏未刷新改动,建议运行 /understand 刷新。资料未提供收费、平台与效果信息。