agentkitco/agentkit-dev-skills

Auditar um arquivo de instrução do agente

Objetivo: encontrar linhas em um arquivo de instrução que estão erradas, desatualizadas, vagas ou arriscadas, e propor uma versão mais curta e precisa. Nunca "corrija" um comando que você não executou ou um caminho que não verificou.

Etapas

1. Encontre os arquivos. Procure por AGENTS.md, CLAUDE.md, CLAUDE.local.md, .claude/rules/*.md, .cursor/rules/*.mdc, .cursorrules, .github/copilot-instructions.md e .github/instructions/*.md. Liste o que encontrou e quem lê cada arquivo.
2. Execute o verificador a partir da raiz do repositório para obter os primeiros achados mecânicos: python3 scripts/audit_instructions.py <arquivo> [<arquivo> ...] (O caminho é relativo à pasta desta skill; use o caminho completo até a skill instalada.) Ele informa comprimento, caminhos de arquivo quebrados, comandos que nomeiam um script ou target de make que não existe, frases vagas, placeholders [COLCHETES] restantes, linhas duplicadas e strings com aparência de segredo. Se o Python não estiver disponível, faça as mesmas verificações manualmente.
3. Verifique cada comando você mesmo. Para cada comando no arquivo, confirme que ele existe (script em package.json, target em Makefile, entrada em pyproject.toml). Execute os comandos baratos e seguros (lint, testes unitários, verificação de tipo). Não execute comandos de deploy, migrate ou delete; liste-os como "não verificado".
4. Verifique os julgamentos que o script não pode fazer:
   • Regras que um linter ou formatador já impõe (candidatas a remoção).
   • Regras que se contradizem, ou que contradizem outro arquivo de instrução.
   • Fatos que o agente pode ler do repositório em segundos (nome do framework, listagem de pastas).
   • Regras sem significado testável ("escreva código limpo").
   • Qualquer coisa que pertença a uma regra com escopo de caminho, em vez do arquivo raiz.
5. Relate, então aguarde aprovação antes de editar.

Formato do relatório

## Auditoria do arquivo de instrução: <arquivo>
Comprimento: <n> linhas (<veredito>)

### Deve corrigir (errado ou inseguro)
- linha <n>: <o que está errado>, <evidência: saída do comando ou caminho ausente>

### Deve remover (baixo valor)
- linha <n>: <por que pode ser retirada>

### Contradições
- <arquivo A linha n> vs <arquivo B linha m>: <o conflito>

### Não verificado
- <comando>: <por que você não o executou>

### Versão proposta
<o arquivo mais curto, ou um diff>

Regras

• Evidência acima de opinião: todo "Deve corrigir" cita saída ou arquivo ausente.
• Mantenha a voz do proprietário e qualquer regra que codifique um incidente real ou uma restrição rígida.
• Não adicione novas regras durante uma auditoria. Sugira-as separadamente ao final, no máximo três.
• Trate uma string com aparência de segredo como real: diga ao usuário para rotacioná-la, e não repita o valor em seu relatório.