Agent Skills
返回列表
💻

代码图谱导航

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/alinaqi-maggy-code-graph。

技能介绍

问题在哪

在大仓里找函数定义、追调用链、评估改一个公共方法会波及多少文件,若只能靠 grep 和逐文件打开,往往要扫大量无关命中,也很难把「谁依赖谁」梳成一张图。改共享模块前若不做影响面分析,PR 里容易出现意料之外的连锁破坏。

技能如何工作

本技能围绕 codebase-memory-mcp 的代码图谱,贯彻 Graph first, file second:能由图谱回答的问题先查图,只有要改代码或需要超出片段的上下文时才读整文件。

典型能力包括:

  • 用 search_graph / get_code_snippet 定位符号与签名,而不是全文件翻找
  • 用 trace_call_path、query_graph 看调用方与被调方、依赖链
  • 用 detect_changes 在做变更或评审前判断 blast radius(影响范围)
  • 用 get_architecture 快速把握模块与包级结构

规划功能、重构或修 bug 时,技能要求先从图谱理解现有结构与依赖,再动实现;对共享代码的修改尤其不应跳过影响面检查。图谱通过文件监听、会话启动自动索引与提交后标记等机制保持新鲜,一般不必每次查询都手工 index_repository。

边界与注意点

图谱擅长的是代码结构层面的导航与分析;搜字符串字面量、日志文案、配置值等仍适合 grep 或 search_code 这类文本检索。大规模目录重组或切换差异巨大的分支后,可能需要一次 index_repository,再交给自动层维护。若不确定索引是否过期,应先 index_status 再 heavy query。

使用场景

  • 重构前要用图谱查清某公共函数的全部调用方,再决定是否改签名
  • 评审 PR 时针对共享模块改动,用 detect_changes 列出可能受影响的文件与符号
  • 新接手单体仓,先用 get_architecture 理清包结构,再 search_graph 定位鉴权相关入口
  • 计划删除疑似死代码前,用 trace_call_path 确认是否仍有运行时或静态调用链

适合人员

  • 维护多包单体或微服务单仓、经常改共享库的后端工程师,需要快速评估改动波及面
  • 负责代码评审的 Tech Lead,希望在评论里有据可查地指出依赖与风险点而非凭经验猜
  • 在 Claude Code / MCP 环境里做大规模改动的全栈开发者,想减少 grep 与整文件通读的上下文消耗
  • 做架构治理或技术债清理的工程师,需要结构化查询调用链与模块边界而非手工翻 import