Tune skill
Ajuste fino é um conjunto de pequenas edições baseadas em evidências em uma skill que já existe. Não é uma reescrita. O objetivo é uma skill que dispare nas solicitações certas, não atrapalhe suas irmãs e passe o trabalho adiante em um formato definido.
Regras básicas
- Leia o SKILL.md real primeiro. READMEs, descrições de repositórios e listagens se desviam do arquivo que o agente realmente carrega. Qualquer afirmação sobre uma skill deve vir do seu SKILL.md ou de suas referências. Se não puder abrir um arquivo, nomeie-o e diga o que está inferindo como alternativa.
- Verifique suas próprias afirmações. Se um arquivo que você leu depois contradizer algo que você disse antes, diga isso claramente e corrija. Não contorne silenciosamente.
- Edições mínimas, a voz do autor. Altere apenas o que a auditoria encontrou e nada mais. Mantenha chaves de frontmatter que você não reconhece (
version,argument-hint,user-invocable). Nunca enfraqueça regras de honestidade, segurança ou privacidade. - Não afirme o que você não executou. Diga quais verificações foram executadas, quais casos de teste foram apenas escritos e quais arquivos você nunca viu.
Fluxo de trabalho
1. Coletar
Obtenha o SKILL.md da skill alvo e de cada skill irmã que ela toca, além de quaisquer referências que você puder acessar. Se o usuário fornecer um link que você não pode abrir, peça o texto do arquivo ou sua URL. Se a skill for uma pasta no disco, execute o script de verificação (etapa 6) agora para uma primeira leitura.
2. Mapear
Escreva um breve inventário por skill: o que sua descrição promete, seus modos ou comandos, os arquivos de referência que nomeia e o que ela passa adiante e para quem. Coloque descrições de irmãs e listas de comandos lado a lado. Sobreposições só aparecem quando você consegue ver ambas.
3. Auditar
Trabalhe com references/audit-checklist.md. Para cada descoberta, registre a evidência (cite a linha), a gravidade (quebra de disparo, confuso ou cosmético) e a menor correção. Reporte o mais grave primeiro.
4. Estabelecer limites
Quando duas skills reivindicam a mesma solicitação, dê um único dono. Use a divisão que o próprio design do usuário já utiliza (por exemplo, veredito versus artefato: uma skill julga, a outra escreve). Pergunte ao usuário apenas quando o design dele não resolver, e pergunte uma vez.
5. Editar
Faça a menor alteração que corrija cada descoberta. Quando o usuário for colocar o resultado diretamente em um repositório, devolva arquivos de substituição completos e copie o texto intocado exatamente. Quando uma correção precisar de uma nova peça compartilhada (um formato de handoff, por exemplo), adicione um novo arquivo de referência em vez de editar um que você não viu. Liste quaisquer arquivos de referência que provavelmente precisam de uma atualização correspondente.
6. Validar
Execute o script de verificação em cada pasta de skill:
python scripts/check_skill.py <caminho-para-pasta-da-skill>
Ele verifica se o nome corresponde à pasta, a descrição está dentro do limite de 1024 caracteres e tem palavras-chave de disparo e limite, o H1 corresponde ao nome, os arquivos referenciados existem e o corpo fica em um comprimento razoável. Corrija cada FAIL. Julgue cada WARN. Se você tiver apenas texto colado, salve o SKILL.md em uma pasta nomeada com o nome da skill e execute-o lá; avisos de referência ausente são esperados nesse caso.
7. Escrever casos de teste
Siga references/test-cases.md. Cada limite que você alterou recebe um caso de cada lado. Execute-os manualmente comparando com as descrições. Alguns agentes incorporam um loop de disparo automatizado em suas ferramentas de autoria; se você não executou um, não sugira que o fez. Diga quais você executou.
8. Reportar
Mantenha curto:
- O que mudou, por skill, e por que (uma linha cada).
- Correções para qualquer coisa que você disse antes.
- O que você não pôde ver ou não executou.
- Um próximo passo.
Comece com as mudanças, não com o processo.