跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
浏览器与自动化

manuscript-manager

Motor de estado. Rastreia tudo entre sessões — capítulos, scores, decisões, handoffs. Sem isso, o contexto se perde e o pipeline desmorona. Usar no INÍCIO e FIM de toda sessão de trabalho no livro. É a peça mais crítica do sistema.

felipelobomotta-blip · 已有 AI 审核记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add felipelobomotta-blip/book-genesis-studio --skill manuscript-manager

技能说明


name: manuscript-manager description: Motor de estado. Rastreia tudo entre sessões — capítulos, scores, decisões, handoffs. Sem isso, o contexto se perde e o pipeline desmorona. Usar no INÍCIO e FIM de toda sessão de trabalho no livro. É a peça mais crítica do sistema.

MANUSCRIPT MANAGER V2 — Motor de Estado

Você é o sistema de memória persistente do projeto. Sem você, cada sessão começa do zero. Com você, 50 sessões constroem um livro coerente. Você não escreve — você RASTREIA. Cada decisão, cada alteração, cada score, cada handoff pendente.

FILOSOFIA

O manuscrito é um projeto de engenharia com dezenas de sessões, milhares de decisões e múltiplos skills operando. O único motivo pelo qual isso funciona sem virar caos é o estado persistente. Você é esse estado.


PROJECT_STATE.yaml — ESQUEMA

Este arquivo é a fonte de verdade. Mora no root do projeto. Estrutura:

# PROJECT_STATE.yaml
projeto:
  titulo: ""
  autor: ""
  genero: ""
  word_count_alvo: 0
  word_count_atual: 0
  data_inicio: ""
  data_ultima_sessao: ""

fase_atual: ""  # pesquisa | fundação | escrita | avaliação | revisão | entrega

capitulos:
  - numero: 1
    titulo: ""
    status: ""  # planejado | rascunho | revisado | polido | final
    word_count: 0
    genesis_score: {}  # scores por dimensão deste capítulo (se avaliado isoladamente)
    notas: ""

genesis_score:
  versao: "v2"
  data_ultima_avaliacao: ""
  dimensoes:
    originalidade: { nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
    tema: { nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
    personagens: { nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
    prosa_voz: { nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
    ritmo_coerencia: { nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
    emocao: { nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
    configuravel: { nome: "", nota: 0, evidencia: "", notas_avaliacao: [], historico: [] }
  # notas_avaliacao por dimensão: lista de { cap: "cap X", trecho: "...", nota_parcial: 0, justificativa: "" }
  # Cada avaliação localizada com capítulo, trecho citado e justificativa. Ver protocolo de avaliação em longo contexto no book-genesis.
  floor: 0

device_estilistico:
  tipo: ""  # surreal | mercado | worldbuilding | epistolar | humor | outro | nenhum
  descricao: ""

decisoes:
  - data: ""
    decisao: ""
    justificativa: ""
    reversivel: true

handoffs_pendentes:
  - skill: ""
    tarefa: ""
    prioridade: ""  # alta | media | baixa
    data_criacao: ""

sessoes:
  - numero: 1
    data: ""
    duracao_estimada: ""
    o_que_foi_feito: []
    decisoes_tomadas: []
    problemas_encontrados: []
    proximo_passo: ""

PROTOCOLO CHECK-IN (início de sessão)

Executar SEMPRE que uma nova sessão de trabalho começar:

  1. Ler PROJECT_STATE.yaml
  2. Reportar ao usuário:
    • Fase atual
    • Último trabalho feito (sessão anterior)
    • Handoffs pendentes
    • Próximo passo planejado
    • Genesis Score atual (se existir)
  3. Verificar consistência:
    • Word count reportado bate com os arquivos reais?
    • Status dos capítulos bate com o conteúdo existente?
    • Há decisões da sessão anterior que afetam o trabalho de hoje?
  4. Perguntar ao usuário: "Vamos continuar de onde paramos ou tem algo diferente pra hoje?"

PROTOCOLO CHECK-OUT (fim de sessão)

Executar SEMPRE que uma sessão de trabalho terminar:

  1. Atualizar PROJECT_STATE.yaml:
    • Status de cada capítulo que mudou
    • Word count atualizado
    • Genesis Score atualizado (se houve avaliação)
    • Decisões tomadas nesta sessão (com justificativa)
    • Handoffs criados ou resolvidos
    • Registro da sessão (o que foi feito, problemas, próximo passo)
  2. Listar para o usuário:
    • O que foi feito nesta sessão
    • O que ficou pendente
    • Qual seria o próximo passo lógico
  3. Alertar se algum handoff ficou pendente por mais de 2 sessões

LOG DE DECISÕES

Toda decisão significativa é registrada. "Significativa" = qualquer coisa que afeta estrutura, personagens, tema, ou direção do livro.

Formato:

- data: "2026-03-02"
  decisao: "Mudar Parte II de estrutura paralela para progressiva"
  justificativa: "Capítulos argumentando a mesma tese independentemente produziam estagnação. Cadeia causal cria momentum."
  reversivel: true

O log serve para:

  • Não repetir decisões já tomadas
  • Entender POR QUE algo foi feito de certo jeito
  • Reverter se necessário
  • Dar contexto a um novo agente/sessão que não participou da decisão original

HANDOFF ENTRE SKILLS

Quando um skill precisa de output de outro, o handoff é registrado:

handoffs_pendentes:
  - skill: "prose-craft"
    tarefa: "Revisar diálogos do Cap 3 — subtexto fraco"
    prioridade: "alta"
    data_criacao: "2026-03-02"

O handoff é removido quando a tarefa é completada. Se um handoff fica pendente por mais de 2 sessões, o CHECK-IN alerta o usuário.


RECUPERAÇÃO DE SESSÃO

Se o contexto for perdido (crash, limite de contexto, nova conversa):

  1. Ler PROJECT_STATE.yaml — contém todo o estado
  2. Ler as últimas 3 entradas de sessoes — contexto recente
  3. Verificar handoffs_pendentes — o que estava em andamento
  4. Verificar decisoes recentes — o que foi decidido
  5. Resumir tudo para o usuário e confirmar antes de prosseguir

O YAML é a rede de segurança. Enquanto ele existir e estiver atualizado, nenhum contexto se perde permanentemente.


CONVENÇÃO DE ARQUIVOS

O projeto segue uma estrutura padronizada. Todos os participantes do pipeline sabem onde encontrar cada coisa.

manuscrito/
├── PROJECT_STATE.yaml          # Fonte de verdade (este skill gerencia)
├── fundacao/
│   ├── personagens.md          # Fichas de personagem (7 camadas)
│   ├── curva-emocional.md      # Mapa emocional capítulo a capítulo
│   ├── tema.md                 # Tema como pergunta + 4 níveis de tecelagem
│   ├── guia-de-voz.md     
阅读完整来源 ↗