Guia de Técnicas de Escrita e Estilo
Responsável por fornecer aos autores e outros skills de escrita técnicas narrativas aplicáveis, roteiros de capítulos e diretrizes de gênero, além de orientar a criação ou calibragem do bible/style-guide.md de um livro específico.
Quando Usar / Não Usar
Quando usar:
- Quando estiver travado em um parágrafo específico e precisar de orientações executáveis sobre cena, ritmo, diálogo, distribuição de informações, estrutura dupla, atmosfera ou tipos específicos de capítulos (preparação, ação, divisão de espólios, negociação, regras).
- Ao projetar a linguagem narrativa para gêneros híbridos (por exemplo, usar a linguagem de um sistema racional para descrever um sistema fantástico) ou consultar clichês e armadilhas comuns de um gênero específico.
- Para rascunhar o
bible/style-guide.mdde um novo livro, ou para extrair e solidificar o estilo pessoal do autor a partir de 2–3 capítulos já escritos, transformando-o em uma diretriz de equipe. - Ao receber uma referência de
fiction-chapter,fiction-reviewoufiction-planner, que necessita da leitura de uma técnica específica ou pacote de gênero.
Quando não usar (encaminhar para skills irmãs; na ausência do skill downstream, entregar apenas os artefatos desta etapa, a lista de tarefas e as verificações não executadas, sem assumir funções alheias):
- Para o ciclo completo de escrita de um novo capítulo (esboço, reescrita estrutural, pós-escrita): encaminhar para
fiction-chapter(se não instalado, entregar apenas as correções técnicas e a lista de tarefas do capítulo, explicando que o ciclo de escrita e pós-escrita não foi executado). - Para verificação rigorosa de regras (detecção de estilo AI, exclusão de testes, revisão entre capítulos) em um capítulo inteiro ou em textos externos: encaminhar para
fiction-review(se não instalado, entregar uma lista de verificação de estilo e explicar que o script de verificação e a revisão entre capítulos não foram executados). - Para sinopse, primeiros capítulos cruciais, arco/volume, hierarquia de ganchos ou agendamento de publicação diária: encaminhar para
fiction-planner(se não instalado, fornecer apenas técnicas de ritmo intracapítulo e explicar que o agendamento de volume/arco não foi feito). - Para manter fios soltos, subtramas, arquivos de personagens, linha do tempo, inventário de itens, ou lidar com conflitos entre texto congelado e configurações: encaminhar para
fiction-continuity(se não instalado, listar os pontos de entrada principais que precisam de atualização, sem modificar outros pontos de entrada). - Para inicializar a estrutura do projeto do zero, importar rascunhos antigos ou adicionar/atualizar capítulos recém-publicados na lista congelada: encaminhar para
fiction-init(se não instalado, pode ajudar a redigir obible/style-guide.mde listar as tarefas pendentes da estrutura; para atualizar a lista congelada, instruir o autor a atualizarfrozen.rangesem.fiction/config.jsone executarlint.mjs --freezeem duas etapas; este skill não executa essas ações).
Antes de Começar
Antes de começar, leia os três arquivos no diretório raiz do projeto (estrutura de diretórios e pontos de entrada principais veja SB §2, SB §5):
AGENTS.md: Foco em## Diretrizes deste Livro(diretrizes do protagonista, disciplina de ponto de vista, proibições e regras específicas do livro)..fiction/config.json: Foco embook.genres(IDs dos pacotes de gênero habilitados) elint.*(termos proibidos, regras de desidentificação).bible/sources.md: Confirme o ponto de entrada principal correspondente astyle_guide(padrão:bible/style-guide.md). Sebible/style-guide.mdjá existir, leia-o também.
Antes de escrever ou modificar qualquer arquivo legível por máquina, abra o arquivo de trechos correspondente (para este skill, references/formats/project.md) e escreva de acordo com o formato e os limites definidos, sem confiar na memória. Se o arquivo de configuração do projeto não existir, avise o autor que ele pode executar fiction-init para criar a estrutura do projeto e explique que, na ausência da configuração do projeto, as sugestões a seguir serão baseadas no padrão genérico.
Hierarquia de diretrizes (veja SB §3): AGENTS.md "Diretrizes deste Livro" > bible/style-guide.md > Pacotes de gênero > Padrão genérico deste skill. Em caso de conflito, alinhe-se à diretriz superior, sem sobrescrever arbitrariamente.
Princípios Fundamentais
Todas as técnicas giram em torno de cinco princípios básicos, evitando acúmulo de palavras bonitas ou fórmulas mecânicas:
- Concisão: Detalhes precisos valem mais que descrições floreadas. O desgaste de um objeto específico, a pausa de uma mão, têm mais força que um parágrafo inteiro de lirismo abstrato.
- Contraste: Use o ordinário da vida cotidiana para realçar o extraordinário ou anormal. Estabeleça primeiro as necessidades básicas e os limites de uma pessoa comum; quando a anomalia surgir, o impacto será maior.
- Espaço em branco: Não explique tudo para o leitor. Se a ação e os fatos já deixaram claro o significado, não adicione um resumo do autor no final do parágrafo; deixe o leitor conectar os pontos.
- Verossimilhança: As reações dos personagens devem obedecer à natureza humana real, não à conveniência da trama. Ao se deparar com o sobrenatural ou uma crise pela primeira vez, a reação de uma pessoa comum é geralmente dúvida, evitação ou avaliação, não heroísmo instantâneo.
- Ciclo Estrutural: Fases de grande escala (novo mapa, nova dungeon, novo volume) precisam de um esqueleto de progressão estável que crie no leitor a expectativa de "decifrar os requisitos → entrar em operação → encontrar problemas → obter recompensas", em vez de uma série de notas de viagem ou missões de jogo.
Fluxo de Trabalho
Escolha o Modo A ou Modo B com base na tarefa atual; este skill não possui scripts de execução. Todas as avaliações de texto e confirmações de diretrizes são feitas pelo modelo em colaboração com o autor.
Modo A: Consultar Técnicas ou Reescrita Direcionada
- Definir o problema de escrita: Primeiro, identifique em qual camada o problema se encontra — visualização da cena, tensão rítmica, qualidade do diálogo, distribuição de informações, atmosfera/suspense, tipo de capítulo ou diretriz de gênero.
- Ler apenas os documentos de referência relevantes: Consulte 1–2 arquivos
references/*.mdcorrespondentes, conforme a tabela de roteamento no final deste documento. Sebook.genresem.fiction/config.jsontiver um valor, leia também osreferences/genres/<genre>.mdcorrespondentes. Não leia todos os documentos irrelevantes. - Alinhar com as diretrizes do livro: Compare as regras gerais dos documentos de referência com
AGENTS.md"Diretrizes deste Livro" ebible/style-guide.md, item por item, filtrando os padrões que contradizem o livro (por exemplo, se o livro usa intencionalmente primeira pessoa ou humor denso e sarcástico, obedeça às diretrizes do livro). - Fornecer um plano executável: Dê modificações específicas (como encurtar um parágrafo, dividir um resumo, reorganizar uma cena em certas etapas) ou um trecho de demonstração direcionada.
- Capítulos congelados são fatos somente leitura (veja SB §3): Para capítulos congelados, forneça apenas análise técnica e relatório de problemas; nunca reescreva, adicione frases ou sobrescreva.
- De acordo com a prioridade de conflito do
fiction-continuity(SB §3), escreva embible/canon.mdapenas as decisões de configuração que o autor confirmou explicitamente neste fluxo e que não têm conflitos. Questões não confirmadas ou com conflitos devem ser encaminhadas parafiction-continuity. - Capítulos não congelados: Se envolver alteração de configurações estabelecidas ou sobrescrita do texto existente do autor, pare e pergunte ao autor primeiro. Reescrevimentos estruturais completos devem ser encaminhados de volta para
fiction-chapter.
Modo B: Construir ou Calibrar bible/style-guide.md
- Determinar o ponto de partida: Pergunte ou confirme se o autor tem pelo menos 2–3 capítulos de exemplo com os quais está satisfeito. Se existirem, siga o caminho de "extração reversa"; se ainda não escreveu, siga o caminho de "definição por perguntas e respostas".
- Ler o modelo e o método: Leia references/style-guide-template.md e assets/style-guide.template.md. Confirme as sete dimensões principais (ritmo de comprimento de frase, pontuação característica, frase isolada em parágrafo, hábitos de diálogo, dosagem de humor, expressões proibidas, trechos de amostra escolhidos pelo autor), bem como a perspectiva narrativa e a lista de proibições.
- Gerar rascunho do guia de estilo:
- Caminho de extração reversa: Leia os capítulos de exemplo indicados pelo autor (apenas leitura, sem modificar). Analise a distribuição de comprimento de frases, pontuação de alta frequência, número de linhas por parágrafo, número de sentenças consecutivas em diálogo, origem das descrições e estilo emocional. Extraia 2–4 trechos de amostra de referência para validação do autor e registre seus caminhos de capítulo de exemplo (
chapters/{vol}/{ch}/v{n}.md). Organize em um rascunho. - Caminho de definição por perguntas e respostas: Faça um conjunto conciso de perguntas sobre as sete dimensões. Transforme as preferências do autor em critérios específicos e verificáveis (por exemplo, "diálogo contínuo não excede 3 frases", "ponto de exclamação limitado conforme o autor"), evitando adjetivos vagos.
- Caminho de extração reversa: Leia os capítulos de exemplo indicados pelo autor (apenas leitura, sem modificar). Analise a distribuição de comprimento de frases, pontuação de alta frequência, número de linhas por parágrafo, número de sentenças consecutivas em diálogo, origem das descrições e estilo emocional. Extraia 2–4 trechos de amostra de referência para validação do autor e registre seus caminhos de capítulo de exemplo (
- Solicitar aprovação do autor: Apresente o rascunho ao autor junto com dois tipos de sugestões a serem sincronizadas:
- Palavras literalmente proibidas e lista de desidentificação → Sugira escrever em
lint.banned_terms/lint.desensitize.*de.fiction/config.json(nível padrãoblock, reporta bloqueio). - Padrões de frase ou regex personalizados → Sugira escrever em
.fiction/lint-patterns.txtcomo cabeçalhos válidos (ex.:[summary:suggest],[custom:block:all];blockreporta bloqueio,suggestreporta sugestão; sintaxe vejalint.mjs --helpdofiction-review(oufiction-chapter,fiction-init); se nenhum estiver instalado, verificar manualmente). Não sobrescreva obible/style-guide.mdexistente antes da confirmação.
- Palavras literalmente proibidas e lista de desidentificação → Sugira escrever em
- Escrever e fazer a transição: Após a confirmação, escreva em
bible/style-guide.md(e verifique se o registro destyle_guideembible/sources.mdé consistente, veja SB §5). Escreva o caminho do capítulo de exemplo de referência confirmado embible/style-guide.mde lembre o autor de registrá-lo noAGENTS.md"Diretrizes deste Livro" para quefiction-reviewpossa consultá-lo ao calibrar a voz. A respiração da frase, o espaço em branco e o alinhamento da voz ainda serão verificados pela leitura de revisão e pelo autor.
Verificações
- As técnicas e sugestões citadas nesta iteração não violam as
AGENTS.md"Diretrizes deste Livro" do projeto nem obible/style-guide.mdexistente[modelo] - As sugestões de escrita ou planos de reescrita fornecidos são operacionais (ex.: cinco elementos, inserir ação a cada três frases, método de quatro passos para o livreto), sem pregações vagas
[modelo] - Ao criar ou atualizar
bible/style-guide.md, as sete dimensões de estilo são escritas como critérios de julgamento executáveis e não contêm trechos de amostra fictícios de terceiros[modelo] - Os trechos de amostra, expressões proibidas e diretrizes de estilo centrais em
bible/style-guide.mdforam confirmados pelo autor[autor] - As formas de escrita (termos literalmente proibidos em
config.jsonlint.banned_termsvs. regex/padrões de frase emlint-patterns.txtcomo cabeçalhos válidos) foram diferenciadas e marcadas comblock(bloqueio) ousuggest(sugestão)[autor] - O caminho do capítulo de exemplo de referência confirmado foi registrado em
bible/style-guide.mde o autor foi lembrado de registrá-lo noAGENTS.md"Diretrizes deste Livro" para calibragem dofiction-review[autor] - Nenhum capítulo congelado foi modificado (apenas análise para capítulos congelados), e nenhum outro ponto de entrada principal (como
canon.md,world-rules.md) foi alterado sem autorização[modelo]
Artefatos
- Modo A: Diagnóstico técnico, método de modificação passo a passo ou reescrita de demonstração para o problema atual (geralmente apresentado diretamente na resposta; o autor decide se adota; para capítulos congelados, apenas análise e lista de tarefas).
- Modo B: Criar ou atualizar
bible/style-guide.mdno diretório raiz do projeto (consulte assets/style-guide.template.md), e produzir itens sugeridos para sincronização em.fiction/config.json/.fiction/lint-patterns.txt, bem como o caminho do capítulo de exemplo de referência parafiction-review. - Formato do relatório: Resuma os documentos de referência/pacotes de gênero consultados nesta iteração, os caminhos de arquivo modificados (se houver), as tarefas pendentes para skills irmãos (se houver) e quaisquer divergências de diretrizes ou trechos de amostra a serem preenchidos que precisam de confirmação do autor.
Documentos de Referência
Trechos do Contrato
| Problema encontrado | Qual documento ler |
|---|---|
| Verificar estrutura de diretórios do projeto, hierarquia e resolução de conflitos, responsabilidades de arquivos, registro de pontos de entrada principais (SB §1–§5) | references/formats/project.md |
Referências de Técnicas
| Problema encontrado | Qual documento ler |
|---|---|
| Cena dispersa, falta de visualização, abertura arrastada, transições bruscas, desequilíbrio de ritmo lento/rápido, final plano, texto corrido | references/scene-craft.md |
| Pouca sensação de recompensa, escalada de conflito emperrada, ritmo Cena-Reação (Scene-Sequel) descontrolado, expectativa quebrada, curva emocional plana, grandes eventos sem ondas, nova área parecendo diário de viagem, múltiplos personagens confusos | references/narrative-techniques.md |
| Diálogo parecendo peça de teatro, personagens genéricos, personagens explicando configurações pelo autor, subtexto raso, narração repetindo explicação após o diálogo, adivinhação psicológica em personagens fortes | references/dialogue.md |
| Informação despejada de uma só vez, mesma informação repetida, livreto/documento no texto parecendo aula, jargão difícil, estrutura de informação em três camadas (explícita/implícita/dupla linha), interface de sistema/identificação ultrapassando limites, desidentificação de realidade | references/information.md |
| Atmosfera exagerada, anomalias descritas sem moderação, falta de senso de escala, descrição ambiental virando pintura de paisagem, linguagem de gêneros híbridos em conflito | references/atmosphere.md |
| Escrever capítulo de preparação/reunião, ação/exploração, divisão de espólios/inventário/troca de equipamento, cena de compra/venda/negociação, cena de livreto de regras | references/chapter-types.md |
Criar ou atualizar bible/style-guide.md, ou extrair estilo de capítulos existentes | references/style-guide-template.md e modelo assets/style-guide.template.md |
Pacotes de Gênero
As diferenças de gênero estão unificadas em references/genres/, carregadas de acordo com book.genres em .fiction/config.json (gêneros híbridos podem carregar vários pacotes simultaneamente):
| Gênero | Documento de Referência |
|---|---|
| Cultivo / Xianxia | references/genres/xianxia.md |
| Urbano | references/genres/urban.md |
| Suspense | references/genres/suspense.md |
| Romance | references/genres/romance.md |
| Ficção Científica | references/genres/scifi.md |
| Histórico | references/genres/history.md |
| Como adicionar um pacote de gênero personalizado | references/genres/README.md |