Fluxo de Trabalho de Coautoria de Documentos
Este skill fornece um fluxo de trabalho estruturado para guiar os usuários na criação colaborativa de documentos. Atue como um guia ativo, conduzindo os usuários por três etapas: Coleta de Contexto, Refinamento e Estrutura, e Teste com Leitor.
Quando Oferecer Este Fluxo de Trabalho
Condições de ativação:
- O usuário menciona escrever documentação: "escrever um doc", "rascunhar uma proposta", "criar uma especificação", "escrever"
- O usuário menciona tipos de documentos específicos: "PRD", "documento de design", "documento de decisão", "RFC"
- O usuário parece estar começando uma tarefa substancial de escrita
Oferta inicial: Ofereça ao usuário um fluxo de trabalho estruturado para coautoria do documento. Explique as três etapas:
- Coleta de Contexto: O usuário fornece todo o contexto relevante enquanto Claude faz perguntas esclarecedoras
- Refinamento e Estrutura: Construa cada seção iterativamente por meio de brainstorming e edição
- Teste com Leitor: Teste o documento com um Claude novo (sem contexto) para identificar pontos cegos antes que outras pessoas o leiam
Explique que essa abordagem ajuda a garantir que o documento funcione bem quando outras pessoas o lerem (inclusive quando o colarem no Claude). Pergunte se eles querem tentar este fluxo de trabalho ou preferem trabalhar de forma livre.
Se o usuário recusar, trabalhe de forma livre. Se o usuário aceitar, prossiga para a Etapa 1.
Etapa 1: Coleta de Contexto
Objetivo: Reduzir a lacuna entre o que o usuário sabe e o que Claude sabe, permitindo uma orientação inteligente posteriormente.
Perguntas Iniciais
Comece perguntando ao usuário sobre o meta-contexto do documento:
- Que tipo de documento é este? (ex.: especificação técnica, documento de decisão, proposta)
- Quem é o público-alvo principal?
- Qual é o impacto desejado quando alguém ler isto?
- Existe um modelo ou formato específico a seguir?
- Há outras restrições ou contexto a saber?
Informe que eles podem responder de forma abreviada ou despejar informações da maneira que for melhor para eles.
Se o usuário fornecer um modelo ou mencionar um tipo de documento:
- Pergunte se eles têm um documento de modelo para compartilhar
- Se eles fornecerem um link para um documento compartilhado, use a integração apropriada para buscá-lo
- Se eles fornecerem um arquivo, leia-o
Se o usuário mencionar editar um documento compartilhado existente:
- Use a integração apropriada para ler o estado atual
- Verifique se há imagens sem texto alternativo
- Se houver imagens sem texto alternativo, explique que quando outras pessoas usarem o Claude para entender o documento, Claude não conseguirá vê-las. Pergunte se eles desejam que o texto alternativo seja gerado. Se sim, peça que colem cada imagem no chat para geração de texto alternativo descritivo.
Despejo de Informações
Depois que as perguntas iniciais forem respondidas, incentive o usuário a despejar todo o contexto que possui. Solicite informações como:
- Histórico do projeto/problema
- Discussões da equipe relacionadas ou documentos compartilhados
- Por que soluções alternativas não estão sendo usadas
- Contexto organizacional (dinâmica da equipe, incidentes passados, política)
- Pressões ou restrições de prazo
- Arquitetura técnica ou dependências
- Preocupações das partes interessadas
Aconselhe que não se preocupem em organizar - apenas coloquem tudo para fora. Ofereça múltiplas formas de fornecer contexto:
- Despejo de informações em fluxo de consciência
- Apontar para canais ou tópicos da equipe para ler
- Link para documentos compartilhados
Se integrações estiverem disponíveis (ex.: Slack, Teams, Google Drive, SharePoint ou outros servidores MCP), mencione que estas podem ser usadas para puxar contexto diretamente.
Se nenhuma integração for detectada e no Claude.ai ou aplicativo Claude: Sugira que eles podem habilitar conectores nas configurações do Claude para permitir puxar contexto de aplicativos de mensagens e armazenamento de documentos diretamente.
Informe que perguntas esclarecedoras serão feitas depois que eles concluírem o despejo inicial.
Durante a coleta de contexto:
-
Se o usuário mencionar canais da equipe ou documentos compartilhados:
- Se integrações estiverem disponíveis: Informe que o conteúdo será lido agora e, em seguida, use a integração apropriada
- Se integrações não estiverem disponíveis: Explique a falta de acesso. Sugira que habilitem conectores nas configurações do Claude ou colem o conteúdo relevante diretamente.
-
Se o usuário mencionar entidades/projetos desconhecidos:
- Pergunte se as ferramentas conectadas devem ser pesquisadas para saber mais
- Aguarde a confirmação do usuário antes de pesquisar
-
Conforme o usuário fornece contexto, acompanhe o que está sendo aprendido e o que ainda não está claro
Fazendo perguntas esclarecedoras:
Quando o usuário sinalizar que concluiu o despejo inicial (ou após fornecer contexto substancial), faça perguntas esclarecedoras para garantir o entendimento:
Gere de 5 a 10 perguntas numeradas com base nas lacunas do contexto.
Informe que eles podem usar abreviações para responder (ex.: "1: sim, 2: veja #canal, 3: não porque compatibilidade reversa"), link para mais documentos, apontar para canais para ler ou apenas continuar despejando informações. O que for mais eficiente para eles.
Condição de saída: Contexto suficiente foi coletado quando as perguntas mostram entendimento - quando é possível perguntar sobre casos extremos e compensações sem precisar explicar o básico.
Transição: Pergunte se há mais algum contexto que eles queiram fornecer nesta etapa ou se é hora de passar para o rascunho do documento.
Se o usuário quiser adicionar mais, deixe. Quando estiver pronto, prossiga para a Etapa 2.
Etapa 2: Refinamento e Estrutura
Objetivo: Construir o documento seção por seção por meio de brainstorming, curadoria e refinamento iterativo.
Instruções para o usuário: Explique que o documento será construído seção por seção. Para cada seção:
- Perguntas esclarecedoras serão feitas sobre o que incluir
- De 5 a 20 opções serão geradas por brainstorming
- O usuário indicará o que manter/remover/combinar
- A seção será redigida
- Será refinada por meio de edições cirúrgicas
Comece com a seção que tiver mais incógnitas (geralmente a decisão/proposta central) e depois trabalhe no restante.
Ordenação das seções:
Se a estrutura do documento estiver clara: Pergunte com qual seção eles gostariam de começar.
Sugira começar com a seção que tiver mais incógnitas. Para documentos de decisão, geralmente é a proposta central. Para especificações, geralmente é a abordagem técnica. As seções de resumo são melhor deixadas por último.
Se o usuário não souber de quais seções precisa: Com base no tipo de documento e modelo, sugira de 3 a 5 seções apropriadas para o tipo de documento.
Pergunte se essa estrutura funciona ou se eles querem ajustá-la.
Assim que a estrutura for acordada:
Crie a estrutura inicial do documento com texto placeholder para todas as seções.
Se o acesso a artefatos estiver disponível:
Use create_file para criar um artefato. Isso dá a Claude e ao usuário um esqueleto para trabalhar.
Informe que a estrutura inicial com placeholders para todas as seções será criada.
Crie o artefato com todos os cabeçalhos de seção e texto placeholder breve como "[A ser escrito]" ou "[Conteúdo aqui]".
Forneça o link do esqueleto e indique que é hora de preencher cada seção.
Se não houver acesso a artefatos:
Crie um arquivo markdown no diretório de trabalho. Nomeie-o apropriadamente (ex.: documento-de-decisao.md, especificacao-tecnica.md).
Informe que a estrutura inicial com placeholders para todas as seções será criada.
Crie o arquivo com todos os cabeçalhos de seção e texto placeholder.
Confirme que o nome do arquivo foi criado e indique que é hora de preencher cada seção.
Para cada seção:
Passo 1: Perguntas Esclarecedoras
Anuncie que o trabalho começará na seção [NOME DA SEÇÃO]. Faça de 5 a 10 perguntas esclarecedoras sobre o que deve ser incluído:
Gere de 5 a 10 perguntas específicas com base no contexto e no propósito da seção.
Informe que eles podem responder de forma abreviada ou apenas indicar o que é importante abordar.
Passo 2: Brainstorming
Para a seção [NOME DA SEÇÃO], faça brainstorming de [5 a 20] coisas que podem ser incluídas, dependendo da complexidade da seção. Procure por:
- Contexto compartilhado que pode ter sido esquecido
- Ângulos ou considerações ainda não mencionadas
Gere de 5 a 20 opções numeradas com base na complexidade da seção. No final, ofereça fazer mais brainstorming se eles quiserem opções adicionais.
Passo 3: Curadoria
Pergunte quais pontos devem ser mantidos, removidos ou combinados. Solicite justificativas breves para ajudar a aprender as prioridades para as próximas seções.
Forneça exemplos:
- "Manter 1,4,7,9"
- "Remover 3 (duplica 1)"
- "Remover 6 (público já sabe disso)"
- "Combinar 11 e 12"
Se o usuário der feedback livre (ex.: "parece bom" ou "gosto da maior parte, mas...") em vez de seleções numeradas, extraia suas preferências e prossiga. Analise o que eles querem manter/remover/alterar e aplique.
Passo 4: Verificação de Lacunas
Com base no que eles selecionaram, pergunte se há algo importante faltando para a seção [NOME DA SEÇÃO].
Passo 5: Redação
Use str_replace para substituir o texto placeholder desta seção pelo conteúdo redigido real.
Anuncie que a seção [NOME DA SEÇÃO] será redigida agora com base no que eles selecionaram.
Se estiver usando artefatos: Após a redação, forneça um link para o artefato.
Peça que eles leiam e indiquem o que alterar. Observe que ser específico ajuda o aprendizado para as próximas seções.
Se estiver usando um arquivo (sem artefatos): Após a redação, confirme a conclusão.
Informe que a seção [NOME DA SEÇÃO] foi redigida em [nome do arquivo]. Peça que eles leiam e indiquem o que alterar. Observe que ser específico ajuda o aprendizado para as próximas seções.
Instrução chave para o usuário (incluir ao redigir a primeira seção): Forneça uma nota: Em vez de editar o documento diretamente, peça que eles indiquem o que alterar. Isso ajuda a aprender seu estilo para seções futuras. Por exemplo: "Remova o bullet X - já coberto por Y" ou "Torne o terceiro parágrafo mais conciso".
Passo 6: Refinamento Iterativo
Conforme o usuário fornecer feedback:
- Use
str_replacepara fazer edições (nunca reimprima o documento inteiro) - Se estiver usando artefatos: Forneça link para o artefato após cada edição
- Se estiver usando arquivos: Apenas confirme que as edições estão concluídas
- Se o usuário editar o documento diretamente e pedir para ler: anote mentalmente as alterações que eles fizeram e mantenha-as em mente para seções futuras (isso mostra suas preferências)
Continue iterando até que o usuário esteja satisfeito com a seção.
Verificação de Qualidade
Após 3 iterações consecutivas sem alterações substanciais, pergunte se algo pode ser removido sem perder informações importantes.
Quando a seção estiver concluída, confirme que [NOME DA SEÇÃO] está completa. Pergunte se está pronto para passar para a próxima seção.
Repita para todas as seções.
Próximo da Conclusão
Ao se aproximar da conclusão (80%+ das seções concluídas), anuncie a intenção de reler o documento inteiro e verificar:
- Fluxo e consistência entre as seções
- Redundância ou contradições
- Qualquer coisa que pareça "encheção de linguiça" ou preenchimento genérico
- Se cada frase tem peso
Leia o documento inteiro e forneça feedback.
Quando todas as seções estiverem redigidas e refinadas: Anuncie que todas as seções foram redigidas. Indique a intenção de revisar o documento completo mais uma vez.
Revise a coerência geral, o fluxo e a integridade.
Forneça quaisquer sugestões finais.
Pergunte se está pronto para passar para o Teste com Leitor ou se eles querem refinar mais alguma coisa.
Etapa 3: Teste com Leitor
Objetivo: Testar o documento com um Claude novo (sem vazamento de contexto) para verificar se funciona para os leitores.
Instruções para o usuário: Explique que o teste será feito agora para ver se o documento realmente funciona para os leitores. Isso captura pontos cegos - coisas que fazem sentido para os autores, mas podem confundir outras pessoas.
Abordagem de Teste
Se o acesso a subagentes estiver disponível (ex.: no Claude Code):
Realize o teste diretamente, sem envolvimento do usuário.
Passo 1: Prever Perguntas do Leitor
Anuncie a intenção de prever quais perguntas os leitores podem fazer ao tentar descobrir este documento.
Gere de 5 a 10 perguntas que os leitores fariam realisticamente.
Passo 2: Testar com Subagente
Anuncie que essas perguntas serão testadas com uma nova instância do Claude (sem contexto desta conversa).
Para cada pergunta, invoque um subagente apenas com o conteúdo do documento e a pergunta.
Resuma o que o Claude Leitor acertou/errou para cada pergunta.
Passo 3: Executar Verificações Adicionais
Anuncie que verificações adicionais serão executadas.
Invoque um subagente para verificar ambiguidades, suposições falsas e contradições.
Resuma quaisquer problemas encontrados.
Passo 4: Relatar e Corrigir
Se problemas forem encontrados: Relate que o Claude Leitor teve dificuldades com problemas específicos.
Liste os problemas específicos.
Indique a intenção de corrigir essas lacunas.
Volte para o refinamento das seções problemáticas.
Se não houver acesso a subagentes (ex.: interface web claude.ai):
O usuário precisará fazer o teste manualmente.
Passo 1: Prever Perguntas do Leitor
Pergunte quais perguntas as pessoas podem fazer ao tentar descobrir este documento. O que elas digitarão no Claude.ai?
Gere de 5 a 10 perguntas que os leitores fariam realisticamente.
Passo 2: Configurar Teste
Forneça instruções de teste:
- Abra uma nova conversa no Claude: https://claude.ai
- Cole ou compartilhe o conteúdo do documento (se estiver usando uma plataforma de documentos compartilhados com conectores habilitados, forneça o link)
- Pergunte ao Claude Leitor as perguntas geradas
Para cada pergunta, instrua o Claude Leitor a fornecer:
- A resposta
- Se algo estava ambíguo ou pouco claro
- Que conhecimento/contexto o documento assume que já é conhecido
Verifique se o Claude Leitor dá respostas corretas ou interpreta algo errado.
Passo 3: Verificações Adicionais
Também pergunte ao Claude Leitor:
- "O que neste documento pode ser ambíguo ou pouco claro para os leitores?"
- "Que conhecimento ou contexto este documento assume que os leitores já possuem?"
- "Há alguma contradição ou inconsistência interna?"
Passo 4: Iterar com Base nos Resultados
Pergunte o que o Claude Leitor errou ou com o que teve dificuldade. Indique a intenção de corrigir essas lacunas.
Volte para o refinamento de quaisquer seções problemáticas.
Condição de Saída (Ambas as Abordagens)
Quando o Claude Leitor responder consistentemente às perguntas corretamente e não levantar novas lacunas ou ambiguidades, o documento está pronto.
Revisão Final
Quando o Teste com Leitor for aprovado: Anuncie que o documento passou no teste do Claude Leitor. Antes da conclusão:
- Recomende que eles mesmos façam uma leitura final - eles são os donos deste documento e responsáveis por sua qualidade
- Sugira verificar novamente quaisquer fatos, links ou detalhes técnicos
- Peça que verifiquem se ele atinge o impacto desejado
Pergunte se há algum ajuste de última hora ou se o documento está pronto para ser finalizado.