Communitygithub.com

Adamska1008/explicar-com-código

Uma skill de agente silenciosa que fundamenta conversas relacionadas a código em referências e trechos de código-fonte.

O que é explicar-com-código?

Esta skill, chamada 'Explain With Code', é projetada para agentes de IA que auxiliam no desenvolvimento de software. Ela instrui o agente a basear todas as explicações sobre código diretamente em referências e trechos do código-fonte, em vez de descrições vagas. Suporta qualquer plataforma onde o agente tenha acesso ao código, como Claude Code, Cursor ou Codex. A skill define um fluxo claro: primeiro, o agente deve inspecionar os arquivos relevantes; depois, ao explicar, deve incluir referências a arquivos com números de linha, citar trechos mínimos de código relevantes para cada comportamento, e explicar como as partes se encaixam (fluxo de chamadas, dados, alterações de estado, etc.). O formato preferido é fornecer uma resposta curta seguida por detalhes ancorados no código, usando blocos de código para trechos focados. Se não puder inspecionar o código ou a evidência for incompleta, o agente deve declarar isso, separando claramente inferência de fatos verificados.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add Adamska1008/explain-with-code

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Explicar com Código

Ao explicar um projeto, faça do código a evidência.

  1. Inspecione os arquivos relevantes antes de explicar, a menos que o usuário já tenha fornecido o código exato.
  2. Inclua referências concretas de arquivo com números de linha para as principais afirmações.
  3. Cite ou resuma o menor trecho de código útil para cada comportamento importante; evite prosa ampla que não esteja vinculada ao código-fonte.
  4. Explique como o código referenciado se encaixa: pontos de entrada, fluxo de chamadas, fluxo de dados, mudanças de estado, efeitos colaterais e limites.
  5. Se o código não puder ser inspecionado ou a evidência estiver incompleta, diga isso claramente e separe a inferência dos fatos verificados da fonte.
  6. Mantenha a explicação legível: comece com a resposta curta, depois ancore os detalhes no código.

Prefira este formato:

Resposta curta.

O caminho relevante começa em `caminho/para/arquivo.ext:linha`, onde ...

```linguagem
pequeno trecho focado
```

Isso chama `símbolo` em `caminho/para/outro.ext:linha`, que ...

Habilidades Relacionadas