mcpField
G
graph-query

graph-query

github.com/davila7开发33.0k65 次安装1 天前更新
代码仓库

关于 graph-query

graph-query 是面向开发者的 AI Maestro 技能，用于在修改代码前检查代码库关系。它通过索引图查询依赖、调用链和相关组件。

主要功能

  1. 01描述组件和函数
  2. 02查找调用方、被调用方及调用路径
  3. 03按类型查找相关组件
  4. 04查找模型序列化器和关联
  5. 05索引或更新代码图

适用场景

  1. 01修改函数前检查其调用方
  2. 02查找模型变更影响的序列化器
  3. 03追踪代码库中的调用路径

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/davila7/claude-code-templates --skill graph-query

安装后在 Claude Code 中输入/graph-query确认已加载。

详细介绍

AI Maestro 代码图查询

查询代码库的依赖关系图，以便在修改前了解组件关系、调用链和变更影响。属于 AI Maestro 套件的一部分。

前提条件

需要在本地运行 AI Maestro，且代码库已建立索引。

# Install graph tools
git clone https://github.com/23blocks-OS/ai-maestro-plugins.git
cd ai-maestro-plugins && ./install-graph-tools.sh

核心行为

读取任何代码文件后，查询关系图以了解依赖关系：

Read file -> Query graph -> Then proceed

命令

查询
命令描述
graph-describe.sh <name>描述组件或函数
graph-find-callers.sh <fn>查找函数的所有调用方
graph-find-callees.sh <fn>查找此函数调用的所有函数
graph-find-related.sh <component>查找相关组件
graph-find-by-type.sh <type>查找指定类型的所有组件
graph-find-serializers.sh <model>查找模型的序列化器
graph-find-associations.sh <model>查找模型关联
graph-find-path.sh <from> <to>查找函数之间的调用路径
索引
命令描述
graph-index-delta.sh [path]为代码图建立索引或更新索引

组件类型

与 graph-find-by-type.sh 配合使用：model、serializer、controller、service、job、concern、component、hook

使用示例

# After reading a model file
graph-describe.sh User
graph-find-serializers.sh User
graph-find-associations.sh User

# Before modifying a function
graph-find-callers.sh process_payment
graph-find-callees.sh process_payment

# Find call chain between components
graph-find-path.sh handleRequest sendResponse

# Index your codebase
graph-index-delta.sh /path/to/project

为什么修改前要查询

如果不检查关系图，你可能会：

  • 更改函数签名时破坏调用方
  • 遗漏需要随模型变更而更新的序列化器
  • 忽略继承了你所做修改的子类

完整的 AI Maestro 体验

此技能属于 AI Maestro 平台。该平台提供 6 项技能，用于 AI Agent 编排：消息传递、记忆、文档、关系图、规划和 Agent 管理。

评论

支持 Markdown