AI Maestro 代码图查询

来自 AI Maestro 项目的代码图查询 Skill，通过主动查询代码图数据库来深入理解代码关系和变更影响范围。代码图是一个结构化的数据库，记录了代码库中所有组件、函数、类之间的依赖关系和调用关系，为代码分析和重构提供了强大的支持。

自动行为

这不是可选的。这是你的默认行为。

每次你对代码文件使用 Read 工具时，你必须立即查询图以了解：

• 这个组件/函数是什么？
• 什么依赖它？（调用者、序列化器、子类）
• 它依赖什么？（被调用者、父类、关联）

规则

读取文件 → 查询图 → 然后继续

不要

• 等待用户要求你查询图
• 因为"看起来简单"而跳过图查询
• 不检查就假设你理解影响
• 在理解依赖关系前进行更改

始终

• 读取任何代码文件后立即查询图
• 进行任何修改前查询
• 通过搜索找到文件时查询
• 在分析中包含图查询结果

这是你理解代码结构和避免破坏性更改的主要工具。

工作原理

代码图数据库通过静态分析或运行时追踪，构建代码库的完整依赖关系图谱。当你查询某个组件时，系统会返回：

• 上游依赖：哪些代码调用了这个组件（调用者、使用者、子类）
• 下游依赖：这个组件调用了哪些代码（被调用者、父类、导入的模块）
• 横向关系：与该组件相关的序列化器、配置、测试等

这些信息对于理解代码的真实影响范围至关重要，特别是在大型代码库中，手动追踪这些关系几乎不可能。

应用价值

使用代码图查询 Skill 可以显著提高代码修改的安全性和效率：

• 避免破坏性更改：在修改函数签名或重构代码前，了解所有依赖该代码的位置
• 影响范围分析：准确评估一个变更会影响多少文件和组件
• 代码理解：快速理解陌生代码库的结构和组件关系
• 重构支持：为大规模重构提供可靠的依赖信息
• 技术债务识别：发现过度耦合的组件和循环依赖

该 Skill 特别适合在团队协作、遗留代码维护、大规模重构等场景中使用，是保证代码质量和系统稳定性的重要工具。