code-graph

code-graph 技能概览

code-graph 的作用

code-graph 技能帮助 Claude 通过 codebase-memory-mcp 使用基于 AST 的代码图来查找符号、追踪依赖关系，并在打开文件之前评估影响范围。它最适合代码编辑场景：这类工作里，结构感知的快速导航往往比纯文本搜索更重要。

适合安装的人群

如果你经常在中大型代码库里改动代码、排查跨文件行为，或者在编辑前需要更好地回答“这段代码谁在依赖？”这类问题，就应该安装 code-graph。当 grep 信息噪音太大、你又希望 code-graph skill 帮你减少猜测时，它尤其有用。

它为什么不一样

对 Code Editing 来说，code-graph 的核心优势在于它会先引导 agent 查询结构，再去读文件。这样一来，它在符号定位、调用链追踪、重构规划和影响分析上的表现，都会强于那种先手动扫目录的通用提示词。

如何使用 code-graph 技能

安装并激活它

按仓库里的技能安装流程执行 code-graph install，然后确认这个技能已经在你的 Claude 环境中可用，并且 MCP server 可以正常连通。技能里的 when-to-use 说明写得很明确：要先查图，再读文件，所以只有在图后端确实已连接时，激活才真正有意义。

从正确的输入开始

一个好的 code-graph usage 请求，应该直接点出目标符号、文件区域或修改目标，而不是笼统地说“帮我理解这个仓库”。例如：“用 code-graph 找出 AuthService 在哪里被调用，梳理依赖关系，并在我修改 token refresh 之前告诉我影响范围。” 这样技能才有足够的结构信息去高效搜索代码图。

实用工作流

可以按这个 code-graph guide 流程来做：先问相关符号或依赖链，再问受影响文件，然后只打开那些足以确认行为或实际修改代码所必需的文件。架构问题优先用图查询，具体实现、配置值，或者那些在代码结构里不容易体现的字符串，再回到直接读文件。

优先阅读这些文件

先看 SKILL.md，了解“先查图”的规则和支持的 MCP 工具。然后再检查 README.md、AGENTS.md，以及存在的话 rules/、resources/、references/ 或 scripts/ 目录。在这个仓库里，SKILL.md 是唯一的支持文件，所以它是 code-graph install 和使用边界的主要依据。

code-graph 技能常见问题

code-graph 比 grep 更好吗？

当你需要的是结构化答案，比如“这个方法被谁依赖？”或者“重命名这个符号会波及多大范围？”时，它更好。grep 仍然更适合查字面字符串、日志消息，以及代码结构之外的内容，所以这个技能是补充，不是替代。

什么情况下不该用它？

如果问题主要围绕文档、说明文字，或者在非代码文件里查找精确文本，就不要依赖 code-graph。如果 MCP server 不可用，或者你只是在一个很小的仓库里想快速得到一次性答案，它也不是最佳选择，因为这时直接读文件已经足够简单。

它适合新手吗？

适合，只要你能把目标说清楚。新手最适合的用法，是在动手修改前先让它给出符号图、依赖路径或影响检查，而不是把它当成一次宽泛的仓库导览。

它会取代读文件吗？

不会。这个技能的设计目标是减少不必要的文件读取，而不是完全取消读取。先用图缩小范围，再阅读最少量、但足以验证行为并安全修改的文件。

如何改进 code-graph 技能

给代码图一个明确目标

code-graph skill 最强的输入，会直接点名一个符号、一个功能区域，或者一个修改结果。比如“找出 paymentIntent 的所有引用，列出调用方，并标出在重试逻辑变更时最可能受影响的文件”，就比“分析 payments”有用得多，因为前者能让代码图返回可操作的路径，而不是泛泛的摘要。

先问范围，再问方案

常见的失败模式，是一上来就问实现。使用 code-graph 时，最好先请求依赖链、受影响模块和可能的边界情况，然后再问修改建议。这样做能提升 code-graph usage 的效果，因为这个技能本来就是先回答结构问题，再谈代码改写。

用定向读文件消除不确定性

如果代码图给出了多个候选路径，就进一步要求它指出最少需要读哪些文件，才能确认正确路径。code-graph for Code Editing 的价值在这里最明显：代码图先缩小搜索范围，随后少量补充阅读就能在真正补丁之前验证准确行为。

在第一版结果上继续迭代

如果第一次输出过于宽泛，就通过加入精确标识符、包名，或者具体变更类型来收紧查询：重命名、移动、重构、修 bug，或者依赖审计。最好的 code-graph guide 提示词，应该具体到足以让技能直接给出明确的调用方、依赖关系和影响范围，而不是去猜你的意图。