用途:当需要对代码库中某个具体文件、函数或模块做深入讲解时使用该技能。它基于 understand-anything 生成的知识图谱,输出该组件的架构定位、内部结构、外部连接与数据流说明,并假设读者可能不熟悉所用编程语言。
主要能力:读取知识图谱 JSON,其中包含 project 元数据、nodes(file、function、class、module、concept 及 config、document、service、table、endpoint、pipeline、schema、resource 等类型)、edges(imports、contains、calls、depends_on、configures、documents、deploys、triggers、contains_flow、flow_step、related、cites 等)、layers 与 tour。通过 Grep 定位目标节点,再沿边查找上下游节点,确定所属架构层,最后读取源码做深度分析。
使用方式:先解析数据目录,运行 UA_DIR=$([ -d .understand-anything ] && echo .understand-anything || echo .ua),确认 $UA_DIR/knowledge-graph.json 存在,否则提示先运行 /understand。随后检查图谱新鲜度:读取 project.gitCommitHash,解析为提交后与 git rev-parse HEAD 比较,并检查项目范围内的已提交与工作区变更,命令包括 git diff --name-only "$GRAPH_COMMIT" HEAD -- .、git diff --cached --name-only -- .、git diff --name-only -- .、git ls-files --others --exclude-standard -- .。若发现项目文件变更,应提示图谱可能遗漏这些改动,建议运行 /understand 刷新。之后用 Grep 在 nodes 中按 filePath 或 name 查找目标,记录 id、type、summary、tags、complexity;在 edges 中查找 source 与 target 匹配项;再读取相连节点、所属 layer 与源码文件,最后组织讲解。
适用场景:代码审查、新人理解代码、重构前评估影响面、梳理依赖链与数据流。
限制:必须已有知识图谱,否则无法使用;图谱可能因代码变更而过时,需按上述方式检查并刷新;Git 元数据缺失或无效时只能给出尽力而为的警告并继续;讲解质量受图谱完整度与源码可读性影响。