CommunityEscrita e Ediçãogithub.com

fiction-craft (Técnicas de Escrita e Guia de Estilo)

Biblioteca de técnicas de escrita para web novels e ferramenta de construção de guias de estilo: fornece construção de cenas, ritmo cena-reação, suspense, subtexto em diálogos, informação em camadas, estrutura dupla, atmosfera, escrita de gêneros híbridos e roteiros de capítulos (preparação, ação, divisão, negociação, regras). Orienta a criação ou extração reversa do bible/style-guide.md a partir de capítulos de exemplo.

O que é fiction-craft (Técnicas de Escrita e Guia de Estilo)?

Este skill, fiction-craft, é uma biblioteca abrangente de técnicas narrativas e um construtor de guias de estilo, projetado para auxiliar autores de web novels e outros skills de escrita. Ele oferece orientações práticas e executáveis para superar bloqueios de escrita em áreas como construção de cenas, ritmo narrativo, diálogos com subtexto, distribuição de informações em camadas, estrutura de dupla linha, criação de atmosfera, desenvolvimento de vozes para gêneros híbridos e roteiros específicos para tipos de capítulos. O principal produto deste skill é a criação ou calibragem do arquivo `bible/style-guide.md`, que codifica a voz e o estilo únicos de um livro. O skill opera em dois modos: o Modo A, para consultas pontuais e resolução de problemas de escrita, e o Modo B, para construir o guia de estilo do zero ou extraí-lo de capítulos existentes. Ele se integra perfeitamente com outros skills do ecossistema, como fiction-chapter para escrita completa, fiction-review para revisões e fiction-planner para planejamento de arcos, garantindo que cada skill execute sua função específica sem extrapolar suas responsabilidades. A abordagem do fiction-craft é centrada em cinco princípios fundamentais: contenção, contraste, espaço em branco, verossimilhança e ciclo estrutural, visando uma escrita poderosa e eficaz, sem excessos ou clichês.

Funciona com✓Claude Code✓Codex CLI~Cursor✓OpenCode
npx skills add https://github.com/interjc/create-fiction-skills/tree/HEAD/skills/fiction-craft

Installed? Explore more Escrita e Edição skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

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.md de 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-review ou fiction-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 o bible/style-guide.md e listar as tarefas pendentes da estrutura; para atualizar a lista congelada, instruir o autor a atualizar frozen.ranges em .fiction/config.json e executar lint.mjs --freeze em 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):

  1. AGENTS.md: Foco em ## Diretrizes deste Livro (diretrizes do protagonista, disciplina de ponto de vista, proibições e regras específicas do livro).
  2. .fiction/config.json: Foco em book.genres (IDs dos pacotes de gênero habilitados) e lint.* (termos proibidos, regras de desidentificação).
  3. bible/sources.md: Confirme o ponto de entrada principal correspondente a style_guide (padrão: bible/style-guide.md). Se bible/style-guide.md já 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:

  1. 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.
  2. 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.
  3. 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.
  4. 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.
  5. 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

  1. 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.
  2. Ler apenas os documentos de referência relevantes: Consulte 1–2 arquivos references/*.md correspondentes, conforme a tabela de roteamento no final deste documento. Se book.genres em .fiction/config.json tiver um valor, leia também os references/genres/<genre>.md correspondentes. Não leia todos os documentos irrelevantes.
  3. Alinhar com as diretrizes do livro: Compare as regras gerais dos documentos de referência com AGENTS.md "Diretrizes deste Livro" e bible/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).
  4. 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 em bible/canon.md apenas 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 para fiction-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

  1. 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".
  2. 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.
  3. 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.
  4. 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ão block, reporta bloqueio).
    • Padrões de frase ou regex personalizados → Sugira escrever em .fiction/lint-patterns.txt como cabeçalhos válidos (ex.: [summary:suggest], [custom:block:all]; block reporta bloqueio, suggest reporta sugestão; sintaxe veja lint.mjs --help do fiction-review (ou fiction-chapter, fiction-init); se nenhum estiver instalado, verificar manualmente). Não sobrescreva o bible/style-guide.md existente antes da confirmação.
  5. Escrever e fazer a transição: Após a confirmação, escreva em bible/style-guide.md (e verifique se o registro de style_guide em bible/sources.md é consistente, veja SB §5). Escreva o caminho do capítulo de exemplo de referência confirmado em bible/style-guide.md e lembre o autor de registrá-lo no AGENTS.md "Diretrizes deste Livro" para que fiction-review possa 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 o bible/style-guide.md existente [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.md foram confirmados pelo autor [autor]
  • As formas de escrita (termos literalmente proibidos em config.json lint.banned_terms vs. regex/padrões de frase em lint-patterns.txt como cabeçalhos válidos) foram diferenciadas e marcadas com block (bloqueio) ou suggest (sugestão) [autor]
  • O caminho do capítulo de exemplo de referência confirmado foi registrado em bible/style-guide.md e o autor foi lembrado de registrá-lo no AGENTS.md "Diretrizes deste Livro" para calibragem do fiction-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.md no 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 para fiction-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 encontradoQual 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 encontradoQual documento ler
Cena dispersa, falta de visualização, abertura arrastada, transições bruscas, desequilíbrio de ritmo lento/rápido, final plano, texto corridoreferences/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 confusosreferences/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 fortesreferences/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 realidadereferences/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 conflitoreferences/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 regrasreferences/chapter-types.md
Criar ou atualizar bible/style-guide.md, ou extrair estilo de capítulos existentesreferences/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êneroDocumento de Referência
Cultivo / Xianxiareferences/genres/xianxia.md
Urbanoreferences/genres/urban.md
Suspensereferences/genres/suspense.md
Romancereferences/genres/romance.md
Ficção Científicareferences/genres/scifi.md
Históricoreferences/genres/history.md
Como adicionar um pacote de gênero personalizadoreferences/genres/README.md

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

fiction-chapter

网文单章写作六步闭环:查前文和设定、摘资料、定章纲、写正文、机检审改、回写追踪表。作者说“写新章”“接着写”“出下一章”“重写这一章”或要求重排单章结构时就用。重排卷纲或设计连载节拍用 fiction-planner;审校及已有章节获授权的局部回修、润色和去 AI 味用 fiction-review。 Write, continue, rewrite, or restructure one web novel chapter, from continuity checks and outlining through drafting, validation, and story bible updates. Use when asked to write a new chapter, pick up where the draft left off, write the next installment, or rewrite a chapter. Use fiction-planner for volume planning and serial cadence, and fiction-review for editorial review or authorized local fixes, polishing, and removing AI-like prose in an existing chapter.

fiction-planner

网文创意孵化、开篇定位与卷级规划:收敛模糊点子为卖点与金手指边界、起草书名简介标签(publish/blurb.md)、设计黄金三章、编排全书大纲与明暗双线节奏、制定卷纲与章节规划表、排布爽点节拍/欲扬先抑/情绪波形/S-A-B-C钩子/日更与爆更分组及区域循环结构,并结合伏笔扫描排期。当作者构思新书、拟书名写简介、磨开篇、列全书大纲、开新卷、重排卷次或调节奏钩子时触发。只管单章以上规划:建书与冻结交给 fiction-init,单章 outline 与写正文交给 fiction-chapter,文案与正文审校交给 fiction-review,平台提交交给 fiction-publish,改短剧交给 fiction-short-drama。 Web-novel ideation, positioning, and volume-level planning: turn vague ideas into marketable hooks, draft publish/blurb.md, design golden first three chapters, whole-book and volume outlines, beat/emotion waves, S-A-B-C hook and daily groupings, region cycles, and foreshadow schedules. Use when brainstorming a book, drafting titles/blurbs, planning volumes, pacing, or scheduling payoffs; hand setup/freezing to fiction-init, chapter outlines/drafting to fiction-chapter, review to fiction-review, submission to fiction-publish, and adaptation to fiction-short-drama.

fiction-short-drama

竖屏短剧改编与原创剧本闭环:立项、分集大纲与章集映射、分批写分集剧本、前 3 秒钩子与付费卡点设计、机检与映射回写。涉及改编短剧、把小说改成竖屏短剧、写短剧剧本 / 分集剧本、分集大纲、章集映射、付费卡点、前 3 秒钩子、断章、原创短剧、续写下一集短剧、检查短剧格式与时长时使用。建项目用 fiction-init;小说策划用 fiction-planner;写小说用 fiction-chapter;改共享档案用 fiction-continuity;润色用 fiction-review;转分镜用 fiction-storyboard;路由用 fiction-workflow。 Vertical short-drama adaptation and original scripting workflow: series setup, episode outlines, chapter-to-episode mapping, batched episode scripts, first-3-second hooks, cliffhangers, paywall breaks, and script checks. Use when adapting a novel into a vertical short drama, writing or continuing short-drama episodes, planning episode outlines or maps, placing paywalls, or checking script format and duration. Use fiction-init for setup, fiction-planner for novel planning, fiction-chapter for novel chapters, fiction-continuity for shared bible edits, fiction-review for polish, fiction-storyboard for storyboards, and fiction-workflow for routing.

fiction-storyboard

竖屏短剧分镜工作流:基于已定稿且过检的分集剧本,先做防剧透简报与视觉资产最小建档,再按“段(一次视频生成)→ 镜(段内剪切)”拆解分镜,逐镜核对台词认领、动作依据、竖屏构图、单瞬起止与跨集连戏,最后跑脚本验收并交接下游提示词。作者说“画分镜”“拆镜头”“做场景脚本”“切镜”“把第几集转成分镜”“剧本改了同步分镜”时就用,即使没提“分镜”二字。写或改分集剧本(含改台词)请用 fiction-short-drama;补全资产锁定词、写图片/视频提示词或做付费生成确认请用 fiction-visual-prompts。 Vertical short-drama storyboard workflow: turn finalized, validated episode scripts into segment-and-shot storyboards with spoiler briefs, minimal visual asset entries, continuity tracking, verbatim dialogue/action claiming, 9:16 vertical framing, single-instant start-to-end shot design, and automated storyboard validation. Use when asked to storyboard an episode, break a script into shots, cut segments, or sync storyboards after script edits. Use fiction-short-drama for writing or editing episode scripts and dialogue, and fiction-visual-prompts for full asset locks, reference-image slots, and image/video prompts.

Habilidades Relacionadas