artubss AI Maestro Code Graph Query
Consulte o grafo de dependências da sua base de código para entender relacionamentos de componentes, cadeias de chamadas e o impacto de mudanças antes de fazer modificações. Parte do conjunto de ferramentas AI Maestro.
Pré-requisitos
Requer AI Maestro rodando localmente com a base de código indexada.
# Instalar ferramentas de grafo
git clone https://github.com/23blocks-OS/ai-maestro-plugins.git
cd ai-maestro-plugins && ./install-graph-tools.sh
Comportamento Principal
Após ler qualquer arquivo de código, consulte o grafo para entender dependências:
Ler arquivo -> Consultar grafo -> Então prosseguir
Comandos
Consulta
| Comando | Descrição |
|---|---|
graph-describe.sh <name> |
Descrever um componente ou função |
graph-find-callers.sh <fn> |
Encontrar todos os chamadores de uma função |
graph-find-callees.sh <fn> |
Encontrar todas as funções chamadas por esta função |
graph-find-related.sh <component> |
Encontrar componentes relacionados |
graph-find-by-type.sh <type> |
Encontrar todos os componentes de um tipo |
graph-find-serializers.sh <model> |
Encontrar serializadores para um modelo |
graph-find-associations.sh <model> |
Encontrar associações de modelo |
graph-find-path.sh <from> <to> |
Encontrar caminho de chamada entre funções |
Índice
| Comando | Descrição |
|---|---|
graph-index-delta.sh [path] |
Indexar ou atualizar o grafo de código |
Tipos de Componentes
Use com graph-find-by-type.sh: model, serializer, controller, service, job, concern, component, hook
Exemplos de Uso
# Após ler um arquivo de modelo
graph-describe.sh User
graph-find-serializers.sh User
graph-find-associations.sh User
# Antes de modificar uma função
graph-find-callers.sh process_payment
graph-find-callees.sh process_payment
# Encontrar cadeia de chamadas entre componentes
graph-find-path.sh handleRequest sendResponse
# Indexar sua base de código
graph-index-delta.sh /path/to/project
Por Que Consultar Antes de Modificar
Sem verificar o grafo, você corre o risco de:
- Quebrar chamadores ao alterar uma assinatura de função
- Perder serializadores que precisam ser atualizados com uma mudança de modelo
- Ignorar classes filhas que herdam suas modificações
Experiência Completa com AI Maestro
Esta skill faz parte da plataforma AI Maestro, que fornece 6 skills para orquestração de agentes IA: messaging, memory, docs, graph, planning e agent management.