Agent Skills
返回列表
💻

GitDiagram 可点击架构图

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_3c6cb52e/generate-clickable-architecture-diagrams-from-public-github-repos-with-gitdiagram

技能介绍

要解决的具体问题

入职新团队、做代码评审，或是要把仓库交接给Agent处理时，面对陌生的公共GitHub仓库，你要先理清模块边界、依赖关系和目录结构。手动翻文件、画草稿不仅耗时，还容易踩到路径无效、节点脱节的坑，很难快速形成清晰的认知。

核心能力与关键步骤

这个技能用GitDiagram把仓库变成可点击的交互式架构图。它会先解析仓库的真实文件树，生成的图会对照文件树校验：如果存在无效路径或非法连接，会自动重试修正。修正后的图会编译成Mermaid格式，再做一次校验，确认无误后才展示。每个节点都对应仓库里的真实路径，你可以点击节点跳转到具体文件，快速定位到想了解的模块。

适用边界与注意点

仅支持公共GitHub仓库，需要网络访问权限。可选自托管OpenAI或OpenRouter配置，适配不同环境的模型调用需求。后端用uv管理Python环境，Mermaid校验的Bun依赖从backend/bun.lock安装。Mermaid校验由Next后端在进程内完成，保证校验的实时性和准确性。

使用场景

  • 新人入职第一个月，需要快速理解公司核心业务仓库的模块划分和依赖关系，不用逐行翻代码理结构。
  • 接手开源项目的代码评审，要在合 PR 前快速梳理改动涉及的模块路径，确认改动范围是否符合预期。
  • 给 AI Agent 交接开发任务，需要提供仓库清晰的架构图，帮助 Agent 快速定位相关文件和模块逻辑。
  • 维护遗留系统时，需要定位某个功能模块的上下游依赖，确认修改该模块不会影响其他无关功能。

适合人员

  • 刚入职的开发工程师，需要在一周内熟悉公司核心业务仓库的模块结构和依赖关系，以便顺利接手开发任务。
  • 开源项目维护者，需要在收到 PR 后快速判断改动的影响范围，提升评审效率和准确性。
  • 需要将仓库任务交接给 AI Agent 的开发者，希望通过清晰的架构图帮助 Agent 快速定位相关文件和逻辑，减少沟通成本。
  • 负责遗留系统重构的架构师，需要快速梳理现有模块的依赖关系，评估重构的风险和影响范围。