gograph
为Go代码智能体提供编译器感知的结构图，实现更安全的代码重构。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：gograph。 它的用途是：为Go代码智能体提供编译器感知的结构图，实现更安全的代码重构。 完整的 Skill 内容见：https://321skill.com/skills/gograph/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我想重构这个Go项目中的`LoadUserData`函数，请帮我分析它的所有调用者和可能的影响范围。”，AI会利用gograph提供的精确代码结构图，清晰地列出该函数的所有调用链路、实现的接口以及相关的测试用例，帮助你安全地制定重构计划，避免破坏性修改。
介绍
gograph 为您的Go代码仓库构建一个本地的结构图，并可选择性地通过类型检查（CHA/SSA）进行增强。它解决了AI编码助手在理解大型Go项目结构、追踪调用关系和评估变更影响时面临的挑战，使其能进行更精准、更安全的代码分析和重构。
您可以通过简单的CLI命令快速上手：使用 gograph build . 构建项目AST图，然后通过 gograph summary 或 gograph hotspot 获取项目概览和高频代码区域。对于具体的函数或方法，使用 gograph context "YourSymbol" 可以获取其源代码、调用者、被调用者及测试用例的完整上下文。在进行重大重构前，还可以使用 --precise 模式构建更精确的图，并通过 gograph plan 来评估变更影响。
这个工具非常适合需要与AI助手（如Claude Code）协作进行Go项目维护和开发的工程师，特别是后端开发、全栈开发和智能体开发者。它帮助AI理解代码结构，避免因上下文不足而产生的错误重构。
请注意，gograph 主要进行静态分析，默认不会执行目标代码。其精确模式（--precise）会调用本地Go工具链，因此请确保您的开发环境已配置好Go。所有构建产物和会话数据都存储在本地 .gograph/ 目录下，不会上传到任何远程服务。
核心特点
与依赖简单文本匹配（如grep）或远程代码索引的工具不同，gograph通过构建本地AST结构图并进行可选的类型检查，为AI编码助手提供了编译器级别的代码结构理解能力，能精确区分声明、调用和注释，大幅减少噪音（如演示中找调用者可减少约65%无关行）。
注意事项
主要针对Go语言项目，不适合非Go项目或需要动态运行时分析（如性能剖析）的场景。
常见问题
gograph 会执行我的代码吗？
默认的快速索引模式仅解析源代码，不执行代码。精确模式会调用本地Go工具链进行类型检查，但同样不运行您的应用程序。
如何与Claude Code或Cursor等AI编码助手一起使用？
可以通过MCP（Model Context Protocol）集成。对于支持MCP Bundle的客户端，可以在官方MCP Registry中发现并使用它。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/gograph/raw/index.md 读取 gograph 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/gograph/raw/index.md（查看排版版本）