Understand Anything 把代码库变成可查询的知识图谱

你刚加入一个团队，代码库有 20 万行。从哪儿入手？Understand Anything，一个 83k 星的 Claude Code 插件，给你的答案不是一份阅读清单，而是一张地图。

为什么这个 Skill 重要

运行 /understand，多 agent 管道会扫描项目，然后把知识图谱——每个文件、函数、类、依赖——写入 .ua/knowledge-graph.json。dashboard 把它变成可以平移、缩放、搜索的东西：节点带通俗的摘要，分层按 API、Service、Data、UI、Utility 着色，引导式导览按依赖顺序走完架构，语义搜索能回答「哪些部分负责鉴权？」这类问题。

管道按各工具的强项分工。Tree-sitter 确定性地解析源码——import、export、定义、调用点——所以结构侧可复现；LLM agent 补上解析器给不了的：摘要、标签、架构分层、业务域映射。/understand 由 5 个 agent 执行：project-scanner、file-analyzer、architecture-analyzer、tour-builder、graph-reviewer。/understand-domain 增加一个 domain-analyzer；/understand-knowledge 为 wiki 知识库增加一个 article-analyzer。

安装

/plugin marketplace add Egonex-AI/Understand-Anything
/plugin install understand-anything

其他平台用一行 curl 安装器——Codex、Gemini CLI、OpenCode、Cline 等都支持。注意 Codex 调用 skill 用 $understand 而不是斜杠。Cursor 和 VS Code + Copilot 在克隆仓库后会自动发现插件。

实战：先建图，再探索

/understand

第一次运行会分析整个项目——README 提醒在大代码库上可能消耗可观的 token——之后的运行默认增量，只重新分析有改动的文件。然后打开视图：

/understand-dashboard

交互式 dashboard 打开后，代码库成了一张可搜索、可点击的图，并按架构分层着色。加 --language zh 可以让节点摘要、dashboard 标签、导览文本以中文生成——支持 en、zh、zh-TW、ja、ko、ru。首次运行不带该参数时，插件会探测你的对话语言，若不是英文会在生成前请你确认（英文对话不受影响）；选择会存入 .ua/config.json，之后的运行沿用。

实战：给新人上手，让图谱保鲜

/understand-chat How does the payment flow work?
/understand-diff
/understand-explain src/auth/login.ts
/understand-onboard

/understand-chat 用大白话向图谱提问。/understand-diff 在提交前显示这次改动会波及系统的哪些部分。/understand-explain 深挖单个文件或函数；/understand-onboard 为下一位入职者生成指南。团队协作时，把 .ua/ 目录提交进仓库——intermediate/ 和 diff-overlay.json 除外——任何同事用独立 viewer 就能打开 dashboard：不需要 Claude Code，不需要 LLM，只要 Node.js 18+。

技巧

• 巨型 monorepo？收窄扫描范围：/understand src/frontend。
• 开启 /understand --auto-update 安装 post-commit 钩子，让每次提交都带上同步的图谱；或者在发版前手动重跑 /understand。
• 超过 10 MB 的图谱应改用 git-lfs 追踪；README 给出了三条命令。
• /understand-knowledge 不只用于代码——把它指向 Karpathy 模式的 LLM wiki，能得到带社区聚类的力导向知识图谱。

何时不用这个 Skill

这是静态建图加语义摘要，不是运行时可观测性：它展示代码写成的样子，而不是延迟、报错、流量。另外，大仓库的首次全量扫描确实吃 token——预算紧张时，先从子目录开始，或按 README 的建议把平台指向 Ollama 这类本地模型提供方。

查看 排行榜 了解更多 skill。