Code Graph Query Skill

概述

Code Graph Query Skill 是 AI Maestro 的 graph-query Skill。AI Maestro 是 23blocks 开源（MIT）的多 Agent 编排面板，提供持久记忆、消息和多机协作。它会把代码库索引成代码图（面板中也有交互式可视化），而这个 Skill 要求 Agent 在修改任何组件之前先查询代码图，找出调用方、依赖和改动的影响范围，避免破坏自己没读过的代码。

它强制的规则是 读文件 → 查代码图 → 再动手：读完代码文件或通过搜索找到文件后立即查询，修改前必须查询，并把结果写进分析。该 Skill 发布在 ai-maestro-plugins，需要 AI Maestro 和 Bash 权限，命令会从 tmux 会话自动识别 Agent ID。

命令

据 Skill 说明，1000 多个文件的全量索引约需 30 到 120 秒，少量变更文件的增量索引只需几秒。

快速上手

curl -fsSL https://raw.githubusercontent.com/23blocks-OS/ai-maestro/main/scripts/remote-install.sh | sh
graph-index-delta.sh /path/to/project
graph-find-callers.sh processPayment

适用场景

• 修改模型时找出所有依赖它的序列化器和关联。
• 修改函数签名前先列出所有调用方。
• 快速熟悉陌生代码库。

局限

• 组件类型和关联命令体现的是 Rails 风格概念（model、serializer、belongs_to），不同技术栈收益不同。
• 依赖 AI Maestro，不是独立的代码智能服务。

常见问题

有单独的全量索引命令吗？

没有。graph-index-delta.sh 首次运行即全量索引，之后增量更新。

替代方案

• Serena：通过 MCP 提供符号级检索与引用查询。
• sentrux：向编程 Agent 报告代码结构指标的架构传感器。

相关 Skill

其他 AI Maestro Skill：Memory Search、Docs Search、Agent Messaging。更多内容见 Skills 分类。