代码库架构知识图谱生成
扫描并分析本地代码工程,提取模块依赖与符号关系,生成用于交互式浏览的架构知识图谱文件。
功能与用途
该能力专为开发者和技术团队设计,用于快速理解复杂或陌生的代码仓库。它通过对指定代码目录进行全量或增量扫描,解析跨文件的导入导出关系、架构分层与组件依赖,最终在项目目录下生成标准的数据文件(knowledge-graph.json)。生成的图谱可直接驱动交互式可视化看板,帮助工程师理清模块调用链路、排查架构坏味道或辅助新成员快速熟悉系统结构。
适用场景
- 大型代码库快速接手:扫描遗留项目或大型开源仓库,自动提取模块依赖与符号拓扑,帮助新接入项目的工程师快速理清目录层次与全局架构。
- 架构重构与依赖解耦:重构系统或拆分服务前分析跨模块调用链路,排查文件间的反向依赖与隐式耦合,为架构边界划分提供客观数据支撑。
- 技术评审与架构文档沉淀:输出标准架构知识图谱驱动看板展示,在技术方案评审或交接分享时直观演示关键组件关系,降低跨团队沟通成本。
适用人群
- 接手遗留系统或大型开源项目的软件工程师
- 需要审视系统依赖与组件耦合的软件架构师
- 负责跨团队代码审查与技术资产梳理的技术管理者
使用步骤
- 在代码仓库根目录打开终端,确保环境满足 Node.js 与 pnpm 的版本要求
- 调用 /understand 命令,可按需添加 --language、--exclude 或 --full 等运行参数
- 确认或自定义生成的 .understandignore 排除规则并继续执行
- 等待多阶段批处理分析完成,并在项目 .ua/ 目录下获取生成的 knowledge-graph.json 文件
开始使用
将需求和 Skill 名称发送给已连接 SkillPX MCP 的 AI 助手,核对适用工具和安装要求。
技术信息
- 分类
- 编程
- 适用工具
- Codex、Claude Code、OpenClaw、Hermes、国内 Agent
- 使用难度
- 进阶
- 版本
- main
- 最近更新
- 2026-09-23
- 文件数
- 3
- 安装包大小
- 自动生成 ZIP
- 安全检查
- 基础检查通过
Analyze a codebase to produce an interactive knowledge graph for understanding architecture, components, and relationships
依赖与权限
- 读取用户主动提供的内容