Habilidades data-structure-protocol
📦

data-structure-protocol

Seguro

Mapear Estrutura de Codebase para Agentes AI

Agentes AI perdem contexto em codebases grandes e desperdiçam tokens na orientação. Esta skill fornece memória estrutural persistente através de um grafo consultável, permitindo que agentes naveguem dependências e compreendam relações de código sem reler arquivos.

Suporta: Claude Codex Code(CC)
🥉 73 Bronze
1

Baixar o ZIP da skill

2

Upload no Claude

Vá em Configurações → Capacidades → Skills → Upload skill

3

Ative e comece a usar

Testar

A utilizar "data-structure-protocol". python dsp-cli.py --root . search "authentication"

Resultado esperado:

Found 3 entities:
- obj-11223344: auth/middleware.ts (User authentication middleware)
- func-aabbccdd: auth/middleware.ts#validateToken (JWT token validation)
- obj-44556677: auth/providers/oauth.ts (OAuth provider integration)

A utilizar "data-structure-protocol". python dsp-cli.py --root . get-recipients obj-11223344

Resultado esperado:

Modules importing auth/middleware.ts:
- obj-99887766: src/app.ts ('Handles JWT verification on requests')
- func-12345678: api/routes.ts ('Authenticates incoming API requests')

Auditoria de Segurança

Seguro
v1 • 2/24/2026

Static analysis detected patterns in SKILL.md (external_commands, network URLs, weak crypto flags) but all are FALSE POSITIVES. The detected patterns are: (1) Example CLI commands in markdown code blocks - not actual shell execution; (2) GitHub reference URLs for documentation - not data exfiltration; (3) Misidentified content as crypto algorithms - the skill is pure documentation. This is a legitimate documentation skill with no security risks.

1
Arquivos analisados
199
Linhas analisadas
0
achados
1
Total de auditorias
Nenhum problema de segurança encontrado
Auditado por: claude

Pontuação de qualidade

38
Arquitetura
100
Manutenibilidade
87
Conteúdo
50
Comunidade
100
Segurança
83
Conformidade com especificações

O Que Você Pode Construir

Navegação de Codebase Grande

Navegue codebases desconhecidas consultando o grafo DSP para compreender relações entre módulos sem ler todos os arquivos

Refatoração Segura

Antes de substituir uma biblioteca ou refatorar, consulte o grafo para encontrar todos os módulos dependentes e compreender o impacto

Preservação de Contexto de Código

Mantenha conhecimento estrutural entre sessões para que agentes AI possam compreender por que conexões existem

Tente Estes Prompts

Configurar DSP para Projeto 
Configure o Data Structure Protocol (DSP) para este projeto. Baixe dsp-cli.py se necessário, execute init, e inicialize o grafo começando pelo ponto de entrada principal.
Encontrar Dependências de Entidade 
Encontre todas as entidades que dependem de [entity-name-or-path] e mostre-me por que cada dependência existe.
Mapear Novo Módulo 
Crie um novo objeto DSP para [file-path] com descrição '[purpose]'. Então crie entidades de função para cada função exportada, marque-as como compartilhadas, e adicione imports com motivos.
Buscar Estrutura da Codebase 
Busque no grafo DSP por '[query]' para encontrar entidades relevantes. Mostre-me suas descrições e relações de importação.

Melhores Práticas

  • Atualize o DSP imediatamente ao criar novos arquivos, adicionar imports ou alterar APIs públicas
  • Sempre adicione um motivo 'porquê' significativo ao registrar um import - é aqui que reside a maior parte do valor
  • Trate diffs do .dsp/ como diffs de código - revise-os e mantenha-os precisos

Evitar

  • Não atualize o DSP para mudanças apenas internas que não afetam o propósito ou dependências
  • Não crie UIDs para cada variável local - apenas Objetos em nível de arquivo e entidades públicas
  • Não pule adicionar motivos 'porquê' - sem eles o grafo perde valor de navegação

Perguntas Frequentes

O que é DSP?
DSP (Data Structure Protocol) é um sistema que dá aos agentes AI memória estrutural persistente de uma codebase. Armazena um grafo consultável em um diretório .dsp/ mostrando entidades, imports, exports e motivos para cada conexão.
Esta skill executa código?
Não. Esta skill fornece documentação e orientação sobre o uso do script Python dsp-cli.py. Não contém nenhum código executável que rode automaticamente.
Como o DSP ajuda na refatoração?
Antes de fazer mudanças, você pode consultar o grafo DSP para encontrar todas as entidades que dependem de um módulo e compreender POR QUE elas dependem dele. Isso previne mudanças quebradas e garante cobertura completa de refatoração.
O que são UIDs e por que eles importam?
UIDs (identificadores únicos como obj-a1b2c3d4) são estáveis através de renomeações e movimentos de arquivos. Ao contrário de caminhos de arquivo, UIDs permitem que o grafo rastreie entidades consistentemente mesmo quando arquivos são reestruturados.
O DSP analisa bibliotecas de terceiros?
Não. Dependências externas (pacotes npm, stdlib, etc.) são registradas como tipo 'external' mas seus internos nunca são analisados. Apenas o código do seu projeto é mapeado em detalhes.
Posso usar isto com Claude Code?
Sim. Esta skill é projetada para assistentes de codificação AI incluindo Claude, Codex e Claude Code. Ajuda agentes a manterem contexto entre sessões sem reler a codebase inteira.

Detalhes do Desenvolvedor

Autor

sickn33

Licença

MIT

Repositório

https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/data-structure-protocol

Referência

main

Estrutura de arquivos

📄 SKILL.md