understandcommit 08d16bdSKILL.md · 架构调优

代码库知识图谱

分析代码库，在 .ua/ 目录生成 knowledge-graph.json，包含文件、符号、关系、架构分层和导览，供交互式仪表盘浏览。

首次运行会在插件目录执行 pnpm install 并构建；大型代码库的分析会派出大量子代理，耗时较长。

npx skills add Egonex-AI/Understand-Anything --skill understand

权限: read-repo
write-files
shell
network
兼容工具: Claude Code, Codex, Cursor, Copilot, Gemini CLI
GitHub: 89.5k
来源: 社区 · Egonex-AI
状态: 扫描通过
许可证: MIT
分类: 架构调优
代码仓库: github.com/Egonex-AI/Understand-Anything/understand-anything-plugin/skills/understand

核心规则

绝不静默吞掉错误，每一次失败都必须出现在最终报告中。

执行阶段

阶段 01预检与配置
确定项目根目录和 .ua/ 数据目录，必要时构建插件，读取已有图谱并判断全量还是增量分析。
阶段 02扫描与分批
按 .understandignore 和 --exclude 规则扫描文件、识别语言与框架，再计算语义批次。
阶段 03并行分析文件
最多 5 个子代理并发分析各批文件，合并为节点和边，并审查组装后的图谱。
阶段 04分层与导览
识别架构分层并生成引导式导览，随后校验整个图谱。
阶段 05保存与汇报
写入图谱、指纹基线和 meta.json，清理中间文件，汇报统计；校验通过时自动打开仪表盘。

权限说明（据 SKILL.md 整理）

能力	是否需要	说明
文件写入	部分需要	只在项目的 .ua/（或旧版 .understand-anything/）数据目录内写入图谱、配置和中间文件，不修改源码。
命令执行	需要	运行 git、自带的 Node 和 Python 脚本，并在首次使用时执行 pnpm install 和构建。
网络外发	部分需要	仅在插件尚未构建时通过 pnpm install 下载依赖；分析过程本身不访问网络。

SKILL.md 头部信息（YAML）commit 08d16bd

---
name: understand
description: Analyze a codebase to produce an interactive knowledge graph for understanding architecture, components, and relationships
argument-hint: ["[path] [--full|--auto-update|--no-auto-update|--review|--language <lang>|--exclude <patterns>]"]
---

核心规则

执行阶段

阶段 01预检与配置

阶段 02扫描与分批

阶段 03并行分析文件

阶段 04分层与导览

阶段 05保存与汇报

权限说明（据 SKILL.md 整理）

SKILL.md 头部信息（YAML）

相关技能