voz-do-boletim-informativo

Voz do Boletim Informativo

Runtime do Codex e Claude

• Use esta habilidade no Codex ou Claude com as ferramentas realmente disponíveis na tarefa atual. Os exemplos de AskUserQuestion descrevem as perguntas, não uma API obrigatória: use uma ferramenta de pergunta disponível dentro de seus limites, ou pergunte no chat. Reutilize respostas e material de origem já fornecidos.
• Trabalhe no projeto selecionado pelo usuário. Leia seus arquivos about-me.md, voice.md e arquivos de marca relevantes antes do trabalho personalizado. Confirme o autor pretendido se os arquivos entrarem em conflito ou contiverem padrões iniciais. Pergunte por fatos faltantes ou execute voice-builder; nunca herde a identidade, contas ou arquivos privados do mantenedor.
• Resolva os references/ incluídos relativos a esta pasta de habilidade. Para uma atualização de perfil explicitamente solicitada, leia e atualize o about-me.md, voice.md ou newsletter-voice.md canônico no local, preservando fatos e regras não relacionados do usuário. Os consumidores devem reler esses arquivos canônicos. Use um novo nome de arquivo apenas para novas entregas que colidiriam com arquivos existentes não relacionados. A instalação por si só nunca inicia uma entrevista ou escreve arquivos. Não escreva aprendizados persistentes a menos que solicitado.
• Use as evidências fornecidas primeiro. Verifique reivindicações externas por meio de ferramentas de busca/origem disponíveis quando necessário. Se uma fonte ou integração não estiver disponível, nomeie a capacidade faltante e ofereça entrada de texto/exportação fornecida. Nunca invente fatos, experiência em primeira pessoa, métricas ou uma execução bem-sucedida de ferramenta.
• Conecte apenas os serviços necessários para a rota escolhida por meio da conta existente do usuário. Nunca imprima credenciais ou sobrescreva conexões. Esboçar, salvar e revisar não autorizam publicar, enviar mensagens ou alterar contas.

Verificação de pré-requisitos

No momento em que esta habilidade for acionada, verifique a raiz do projeto em busca de voice.md e about-me.md.

Se algum dos arquivos estiver faltando, diga ao usuário:

A voz do boletim informativo se baseia no seu perfil de voz geral. Execute o voice-builder primeiro (carregue a habilidade ou diga "construa minha voz"), depois volte aqui quando about-me.md e voice.md estiverem no projeto.

Então pare. Não continue até que ambos os arquivos existam.

Se ambos os arquivos existirem, leia-os completamente e vá direto para a Etapa 1.

Etapa 1. Verificar amostras

Pergunte ao usuário no chat:

Você tem 2 a 3 edições anteriores do boletim que eu possa usar como aprendizado?

Sim: cole-as aqui (uma por mensagem ou todas de uma vez) Não: digite "arquétipo" e eu construirei a partir de um modelo ajustado à sua voz

Aguarde a resposta.

Se o usuário colar 2 ou mais boletins, vá para a Etapa 2a. Se o usuário digitar "arquétipo", vá para a Etapa 2b. Se o usuário colar 1 boletim, peça pelo menos mais um. Se ele tiver apenas um, ofereça: "Uma amostra não é suficiente para detecção de padrões. Quer mudar para o modo arquétipo e usar seu único boletim como ponto de referência?"

Etapa 2a. Análise baseada em amostras

Leia cada boletim completamente. Procure padrões entre as edições, não peculiaridades isoladas. Extraia:

Fórmula de abertura

• O que as primeiras 3 frases fazem (resultado específico, observação cultural, afirmação, cena, pergunta)
• Extensão da seção de abertura antes da primeira quebra estrutural
• Movimento de credibilidade (como o autor estabelece autoridade no início)
• Promessa de valor (o que o leitor é informado que receberá)

Estrutura da seção

• Configuração de problema ou contraste
• Framework nomeado ou prosa livre
• Etapas numeradas, métodos ou argumento contínuo
• Padrões de exemplos e evidências
• Seção de bônus ou extensão
• Fórmula de encerramento e despedida

Filosofia de dados

• Números específicos por edição (conte-os)
• Estilo de atribuição de fonte (vinculado, nomeado, não creditado)
• Proporção exemplo-abstração
• Reconhecimentos de limitação ou falha

Formatação

• Uso de cabeçalhos (frequência, hierarquia)
• Uso de listas (numeradas, com marcadores, setas)
• Uso de negrito e itálico
• Formatação de prompt, bloco de código ou citação em bloco
• Marcadores visuais (setas, marcas de verificação, emojis, se houver)

Extensão

• Faixa de contagem de palavras entre amostras
• Contagens de palavras por seção

Marcadores de voz exclusivos do formato boletim

• Dicas profissionais ou chamadas (frequência, formato)
• Encerramentos prospectivos
• Frase de despedida se consistente entre amostras
• Metatransparência (o autor reflete sobre o processo ou pede feedback)

Sinais de ausência

• Palavras, construções ou estruturas ausentes de cada amostra
• Movimentos de encerramento que o autor nunca usa
• Tópicos que o autor nunca aborda

Em seguida, vá para a Etapa 3.

Etapa 2b. Seleção de arquétipo

Chame a ferramenta AskUserQuestion com uma única pergunta:

[
  {
    "question": "Qual arquétipo de boletim se encaixa no que você quer escrever?",
    "header": "Arquétipo",
    "multiSelect": false,
    "options": [
      {"label": "Tutorial de dados", "description": "Números, frameworks, métodos passo a passo com prompts"},
      {"label": "Ensaio contrário", "description": "Tome uma posição, defenda-a, nomeie a oposição"},
      {"label": "Análise de estudo de caso", "description": "Um assunto por edição, analisado em profundidade"},
      {"label": "Compilação selecionada", "description": "5 a 7 links com seu comentário a cada semana"},
      {"label": "Ensaio pessoal", "description": "Reflexão sobre um tema, história em primeiro lugar"},
      {"label": "Entrevista ou perfil", "description": "Uma pessoa por edição, perguntas e respostas ou narrativa"}
    ]
  }
]

Após o usuário escolher um arquétipo, carregue os padrões correspondentes de references/archetypes.md dentro desta pasta de habilidade. Ajuste cada campo usando voice.md e about-me.md antes de escrever newsletter-voice.md. Sinalize dentro do arquivo de saída que os padrões de arquétipo foram usados e que o arquivo deve ser revisitado após 5 edições publicadas.

Etapa 3. Escrever newsletter-voice.md

Crie newsletter-voice.md na raiz do projeto. Arquivo único, alvo de 800 a 1.200 palavras. Use esta estrutura:

# Voz do Boletim Informativo

## Origem
[Baseado em amostras: analisou X edições do boletim] OU [Baseado em arquétipo: [nome do arquétipo] ajustado para voice.md. Revisitar após 5 edições publicadas.]

## Público e propósito
[Quem lê este boletim e o que eles obtêm dele. Escrito a partir de about-me.md e voice.md. 2 a 3 frases.]

## Princípios de voz
[3 a 5 princípios fundamentais que a escrita sempre mantém. Cada um uma frase declarativa curta. Ajustado para o voice.md deste usuário.]

## Fórmula de abertura
[Como as edições começam. Inclua 2 modelos concretos com espaços reservados entre colchetes, por exemplo, "[Resultado específico com número]. [Marcador de credibilidade]. [Promessa de valor para esta edição]." Contagem de palavras alvo para a seção de abertura.]

## Fluxo da seção
[Estrutura padrão de uma edição, seção por seção, máximo de 5 a 8 seções. Breves notas sobre o que cada seção faz e quanto tempo dura.]

## Dados e evidências
[Como números e exemplos são usados. Regras específicas, por exemplo, "cada afirmação precisa de um número", "fontes vinculadas inline", "proporção exemplo-abstração aproximadamente 3:1".]

## Regras de formatação
[Cabeçalhos, listas, negrito, itálico, blocos de código, marcadores visuais. O que usar, o que evitar. Extraído de amostras ou padrões de arquétipo.]

## Encerramento e despedida
[Como as edições terminam. Declaração prospectiva versus resumo. Frase de despedida se existir uma consistente entre amostras (não invente uma).]

## O que este boletim nunca faz
[1 parágrafo curto ou 3 a 5 itens. Extraído de padrões de ausência entre amostras ou padrões de arquétipo. Apenas comportamentos, não uma lista de palavras proibidas.]

## Extensão
[Contagem de palavras alvo para edições padrão. Alvo separado para guias abrangentes mais longos se o usuário escrever ambos os formatos.]

Preencha cada seção a partir das amostras (ou padrões de arquétipo ajustados). Sem enchimento genérico. Se as amostras não cobrirem algo, diga "nenhum padrão claro entre as amostras" em vez de adivinhar.

Etapa 4. Confirmar e entregar

Diga ao usuário:

Sua voz de boletim informativo está construída. newsletter-voice.md está na raiz do seu projeto junto com about-me.md e voice.md. Quando quiser redigir uma edição, diga "escreva um boletim" e eu usarei os três arquivos juntos.

[Se modo arquétipo: Lembre-se de que este arquivo foi construído a partir de padrões de arquétipo. Após cerca de 5 edições publicadas, execute esta habilidade novamente com suas amostras reais para um perfil mais preciso.]

O que esta habilidade produz

Um arquivo na raiz do projeto:

• newsletter-voice.md: instruções de escrita específicas para boletins, cobrindo público, princípios de voz, fórmula de abertura, fluxo da seção, filosofia de dados, formatação, encerramento, padrões de ausência e metas de extensão

Regras

• Exija voice.md e about-me.md na raiz do projeto antes de executar. Pare e redirecione para voice-builder se algum estiver faltando.
• Mínimo de 2 amostras de boletim se o usuário escolher o modo baseado em amostras. Ofereça o modo arquétipo se houver menos.
• Mantenha newsletter-voice.md abaixo de 1.200 palavras. Conciso supera exaustivo.
• Não invente sinais de voz. Trabalhe apenas a partir de amostras ou padrões de arquétipo ajustados para voice.md.
• Não duplique conteúdo de voice.md. Consulte-o quando relevante. newsletter-voice.md adiciona apenas regras específicas do boletim.
• Não incorpore nomes específicos do usuário, URLs ou frases de despedida, a menos que apareçam consistentemente em 2 ou mais amostras.
• Não produza um arquivo de voz ou palavras proibidas separado. Padrões de ausência residem dentro de newsletter-voice.md como uma única seção.
• Inglês britânico em todo o texto, a menos que as amostras sejam claramente americanas.
• Nunca use travessões em nenhum arquivo de saída ou em nenhum rascunho.