Escritor de Habilidades

Use este como o único fluxo de trabalho canônico para criação e melhoria de habilidades. Condição de sucesso primária: maximizar a cobertura de entrada de alto valor antes da autoria para que a habilidade resultante tenha pontos cegos mínimos.

Carregue apenas os caminhos necessários para a tarefa:

Passo 1: Resolver alvo e caminho

1. Resolva o caminho da habilidade alvo e a operação pretendida (create, update, synthesize, iterate).
2. Leia references/mode-selection.md e selecione os caminhos necessários.
3. Classifique a habilidade (workflow-process, integration-documentation, security-review, skill-authoring, generic).
4. Faça uma pergunta direta se os requisitos de classe ou profundidade forem ambíguos; caso contrário, declare suposições explícitas.

Passo 2: Executar síntese quando necessário

Leia references/synthesis-path.md.

1. Colete e pontue fontes relevantes com proveniência.
2. Aplique regras de confiança e segurança ao ingerir conteúdo externo.
3. Produza decisões baseadas em fontes e status de cobertura/lacuna.
4. Carregue um ou mais perfis de references/examples/*.md quando a habilidade for híbrida.
5. Aplique o pacote de fontes de linha de base para fluxos de trabalho de autoria de habilidades.
6. Aplique portões de profundidade antes de passar para a autoria.

Passo 3: Executar iteração primeiro ao melhorar a partir de resultados/exemplos

Leia references/iteration-path.md primeiro quando o caminho selecionado incluir iteration (para operação de exemplo iterate).

1. Capture e anonimize exemplos com proveniência.
2. Reavalie o comportamento da habilidade em relação a fatias de trabalho e de retenção.
3. Proponha melhorias a partir de evidências positivas/negativas/correções.
4. Leve deltas de comportamento concretos para a autoria.

Pule esta etapa quando o caminho selecionado não incluir iteration.

Passo 4: Criar ou atualizar artefatos de habilidade

Leia references/authoring-path.md.

1. Escreva ou atualize SKILL.md em voz imperativa com descrição rica em gatilhos.
2. Crie arquivos de referência e scripts focados apenas quando justificado.
3. Siga references/skill-patterns.md, references/workflow-patterns.md e references/output-patterns.md para estrutura e determinismo de saída.
4. Para habilidades de autoria/geração, inclua exemplos transformados nas referências:
   • caminho feliz
   • variante segura/robusta
   • anti-padrão + versão corrigida

Passo 5: Otimizar a qualidade da descrição

Leia references/description-optimization.md.

1. Valide conjuntos de consultas should-trigger (deve acionar) e should-not-trigger (não deve acionar).
2. Reduza falsos positivos e falsos negativos com edições direcionadas na descrição.
3. Mantenha a linguagem do gatilho genérica entre Codex e Claude.

Passo 6: Avaliar resultados

Leia references/evaluation-path.md.

1. Execute uma verificação qualitativa leve por padrão (recomendado).
2. Para habilidades de integração/documentação e de autoria de habilidades, inclua a rubrica de profundidade concisa de references/evaluation-path.md.
3. Execute o playbook de avaliação mais aprofundado e a linha de base quantitativa vs. com habilidade apenas quando solicitado ou quando o risco justificar.
4. Registre resultados e riscos não resolvidos.

Passo 7: Registrar e validar

Leia references/registration-validation.md.

1. Aplique as etapas de registro do repositório.
2. Execute a validação rápida com portões de profundidade rigorosos.
3. Rejeite saídas rasas que falharem nos portões de profundidade ou nas verificações de artefatos necessários.

Formato de saída

Retornar:

1. Summary
2. Changes Made
3. Validation Results
4. Open Gaps

Quando Usar

…