Skill de Formatação de Artigos para WeChat (公众号)
Converte um artigo em Markdown em HTML pronto para copiar e colar no editor de artigos do WeChat (公众号), mantendo todos os estilos após a colagem.
O principal ativo é a biblioteca de componentes de tema em references/ (cada tema: variáveis de design + HTML completo dos componentes + esqueleto do template + regras de mapeamento), mais uma biblioteca de componentes incrementais comum (blocos de código / imagens·GIF / tags de título pequenas, compartilhadas por todos os temas). A lista de temas tem como única fonte references/theme-index.md. Este SKILL.md é responsável apenas pelo fluxo e decisões; todo o código HTML específico deve ser obtido da biblioteca de componentes, nunca escrito de memória.
Fluxo de Trabalho
0. Entrada e Normalização do Formato
O usuário pode fornecer: texto Markdown ou caminho de arquivo .md (vai direto para o passo 1), .docx, .pdf, .txt/texto simples sem marcação, ou rich text de página web. Entradas que não são Markdown devem primeiro ler references/format-normalize.md e seguir suas regras para converter em rascunho Markdown e confirmar a estrutura (docx usa scripts/extract_docx.py, PDF usa Leitura paginada + limpeza de ruído, texto simples usa heurísticas de títulos para inferir estrutura). Se nada for fornecido, solicite ao usuário.
Se o usuário disser "formate direto / automático / um clique / não pergunte", entre em modo totalmente automático: pule a confirmação da estrutura e a pergunta sobre o tema, infira automaticamente a estrutura, escolha o tema com base no assunto, formate e valide, e na entrega inclua uma nota explicativa da decisão (estrutura dos capítulos, títulos escolhidos, motivo da escolha do tema).
1. Escolha do Tema (Recomendação Automática)
Leia references/theme-index.md (a única fonte de informações sobre temas). Recomende ativamente o tema mais adequado com base no assunto do artigo e peça confirmação do usuário em uma única etapa – recomende, mas não defina sem consulta:
- Usuário já especificou o tema na solicitação → use diretamente, sem perguntar.
- Assunto tem encaixe claro → pergunte em uma única confirmação: "Sugiro usar XX (motivo). Confirma ou prefere outro?" Opções: o recomendado + 1~2 alternativas + "Ver todos". Referência de assunto → tema (coluna "Cenários de Uso" do theme-index):
- Tutoriais / Avaliações / Listas / Ferramentas / Organização de Conhecimento / Metodologias (alta densidade de informação) → 摸鱼绿
- Análises Aprofundadas / Opiniões / Tópicos de Força → Vermelho e Branco
- Design / Críticas de Tecnologia / Opiniões Profissionais / Marcas Premium → 石墨极简风
- Zen / Vida Minimalista / Ensaios Profundos → 留白禅意风
- Comparação de Ferramentas / Avaliações Criativas (metáfora visual de recibo) → 摸鱼票据风
- Boletim Interno / Avaliações Aprofundadas / Estudos de Caso → 橄榄手记
- Sem tendência clara → por padrão, a primeira linha do theme-index (摸鱼绿) é a recomendação principal, colocada em primeiro lugar. Use AskUserQuestion para permitir que o usuário escolha entre algumas opções (se houver mais de 4 temas, primeiro agrupe por estilo e pergunte, depois pergunte sobre os temas dentro do grupo).
- Modo totalmente automático (usuário disse explicitamente "formate direto / um clique / não pergunte") → não faça perguntas, escolha automaticamente o tema mais adequado ao assunto ou o primeiro da lista padrão, e na entrega explique o motivo da escolha.
- Usuário não gosta de nenhum tema existente / quer um novo estilo → siga o fluxo de "Geração de Tema Personalizado" (veja seção abaixo), gere e registre, depois volte a este passo para usar o novo tema.
- theme-index está vazio → pare a formatação, informe ao usuário que é necessário primeiro adicionar um estilo de tema (pode seguir a "Geração de Tema Personalizado").
Somente depois que o usuário definir o tema, prossiga para a correspondência de componentes dentro desse tema (passos 3 e 4: determinar o tipo de artigo → selecionar a combinação de componentes de acordo com a receita do tema).
2. Ler a Biblioteca de Componentes (Duas Partes)
(1) Com base na coluna "Arquivo da Biblioteca de Componentes" do tema no theme-index, leia a biblioteca de componentes exclusiva do tema em references/theme-{identificador}.md (contém cartão de introdução, título de capítulo, marcação de corpo, assinatura, etc., específicos do tema).
(2) Ao mesmo tempo, leia a biblioteca de componentes incrementais comum references/common-components.md – blocos de código, imagens/GIF e tags de título pequenas são compartilhados por todos os temas, basta aplicar a cor principal do tema atual.
A geração subsequente depende exclusivamente dessas duas bibliotecas de componentes; o HTML deve ser obtido delas, nunca escrito manualmente.
3. Analisar a Estrutura do Markdown
| Elemento | Regra de Identificação |
|---|---|
| Título do Artigo | # Título ou frontmatter title |
| Citação de Abertura | Bloco > citação no início do artigo |
| Título de Capítulo | ## Título |
| Subcapítulo | ### Título |
| Negrito / Destaque / Sublinhado | **texto** / ==texto== / <u>texto</u> ou ++texto++ |
| Parágrafos Citados | > texto que não seja no início |
| Imagem / GIF | 、 (GIF é tratado como imagem) |
| Código / Comando / Prompt | ```bloco de código```、`código` inline |
| Linha Horizontal / Listas | ---、*** / - item ou 1. item |
| Tabelas | Tabela Markdown separada por ` |
Após analisar a estrutura, determine o tipo de artigo (use o tipo dominante, pode ser composto): Tutorial/Guia Prático, Lista/Inventário de Ferramentas, Opinião/Análise Aprofundada, Entrevista/Perfil, Análise de Dados/Relatório, Estilo de Vida/Ensaio Emocional, Estudo de Caso Prático. Critérios: muitos passos e comandos → Tutorial; muitos itens paralelos → Lista; muitas citações e narrativas de pessoas → Entrevista; muitos números e comparações → Dados; muita argumentação e dedução → Opinião.
4. Selecionar Combinação de Componentes Conforme a Receita → Montar o HTML
Primeiro, consulte a tabela "Tipo de Artigo → Combinação de Componentes" da biblioteca de temas escolhida e, com base no tipo de artigo, determine a combinação central de componentes e os componentes decorativos para este artigo – não pegue a biblioteca de componentes e selecione componentes aleatoriamente parágrafo por parágrafo; a receita garante a consistência do estilo de formatação para artigos do mesmo tipo. Para elementos fora da receita, complemente de acordo com a tabela de regras de mapeamento da biblioteca de temas.
Em seguida, monte de acordo com a seção "Esqueleto do Template de Artigo Completo" da biblioteca de temas, substituindo cada elemento Markdown pelo componente correspondente:
- A ordem do esqueleto deve seguir a biblioteca de temas; esqueletos de temas diferentes podem ser diferentes. Não aplique o esqueleto de outro tema.
- Marcações inline devem ser mapeadas semanticamente para os componentes correspondentes na biblioteca de temas escolhida (os números dos componentes podem variar entre bibliotecas; sempre use a semântica, não números fixos):
**negrito**→ negrito na cor principal;==destaque==→ destaque com fundo gradiente;<u>texto</u>ou++texto++→ sublinhado;~~texto~~→ marcador de texto (meio destaque no fundo);>citação→ bloco de citação destacado. - Componentes da biblioteca de componentes incrementais comum:
```bloco de código```→ 1a escuro / 1b claro,`código`inline → 1c;→ 2a imagem (adicione componente de descrição somente se houver descrição),.gif→ 2b GIF; para pequenos títulos/ênfase que precisam ser destacados → 3a título com barra vertical esquerda ou 3b tag pílula, frase de ouro → 3d, dica/anotação lateral → 3e. Prioridade: primeiro consulte a tabela de regras de mapeamento da biblioteca de temas – se o tema tiver um componente semanticamente equivalente (como sua própria frase de ouro/bloco de dica), use a versão da biblioteca de temas para manter a consistência de estilo; somente se a biblioteca de temas não tiver o componente correspondente, use os componentes 3x da biblioteca comum e aplique suas regras de troca de cor para a cor do tema. - Um artigo usa apenas o conjunto de componentes do tema escolhido, sem misturar componentes de temas diferentes.
- Para ênfase e subtítulos, use "pequena tag / barra vertical esquerda", não use bordas tracejadas: para destacar um subtítulo ou um trecho, use o título com barra vertical esquerda (3a), tag pílula (3b), frase de ouro/bloco de dica com barra vertical esquerda (3d/3e); não use uma moldura tracejada (
dashedborder) ao redor de um título, isso fica pesado e rouba a atenção.
5. Verificação de Conformidade (Obrigatória)
Após escrever o HTML no arquivo de destino, execute obrigatoriamente o script de verificação; os ERRORs devem ser zero para considerar a tarefa concluída:
# Use o caminho absoluto da skill onde o script reside, o caminho do HTML também deve ser o caminho real (geralmente diretórios diferentes)
<SKILL_ROOT>/scripts/validate_gzh_html.py <caminho_real_do.html_gerado>
Ele verifica deterministicamente itens proibidos pela plataforma e o encapsulamento <span leaf>. Se reportar ERROR, volte ao passo 4 e corrija; WARNINGs de pontuação de meia largura também devem ser corrigidos para zero antes da entrega (este é o ponto de retrabalho mais frequente no uso real).
6. Saída
Formato do artefato: fragmento de corpo <section>…</section> puro, começando pelo contêiner global. Não inclua <!DOCTYPE>/<html>/<head>/<body> – o editor do WeChat aceita apenas fragmentos de corpo; invólucros extras de documento serão descartados ou interferirão na colagem.
- Arquivo de corpo limpo: Salve o HTML no diretório de trabalho atual, com o nome de arquivo
{nome_original_do_arquivo}_formatado_tema_{nome_chinês_do_tema}({identificador_inglês}).html(identificador inglês = nome do arquivo da biblioteca de componentes do theme-index, sem o prefixotheme-e o sufixo.md). Este arquivo é usado para verificação e colagem manual de fallback. - Página de preview com botão "Copiar" (para o usuário copiar com um clique, evitando a seleção manual de todo o conteúdo):
Produz<SKILL_ROOT>/scripts/wrap_preview.py <caminho_do_acima_.html_limpo>{...}_preview.html– quando aberto no navegador, há um botão "Copiar para WeChat" no canto superior direito; um clique copia o rich text renderizado para a área de transferência (equivalente a Ctrl+A/Ctrl+C) e, em seguida, Ctrl/⌘+V no editor do WeChat. O botão e o script estão apenas no invólucro de preview, não dentro da seção<section>que é copiada, portanto o que é colado no WeChat continua sendo o corpo limpo e em conformidade. - Informe ao usuário: Abra
{...}_preview.html→ clique no botão "Copiar" no canto superior direito → cole no editor do WeChat; e forneça o caminho do arquivo de corpo limpo como fallback. Anexe a conclusão do script de verificação (aprovado / warnings restantes).
Processamento Inteligente Durante a Geração (estes são diferenciais desta skill, devem ser feitos)
- Numeração automática de capítulos: atribua
01/02/03…de acordo com a ordem de aparecimento de##; se o último capítulo for do tipo conclusão/resumo, use a variante de número de conclusão especificada pela biblioteca de temas (ex.:∞); se a biblioteca de temas não especificar, continue usando a numeração numérica. - Tags em inglês: gere tags em inglês a partir dos títulos dos capítulos em chinês (TEST → TEST, TUTORIAL → TUTORIAL, SUMMARY → SUMMARY, THOUGHTS → THOUGHTS…); use quando a biblioteca de temas tiver um slot correspondente.
- Sublinhado de palavras-chave no corpo (diferencial central): para cada parágrafo do corpo, encontre ativamente 1–3 frases mais importantes e marque-as com o CSS de sublinhado desse tema (veja theme-index). Priorize marcar pontos de vista centrais, conclusões, dados-chave, nomes próprios; frases de 4–15 caracteres; se um parágrafo inteiro não tiver ponto principal, pode não marcar. Mesmo que o original não tenha nenhum negrito, adicione ativamente o sublinhado – é a marcação básica mais frequente.
- Destaque de palavras-chave na citação de abertura: identifique palavras centrais na frase de ouro inicial e marque-as com o componente de destaque.
- Extração de sumário: extraia os primeiros 3
##como pontos principais para o guia/sumário (quando a biblioteca de temas tiver um componente de sumário). - Atribuição no cartão de citação de abertura: determine com base no autor ou tema do artigo – se o artigo tiver atribuição, escreva "—— Nome do autor"; se não tiver autor claro, use uma breve assinatura relacionada ao tema ou omita completamente. Não escreva fixo "甲木" (a área de assinatura no final também usa
{{nome_do_autor}}como placeholder, veja o item 7). - Área de assinatura do autor no final (autor preenche, apenas um local no final): por padrão, não escreva nenhum nome fixo, use um placeholder de assinatura para o usuário substituir pelo seu.
- Primeira frase (apresentação do autor):
Eu sou {{nome_do_autor}}, {{breve descrição, ex.: apaixonado por compartilhar insights sobre IA e conteúdo útil}}– se o usuário forneceu nome ou descrição na solicitação/preferência, preencha diretamente; se não, mantenha o placeholder{{nome_do_autor}}/{{descrição}}e, na entrega, incentive o usuário a substituir pela sua assinatura. - Segunda frase (incentivo à interação, geral pode ser mantido como está):
Se você achou este artigo útil, sinta-se à vontade para **curtir, compartilhar e recomendar** – até o próximo encontro - Se o final do artigo original já tiver um parágrafo de assinatura do autor (ex.: "Eu sou XXX…") → mantenha a assinatura original, não a substitua pelo placeholder.
- Primeira frase (apresentação do autor):
- Conversão de listas: processe de acordo com as regras de mapeamento da biblioteca de temas; se não houver componente de lista exclusivo, converta em parágrafos de corpo com recuo.
- Pontuação chinesa de largura total: toda a pontuação no corpo deve ser de largura total (,。!?:;""''()—— …), nunca use meia largura
, . ! ? :e aspas retas inglesas" '. Ao gerar o HTML, escreva diretamente as aspas curvas ""'', não escreva aspas retas primeiro e depois substitua – as aspas retas no texto original devem ser convertidas na hora durante a transcrição. Exceção: blocos de código, código inline, nomes próprios em inglês/URLs/identificadores de código dentro de código mantenham-se inalterados.
Hierarquia Visual (3 níveis progressivos, comum a todos os temas)
| Nível | Função | Frequência | Meio |
|---|---|---|---|
| Nível Âncora | Âncora mais forte: nome do produto/passos/CTA/frases de ouro centrais | ≤ 5 ao longo de todo o artigo | Negrito na cor principal, citação com fundo escuro e texto branco |
| Nível Marcação | Palavras-chave do corpo, 1–3 por parágrafo | Alta frequência | Marcação com sublinhado |
| Nível Container | Blocos de citação, tags de conceito, ênfase em frases longas | Conforme necessário | Citação com fundo claro, marcador de texto, medalha |
Linhas Vermelhas da Plataforma (Central, Verificação Completa pelo Script de Validação)
- Proibido:
<style>/<script>/<div>, atributosclass/id,position:fixed/absolute/sticky,float,@media/@keyframes,display:grid, variáveis CSS, fontes externas/CSS. - Obrigatório: todos os estilos inline
style; todos os nós de texto devem ser encapsulados com<span leaf="">texto</span>(caso contrário, os estilos são perdidos após a colagem). - Permitido:
display:flex(limitado),linear-gradient,border-radius,box-shadow,<section>/<p>/<span>/<strong>/<img>/<h3>.
Gotchas (Armadilhas Encontradas em Formatações Reais)
- Falta de encapsulamento
<span leaf>é o erro fatal mais comum – após colar no WeChat, os estilos inteiros são perdidos. Dependa do script de validação do passo 5, não pule. - Sublinhado: implemente parágrafo por parágrafo, 1–3 frases por parágrafo. Não sublinhe um parágrafo inteiro (perde o foco), nem deixe alguns parágrafos com sublinhado e outros sem; descrições-chave em itens de lista também devem ser marcadas.
- Numeração de capítulos errada: siga estritamente a ordem de
##, não pule números; a variante de número de conclusão é usada apenas no último capítulo, não pode ser usada em capítulos intermediários. - Área de assinatura: existe apenas um no final: use um texto fixo, não apareça no meio ou em vários lugares; se o final do artigo original já tiver uma assinatura de autor / parágrafo do tipo "curtir/compartilhar/recomendar", reconheça e incorpore nessa única área de assinatura/cartão CTA; não mantenha o parágrafo original e gere outro.
- Criação forçada de descrição de imagem: somente se
realmente tiver texto de descrição, gere o componente de descrição;com alt vazio não invente uma descrição. - Imagem adaptativa, não preenche toda a largura:
<img>sempre commax-width:100%;height:auto;display:block;margin:0 auto– exibe a imagem em seu tamanho original, centralizada; imagens grandes são reduzidas à largura do contêiner, imagens pequenas mantêm o tamanho original. Não usewidth:100%(isso esticaria imagens pequenas, deixando-as borradas); apenas elementos de layout como tabelas, cartões de capa, fluxogramas usamwidth:100%. - Misturar componentes de temas diferentes: um artigo usa apenas os componentes do tema escolhido + biblioteca comum; não pegue componentes de outros temas.
- Abuso do nível âncora: a ênfase mais forte em todo o artigo ≤ 5 locais; marcar tudo em negrito equivale a não ter destaque.
- Omissão de conteúdo original: cada parágrafo, cada imagem deve ser convertido; não omita; não adicione ou remova conteúdo substancial do original.
- Placeholder de imagem residual: se a área de assinatura/componente CTA tiver um placeholder de imagem de cartão de visita (ex.:
<img src="...URL_imagem_cartão_ou_imagem_guia">), se não houver URL de imagem real, exclua a linha inteira; não deixe placeholders no artefato. - Sumário é selecionado, não completo: o componente de guia/sumário exibe 3 pontos principais selecionados, não a lista completa de capítulos; se houver mais de 3 capítulos, escolha os 3 mais importantes; não force ou engane o leitor fazendo-o pensar que existem apenas 3 capítulos.
- Não use bordas tracejadas: para destacar títulos/ênfase, use pequenas tags ou barras verticais (biblioteca comum 3a–3e); não use
border:…dashedcom moldura tracejada ao redor do título. Exceção: componentes tracejados explicitamente definidos na biblioteca de temas (como a caixa de citação quote-box do 摸鱼绿, o cartão de destaque oneliner-card) são características de estilo do tema; use-os normalmente de acordo com a especificação da biblioteca de temas. - Pontuação não pode misturar meia largura: vírgulas, pontos de meia largura, aspas retas inglesas
"'devem ser alterados para largura total; mas símbolos de meia largura dentro de blocos de código/código inline devem permanecer inalterados, não "largura total" o código. - Código/Prompt devem usar blocos de código: código, comandos, prompts no artigo devem usar o componente de bloco de código da biblioteca comum (1a/1b); não os coloque em parágrafos comuns ou blocos de citação, caso contrário, recuo e monoespaçamento serão perdidos.
- Blocos de código devem ser compactos, evitar grandes espaços em branco: use a escrita "um
<p style="margin:0">por linha" dos componentes 1a/1b da biblioteca comum; nunca usewhite-space:pre– isso renderizaria o recuo antes de spans e as quebras de linha entre linhas no código fonte HTML como grande recuo à esquerda + linhas em branco; para recuo, use apenas espaços de largura total; o espaçamento entre linhas depende deline-height:1.6. - Materiais a serem complementados centralizados: placeholders como
【Inserir…】, captura de tela/GIF/vídeo/imagem de resultado a serem feitos, use o componente 2c de bloco placeholder de material centralizado (moldura tracejada suave com fundo claro + ícone centralizado e descrição) da biblioteca comum, não use blocos de dica alinhados à esquerda.
Geração de Tema Personalizado (Segundo Fluxo de Trabalho)
Quando o usuário quiser um novo estilo diferente dos temas integrados (disser "gerar um novo tema / estilo personalizado / fazer um conjunto de componentes com base nesta imagem de referência", ou não gostar de nenhum tema existente), leia references/theme-generator.md e execute estritamente de acordo com seu fluxo:
- Coletar preferências: a descrição do tema é obrigatória (ou imagem de referência); nome/ID/cinco cores/fonte/três tipos de TAG/curvatura/sombra podem ser deixados em branco e serão preenchidos automaticamente; pergunte tudo de uma vez, não faça perguntas campo por campo.
- Gerar HTML da biblioteca de blocos: execute exatamente o 【Prompt de Geração】 no final do theme-generator.md, produza uma biblioteca de blocos completa de 45~75 blocos, salve em
assets/theme-previews/{theme-id}.html– todos os blocos dispostos continuamente na mesma página; o usuário abre a página inteira no navegador para navegar de uma vez e confirmar o estilo, não confirme bloco por bloco. - Converter + Registrar: após o usuário confirmar o estilo, converta para o
references/theme-{identificador}.mdpadrão (deve adicionar encapsulamento<span leaf="">, remover IDs de preview, completar os cinco capítulos, regras detalhadas no terceiro passo do theme-generator.md), registre no theme-index.md, executecomponent_lint.pyaté 0 ERROR. - Após a entrega, esse tema se torna um tema opcional permanente, com os mesmos direitos que os temas integrados para formatações futuras.
Durante a fase de geração, as regras do prompt prevalecem; durante a fase de conversão para a biblioteca de temas, as "Linhas Vermelhas da Plataforma" e "Especificações para Adicionar Novo Tema" deste arquivo prevalecem (em caso de conflito, estas últimas têm prioridade, pois a biblioteca de temas determina diretamente o artefato de formatação).
Especificações para Adicionar Novo Tema
Novo tema nomeado como references/theme-{identificador_inglês}.md, o conteúdo deve incluir:
- Tabela de consulta rápida de variáveis de design (cor principal/fundo claro/cor de texto escura/cor do título/cor do corpo/cor da linha de divisão, etc.)
- HTML completo de cada componente (estilos inline + encapsulamento
<span leaf="">, obedecendo às "Linhas Vermelhas da Plataforma" acima) - Esqueleto do template de artigo completo (ordem de montagem dos componentes; se houver componente de sumário/navegação, esclareça sua posição relativa à capa/introdução)
- Tabela de combinação de componentes por tipo de artigo (combinação de componentes centrais + componentes decorativos para cada tipo de artigo; a receita é a chave para a consistência do estilo de formatação)
- Tabela de regras de mapeamento Markdown → Componente
Após adicionar, registre uma linha em references/theme-index.md (nome do tema / cor principal / cenários de uso / arquivo da biblioteca de componentes / CSS de sublinhado do corpo) e execute python3 scripts/component_lint.py . para confirmar que a biblioteca de componentes não tem antipadrões (0 ERROR).
Casos de teste de regressão para acionamento e seleção de tema podem ser encontrados em
references/eval-cases.md(usados para verificação de regressão durante a manutenção, não afetam a geração única).
