dependency-graph
生成模块导入关系的Mermaid依赖图
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：dependency-graph。 它的用途是：生成模块导入关系的Mermaid依赖图 完整的 Skill 内容见：https://321skill.com/skills/dependency-graph-x-5/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
'扫描当前项目src目录下的所有模块，生成Mermaid依赖图，忽略node_modules和test文件夹'，dependency-graph 会递归遍历src目录，解析每个文件的import语句，输出类似 mermaidgraph TD A[src/utils/helper.js] --> B[src/config/index.js] 的代码，可直接粘贴到Markdown文档中展示。
介绍
在大型项目中，模块间的依赖关系往往难以直观把握，导致代码重构时容易遗漏影响范围、新人上手慢、架构腐化不易察觉。dependency-graph 通过扫描项目中的 import/require 语句，自动生成 Mermaid 格式的依赖关系图，让开发者一目了然地看到每个模块被哪些文件引用、又依赖了哪些外部模块，从而快速定位循环依赖、识别高耦合模块、评估修改影响域。
使用方式非常简洁：在项目根目录下运行一条命令，工具即会递归扫描指定目录下的源码文件，解析导入语句，输出 Mermaid 流程图代码。你可以直接将这段代码粘贴到 Markdown 文档、GitHub README 或 Notion 页面中，也可以配合 Mermaid 图表渲染工具生成可视化图片。支持自定义过滤规则（如忽略第三方库、只显示顶层模块），以及调整图的方向（自上而下/自左向右）。
适合所有需要理解代码依赖关系的开发者，包括全栈开发、后端开发、前端开发、智能体开发者，以及负责代码审查或架构治理的工程师。对于接手遗留项目、进行代码重构、评估模块拆分可行性、以及编写项目文档等场景尤为实用。
建议在项目初次梳理、大版本重构前、或每次代码提交后运行一次，将依赖图纳入文档持续维护。注意该工具基于静态语法分析，对动态导入（如 Python 的 importlib.import_module）或运行时拼接路径的依赖无法准确捕捉，不适合直接用于动态语言的复杂依赖分析。
核心特点
不同于通用的代码分析工具（如 depcruise、code2flow）需要额外配置输出格式，dependency-graph 原生输出 Mermaid 语法，可直接嵌入 Markdown 文档，无需二次转换；同时保持轻量，仅关注导入关系，不引入 AST 或类型分析等复杂依赖。
注意事项
不适用于动态导入、运行时反射加载的依赖，或需要类型推断才能确定的模块关系（如 Python 的 __import__ 或动态路径拼接）。
常见问题
生成的依赖图太大怎么办？
支持通过 --depth 参数限制层级深度，或使用 --ignore 过滤掉第三方库、测试文件等，避免图过于拥挤。
支持哪些语言？
默认支持 JavaScript/TypeScript 的 import 和 require，Python 的 import，以及常见模块化语言。可通过插件扩展支持更多语言。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/dependency-graph-x-5/raw/index.md 读取 dependency-graph 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/dependency-graph-x-5/raw/index.md（查看排版版本）