Escrevendo Habilidades
Um pipeline de 4 fases: Coletar → Questionar → Planejar → Implementar.
Fase 1: Coletar
Use AskUserQuestion com perguntas agrupadas por domínio em 4 domínios. Cada domínio recebe 1 chamada com 2 a 4 opções e uma recomendação (primeira opção = (Recomendado)).
- Propósito — Qual tarefa/domínio a habilidade cobre? Quem a usa?
- Casos de Uso — Quais cenários específicos ativam essa habilidade? Quais palavras-chave?
- Estrutura — Ela precisa de scripts? Arquivos de referência? SKILL.md único ou vários arquivos?
- Ferramentas — Quais ferramentas ou outras habilidades ela deve invocar ou referenciar?
Fase 2: Questionar
Invoque a habilidade grill-me, passando os requisitos coletados. Direcione-a para usar os domínios adaptados à habilidade em skill-grill-domains.md (Intenção, Escopo, Design, Casos Limítrofes). Pule domínios irrelevantes (Fluxo de Dados, Dependências, Implantação, Testes).
Fallback (grill-me indisponível): Execute um mini-questionário inline usando AskUserQuestion diretamente. Para cada domínio em skill-grill-domains.md, agrupe 2 a 4 perguntas por chamada com recomendações e opções.
Fase 3: Planejar
Produza um blueprint estruturado da habilidade usando o template em blueprint-template.md. Apresente o blueprint no contexto da conversa (não o escreva em disco). O usuário deve aprovar antes de prosseguir. Se o usuário solicitar alterações, revise e reapresente.
Fase 4: Implementar
Crie todos os arquivos da habilidade seguindo o blueprint aprovado. Totalmente automatizado — o agente escreve tudo.
Em seguida, execute a Fase 4b: Revisão usando os critérios de quality-criteria.md:
- Auto-verificação — Verifique critérios mensuráveis (contagem de linhas, tamanho da descrição, gatilhos, profundidade de referência). Corrija quaisquer falhas antes de prosseguir.
- Revisão subjetiva — Apresente a lista de verificação ao usuário via
AskUserQuestion. Se o usuário sinalizar problemas, revise e re-verifique.
Estrutura da Habilidade
nome-da-habilidade/
├── SKILL.md # Instruções principais (obrigatório, <100 linhas)
├── references/ # Documentos de suporte (se necessário)
│ └── dominio-ref.md
└── scripts/ # Scripts utilitários (se necessário)
└── helper.sh
Fallback (sem AskUserQuestion)
Se AskUserQuestion não estiver disponível, recorra a perguntas baseadas em texto:
[Cabeçalho] — [Tópico] Recomendado: [Sua recomendação e por quê] Alternativas: (A) [Opção] — [compensação] | (B) [Opção] — [compensação]
Padrões de Qualidade
Consulte quality-criteria.md para requisitos de descrição, critérios de auto-verificação, lista de verificação de revisão subjetiva e orientações sobre quando adicionar scripts ou dividir arquivos.