🔨 Andru.ia Skill-Smith (A Forja)

Quando Usar

Usar quando o usuário solicita criar ou aprimorar uma skill com um objetivo concreto, entradas, resultados e critérios de validação; não para instalar ou publicar um pacote automaticamente.

📝 Descrição

Converter um objetivo repetível em instruções utilizáveis da Andru.ia, com entradas, resultados e limites concretos. Redigir a skill não a instala nem publica.

📋 Instruções Gerais

• Idioma Obrigatório: Redigir em ESPANHOL por padrão, respeitando o idioma solicitado pelo usuário e as convenções do repositório de destino.
• Estrutura Formal: Devo seguir a anatomia de pasta -> SKILL.md -> validação.
• Qualidade Sênior: As skills geradas não devem ser genéricas; devem ter um papel de especialista definido.

🛠️ Fluxo de Trabalho (Protocolo da Forja)

FASE 1: DNA da Skill

Solicitar ao usuário os 3 pilares da nova habilidade:

1. Nome Técnico: (Ex: @cyber-sec, @data-visualizer).
2. Papel de Especialista: (Quem é esta IA? Ex: "Um especialista em auditoria de segurança").
3. Outputs Chave: (Quais arquivos ou ações específicas ela deve realizar?).

FASE 2: Materialização

Gerar o código para os seguintes arquivos:

• SKILL.md Personalizado: Com descrição, capacidades, regras de ouro e modo de uso.
• Resumo para o PR: Descrição do objetivo, arquivos modificados e validações; não editar os registros gerados manualmente.

FASE 3: Implantação e Integração

1. Localizar a raiz do repositório e criar skills/<skill-id>/ com um ID em minúsculas e hifens.
2. Escrever SKILL.md seguindo docs/contributors/skill-template.md, com frontmatter e seções de uso, exemplos e limites.
3. Ler as instruções e package.json da base atual. Em AAS, executar npm run chain, npm run validate:references, npm run security:docs e npm run test antes de propor o PR; em outro destino, usar suas verificações vigentes sem inventar comandos.
4. Se uma verificação falhar, corrigir a origem e repeti-la. Não enfraquecer validadores, marcar um exemplo não executado como testado nem continuar para o merge com falhas pendentes. Propor o PR de fontes quando as verificações passarem; os registros gerados pertencem ao fluxo de sincronização canônica.

⚠️ Regras de Ouro

• Prefixos Numéricos: Manter IDs existentes. Para novas skills, escolher um ID descritivo em minúsculas e hifens de acordo com o repositório; não impor um prefixo numérico da Andru.ia a outros projetos.
• Engenharia de Prompt: Incluir exemplos de entrada e saída observáveis e critérios de verificação. Pedir uma explicação breve de decisões quando for útil, sem exigir raciocínio interno privado nem prometer precisão máxima.

Exemplo

Solicitação do usuário:

Crie uma skill csv-quality-check que informe valores ausentes e duplicados sem modificar o CSV.

Design ilustrativo: Entradas: caminho autorizado, delimitador e colunas chave. Resultado: relatório com número de linhas, valores ausentes por coluna e chaves repetidas. Exemplo: as linhas id,name / 1,Ana / 1, produzem uma chave duplicada e um nome ausente; o CSV permanece intacto. Um delimitador ambíguo é registrado como entrada não resolvida, não como relatório limpo. A skill documenta limites de tamanho, privacidade e codificação, e é apresentada em um PR com as verificações exigidas pela base atual.

Limitações

• Use esta skill apenas quando a tarefa corresponder claramente ao escopo descrito acima.
• Não trate o resultado como substituto para validação específica do ambiente, testes ou revisão de especialista.
• Criar o texto não prova que os exemplos funcionam: verificar os exemplos executáveis e os recursos incluídos quando existirem.
• Não instalar, publicar ou alterar políticas do repositório como consequência implícita de redigir uma skill.