Fluxo de Trabalho de Co-autoria de Documentos
Esta skill fornece um fluxo de trabalho estruturado para guiar usuários na criação colaborativa de documentos. Atue como um guia ativo, conduzindo os usuários por três estágios: Coleta de Contexto, Refinamento e Estrutura, e Teste com Leitores.
Quando Oferecer Este Fluxo de Trabalho
Condições de disparo:
- O usuário menciona escrever documentação: "escrever um documento", "redigir uma proposta", "criar uma especificação", "escrever um texto"
- O usuário menciona tipos específicos de documentos: "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 co-autoria do documento. Explique os três estágios:
- Coleta de Contexto: O usuário fornece todo o contexto relevante enquanto Claude faz perguntas esclarecedoras
- Refinamento e Estrutura: Construa iterativamente cada seção por meio de brainstorming e edição
- Teste com Leitores: Teste o documento com um Claude novo (sem contexto) para detectar pontos cegos antes que outros o leiam
Explique que esta abordagem ajuda a garantir que o documento funcione bem quando outros 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 o Estágio 1.
Estágio 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 informações meta-contextuais sobre o documento:
- Que tipo de documento é este? (por exemplo, especificação técnica, documento de decisão, proposta)
- Quem é o público 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 mais conveniente para eles.
Se o usuário fornecer um modelo ou mencionar um tipo de documento:
- Pergunte se eles têm um modelo de documento para compartilhar
- Se eles fornecerem um link para um documento compartilhado, use a integração apropriada para obtê-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 outros usarem 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
Quando as perguntas iniciais forem respondidas, incentive o usuário a despejar todo o contexto que possui. Solicite informações como:
- Antecedentes do projeto/problema
- Discussões relacionadas da equipe ou documentos compartilhados
- Por que soluções alternativas não estão sendo usadas
- Contexto organizacional (dinâmica da equipe, incidentes passados, política)
- Prazos ou restrições de tempo
- Arquitetura técnica ou dependências
- Preocupações das partes interessadas
Aconselhe-os a não se preocupar em organizar - apenas despejar tudo. 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
- Vincular a documentos compartilhados
Se integrações estiverem disponíveis (por exemplo, Slack, Teams, Google Drive, SharePoint ou outros servidores MCP), mencione que elas podem ser usadas para puxar contexto diretamente.
Se nenhuma integração for detectada e estiver no Claude.ai ou aplicativo Claude: Sugira que eles podem ativar os conectores nas configurações do Claude para permitir a extração de contexto de aplicativos de mensagens e armazenamento de documentos diretamente.
Informe que perguntas esclarecedoras serão feitas assim que eles fizerem 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, depois use a integração apropriada
- Se integrações não estiverem disponíveis: Explique a falta de acesso. Sugira que ativem os conectores nas configurações do Claude, ou cole 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
-
À medida que o usuário fornece contexto, rastreie o que está sendo aprendido e o que ainda não está claro
Fazendo perguntas esclarecedoras:
Quando o usuário sinalizar que fez seu despejo inicial (ou após fornecer contexto substancial), faça perguntas esclarecedoras para garantir a compreensão:
Gere de 5 a 10 perguntas numeradas com base nas lacunas no contexto.
Informe que eles podem usar abreviações para responder (por exemplo, "1: sim, 2: veja #canal, 3: não porque compatibilidade reversa"), vincular a 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 compreensão - quando é possível perguntar sobre casos extremos e compensações sem precisar explicar o básico.
Transição: Pergunte se há mais contexto que eles desejam fornecer neste estágio, ou se é hora de passar para a redação do documento.
Se o usuário quiser adicionar mais, deixe. Quando estiver pronto, prossiga para o Estágio 2.
Estágio 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 brainstormadas
- 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 tem mais incógnitas (geralmente a decisão/proposta central), depois trabalhe nas demais.
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 tem 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 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 esta estrutura funciona, ou se eles querem ajustá-la.
Assim que a estrutura for acordada:
Crie a estrutura inicial do documento com texto de espaço reservado para todas as seções.
Se houver acesso a artefatos:
Use create_file para criar um artefato. Isso dá tanto a Claude quanto ao usuário um andaime para trabalhar.
Informe que a estrutura inicial com espaços reservados para todas as seções será criada.
Crie o artefato com todos os cabeçalhos de seção e texto de espaço reservado breve como "[A ser escrito]" ou "[Conteúdo aqui]".
Forneça o link do andaime 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 (por exemplo, documento-de-decisao.md, especificacao-tecnica.md).
Informe que a estrutura inicial com espaços reservados para todas as seções será criada.
Crie o arquivo com todos os cabeçalhos de seção e texto de espaço reservado.
Confirme que o nome do arquivo foi criado e indique que é hora de preencher cada seção.
Para cada seção:
Etapa 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 cobrir.
Etapa 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:
- Contexto compartilhado que pode ter sido esquecido
- Ângulos ou considerações ainda não mencionados
Gere de 5 a 20 opções numeradas com base na complexidade da seção. No final, ofereça-se para fazer mais brainstorming se eles quiserem opções adicionais.
Etapa 3: Curadoria
Pergunte quais pontos devem ser mantidos, removidos ou combinados. Solicite justificativas breves para ajudar a aprender prioridades para as próximas seções.
Forneça exemplos:
- "Manter 1,4,7,9"
- "Remover 3 (duplica 1)"
- "Remover 6 (o público já sabe disso)"
- "Combinar 11 e 12"
Se o usuário der feedback livre (por exemplo, "parece bom" ou "gosto da maior parte, mas...") em vez de seleções numeradas, extraia suas preferências e prossiga. Analise o que eles desejam manter/remover/alterar e aplique.
Etapa 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].
Etapa 5: Redação
Use str_replace para substituir o texto de espaço reservado 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 leiam e indiquem o que alterar. Observe que ser específico ajuda no 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 leiam e indiquem o que alterar. Observe que ser específico ajuda no aprendizado para as próximas seções.
Instrução chave para o usuário (inclua ao redigir a primeira seção): Forneça uma nota: Em vez de editar o documento diretamente, peça que indiquem o que alterar. Isso ajuda no aprendizado do seu estilo para seções futuras. Por exemplo: "Remova o tópico X - já coberto por Y" ou "Torne o terceiro parágrafo mais conciso".
Etapa 6: Refinamento Iterativo
À medida que o usuário fornece 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 completas
- Se o usuário editar o documento diretamente e pedir para lê-lo: mentalmente observe 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 pronta, 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.
Quase Concluindo
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 estão redigidas. Indique a intenção de revisar o documento completo mais uma vez.
Revise a coerência geral, o fluxo, a completude.
Forneça quaisquer sugestões finais.
Pergunte se está pronto para passar para o Teste com Leitores, ou se eles querem refinar mais alguma coisa.
Estágio 3: Teste com Leitores
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á realizado agora para ver se o documento realmente funciona para os leitores. Isso detecta pontos cegos - coisas que fazem sentido para os autores, mas podem confundir outros.
Abordagem de Teste
Se houver acesso a subagentes (por exemplo, no Claude Code):
Realize o teste diretamente, sem envolvimento do usuário.
Etapa 1: Prever Perguntas dos Leitores
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.
Etapa 2: Testar com Subagente
Anuncie que essas perguntas serão testadas com uma instância de Claude nova (sem contexto desta conversa).
Para cada pergunta, invoque um subagente com apenas o conteúdo do documento e a pergunta.
Resuma o que o Claude Leitor acertou/errou para cada pergunta.
Etapa 3: Executar Verificações Adicionais
Anuncie que verificações adicionais serão realizadas.
Invoque o subagente para verificar ambiguidade, suposições falsas, contradições.
Resuma quaisquer problemas encontrados.
Etapa 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 (por exemplo, interface web do claude.ai):
O usuário precisará fazer o teste manualmente.
Etapa 1: Prever Perguntas dos Leitores
Pergunte quais perguntas as pessoas podem fazer ao tentar descobrir este documento. O que eles digitariam no Claude.ai?
Gere de 5 a 10 perguntas que os leitores fariam realisticamente.
Etapa 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 ativados, 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 incorretamente.
Etapa 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?"
Etapa 4: Iterar com Base nos Resultados
Pergunte o que o Claude Leitor errou ou 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 Leitores for aprovado: Anuncie que o documento passou no teste do Claude Leitor. Antes da conclusão:
- Recomende que eles façam uma leitura final eles mesmos - eles são os donos deste documento e são responsáveis por sua qualidade
- Sugira verificar novamente quaisquer fatos, links ou detalhes técnicos
- Peça que verifiquem se atinge o impacto desejado
Pergunte se estão satisfeitos com o resultado ou se há algo mais que gostariam de ajustar.