Auditoria
Diga ao usuário em que estado está seu sistema e o que fazer a seguir. Primeiro escaneie e relate sem tocar em nada. Só edite se o usuário aceitar uma melhoria concreta.
1. Escaneie
Leia o que existe. Relate fatos, não suposições: se você não leu um arquivo, não fale sobre ele.
.agents/ e .opencode/ são pastas ocultas e as buscas por padrão (glob) não as veem. Para revisá-las, liste a pasta diretamente (ls .agents/skills) e leia cada SKILL.md pelo seu caminho.
| Camada | Pontos | O que verificar |
|---|---|---|
| Contexto | 25 | AGENTS.md existe; quantos espaços <...> restam; se "Em que estou trabalhando" tem conteúdo real; se é específico (carreira, ano, matérias, formatos). Mantenha a linha que manda revisar .agents/skills/. |
| Memória | 20 | memory/index.md existe; quantas páginas há em memory/wiki/ sem contar exemplo.md; páginas órfãs (não linkadas a partir do índice), por nome; páginas com atualizada há mais de 60 dias. |
| Capacidades | 20 | Quantas skills há em .agents/skills/ além das de fábrica (ver SKILLS.md); que cada SKILL.md tenha name igual ao nome de sua pasta e uma description que diga quando usá-la. |
| Conexões | 15 | Se opencode.json tem Composio habilitado; se memory/wiki/conexoes.md diz quais apps estão conectadas. Não tente se conectar para verificar. |
| Espaço de trabalho | 10 | Se há material próprio em universidade/, projetos/ ou entregaveis/ além dos README; matérias vazias; projetos sem NOTAS.md. |
| Higiene | 10 | Chaves, tokens ou senhas em qualquer arquivo (busque key, token, secret, password, sk-, ghp_, sem entrar em node_modules/ nem .git/); dados pessoais de terceiros. Se encontrar algo, reporte sem transcrevê-lo. |
Pontuação por camada: completo, metade ou zero. Some o total.
2. Veja o uso
Se houver material ou memória, procure tarefas que se repetem (por exemplo, três resumos de aula em universidade/ ou a mesma solicitação em várias páginas de memória). Se encontrar uma, é candidata a skill.
3. Relate
Uma tabela e três ações. Nada mais.
| Camada | Estado | Pontos | O que encontrei |
|---|---|---|---|
| Contexto | ✅ / ⚠️ / ❌ | x/25 | … |
| … | |||
| Total | x/100 |
✅ funciona · ⚠️ funciona, mas falta algo · ❌ falta ou está quebrado.
Em seguida, exatamente três melhorias, ordenadas por quanto elevam a pontuação ou o valor do sistema. Cada uma em uma linha, começando por um verbo, com o arquivo que toca. Se houver algo em Higiene, vai primeiro sempre.
Se você encontrou uma tarefa repetida, a terceira melhoria é «criar uma skill para » com /criar-skill.
4. Ofereça aplicar
Termine com: «Aplico alguma? Diga o número». Se aceitar:
- Mostre em uma linha o que você vai mudar e em qual arquivo.
- Faça apenas essa mudança.
- Repontue essa camada e diga quanto subiu.
Regras
- O escaneamento e o relatório não modificam nada.
- Nunca apague material do usuário. Para remover um segredo, peça que ele o faça ou confirme antes.
- Se a pasta for recém-criada, diga sem drama e proponha
/meconheca. - Curto: o relatório inteiro cabe em uma tela.