Pular para o conteúdo
UseIA
0
Skill

Doc Coauthoring

Crédito: anthropics no GitHub (anthropics/skills) · 0 cópias

Indicada na UseIA por Cristiano Rochenbach Abreu em 5 de out. de 2026

179,8 mil estrelas no GitHubVer no GitHub
Salvar

Tradução feita por IA. Em caso de dúvida, vale o texto original (aba “Original”).

---
name: doc-coauthoring
description: Guia os usuários por um fluxo de trabalho estruturado de coautoria de documentação. Use quando o usuário quiser escrever documentação, propostas, especificações técnicas, documentos de decisão ou conteúdo estruturado semelhante. Este fluxo ajuda os usuários a transferir contexto com eficiência, refinar o conteúdo por iteração e verificar se o documento funciona para os leitores. Acione quando o usuário mencionar escrever documentos, criar propostas, redigir especificações ou tarefas de documentação parecidas.
---

# Fluxo de coautoria de documentos

Esta skill oferece 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 o leitor.

## Quando oferecer este fluxo

**Condições de acionamento:**
- O usuário menciona escrever documentação: "escrever um doc", "redigir uma proposta", "criar uma especificação", "escrever um relato"
- O usuário menciona tipos específicos de documento: "PRD", "design doc", "documento de decisão", "RFC"
- O usuário parece estar começando uma tarefa de escrita substancial

**Oferta inicial:**
Ofereça ao usuário um fluxo estruturado para coescrever o documento. Explique as três etapas:

1. **Coleta de contexto**: O usuário fornece todo o contexto relevante enquanto o Claude faz perguntas de esclarecimento
2. **Refinamento e estrutura**: Construa cada seção de forma iterativa, por meio de brainstorming e edição
3. **Teste com o leitor**: Teste o documento com um Claude novo (sem contexto) para encontrar 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 ele quer experimentar este fluxo ou prefere trabalhar de forma livre.

Se o usuário recusar, trabalhe de forma livre. Se aceitar, siga para a Etapa 1.

## Etapa 1: Coleta de contexto

**Objetivo:** Fechar a lacuna entre o que o usuário sabe e o que o Claude sabe, permitindo uma orientação inteligente mais adiante.

### Perguntas iniciais

Comece pedindo ao usuário o metacontexto do documento:

1. Que tipo de documento é este? (por exemplo, especificação técnica, documento de decisão, proposta)
2. Quem é o público principal?
3. Qual é o impacto desejado quando alguém o ler?
4. Existe um modelo ou um formato específico a seguir?
5. Há alguma outra restrição ou contexto que eu deva saber?

Informe que ele pode responder de forma resumida ou despejar as informações da maneira que for melhor para ele.

**Se o usuário fornecer um modelo ou mencionar um tipo de documento:**
- Pergunte se ele tem um documento-modelo para compartilhar
- Se ele fornecer um link para um documento compartilhado, use a integração adequada para buscá-lo
- Se ele fornecer um arquivo, leia-o

**Se o usuário mencionar a edição de um documento compartilhado existente:**
- Use a integração adequada 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, o Claude não conseguirá vê-las. Pergunte se ele quer que o texto alternativo seja gerado. Em caso positivo, peça que cole cada imagem no chat para gerar um texto alternativo descritivo.

### Despejo de informações

Depois de respondidas as perguntas iniciais, incentive o usuário a despejar todo o contexto que tiver. Peça informações como:
- Contexto do projeto/problema
- Discussões da equipe ou documentos compartilhados relacionados
- 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

Oriente-o a não se preocupar em organizar — é só colocar tudo para fora. Ofereça várias formas de fornecer o contexto:
- Despejo de informações em fluxo de consciência
- Apontar canais ou threads da equipe para leitura
- Links para documentos compartilhados

**Se houver integrações disponíveis** (por exemplo, Slack, Teams, Google Drive, SharePoint ou outros servidores MCP), mencione que elas podem ser usadas para trazer o contexto diretamente.

**Se nenhuma integração for detectada e estiver no Claude.ai ou no app do Claude:** Sugira que ele ative conectores nas configurações do Claude para permitir trazer contexto diretamente de aplicativos de mensagens e de armazenamento de documentos.

Informe que as perguntas de esclarecimento serão feitas depois que ele concluir o despejo inicial.

**Durante a coleta de contexto:**

- Se o usuário mencionar canais da equipe ou documentos compartilhados:
  - Se houver integrações disponíveis: Informe que o conteúdo será lido agora e use a integração adequada
  - Se não houver integrações: Explique que não há acesso. Sugira que ele ative conectores nas configurações do Claude ou cole diretamente o conteúdo relevante.

- Se o usuário mencionar entidades/projetos desconhecidos:
  - Pergunte se as ferramentas conectadas devem ser pesquisadas para saber mais
  - Espere a confirmação do usuário antes de pesquisar

- À medida que o usuário fornece contexto, acompanhe o que está sendo aprendido e o que ainda não está claro

**Fazendo perguntas de esclarecimento:**

Quando o usuário sinalizar que concluiu o despejo inicial (ou depois de fornecido um contexto substancial), faça perguntas de esclarecimento para garantir o entendimento:

Gere de 5 a 10 perguntas numeradas com base nas lacunas do contexto.

Informe que ele pode responder de forma resumida (por exemplo, "1: sim, 2: veja o #canal, 3: não, por causa da compatibilidade retroativa"), enviar links para mais documentos, apontar canais para leitura ou simplesmente continuar despejando informações. O que for mais eficiente para ele.

**Condição de saída:**
Contexto suficiente foi reunido quando as perguntas demonstram entendimento — quando é possível perguntar sobre casos de borda e trocas sem precisar explicar o básico.

**Transição:**
Pergunte se há mais algum contexto que ele queira fornecer nesta etapa ou se é hora de passar à redação do documento.

Se o usuário quiser acrescentar mais, deixe. Quando estiver pronto, siga 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 ao usuário:**
Explique que o documento será construído seção por seção. Para cada seção:
1. Serão feitas perguntas de esclarecimento sobre o que incluir
2. Serão geradas de 5 a 20 opções em brainstorming
3. O usuário indicará o que manter/remover/combinar
4. A seção será redigida
5. Ela será refinada por meio de edições cirúrgicas

Comece pela seção que tem mais incógnitas (em geral a decisão/proposta central) e depois passe pelas demais.

**Ordem das seções:**

Se a estrutura do documento estiver clara:
Pergunte por qual seção ele gostaria de começar.

Sugira começar pela seção com mais incógnitas. Em documentos de decisão, geralmente é a proposta central. Em especificações, costuma ser a abordagem técnica. As seções de resumo é melhor deixar para o final.

Se o usuário não souber de quais seções precisa:
Com base no tipo de documento e no modelo, sugira de 3 a 5 seções adequadas ao tipo de documento.

Pergunte se essa estrutura funciona ou se ele quer ajustá-la.

**Depois de acordada a estrutura:**

Crie a estrutura inicial do documento com texto provisório em todas as seções.

**Se houver acesso a artefatos:**
Use `create_file` para criar um artefato. Isso dá ao Claude e ao usuário um esqueleto para trabalhar.

Informe que a estrutura inicial, com texto provisório em todas as seções, será criada.

Crie o artefato com todos os títulos das seções e um texto provisório curto, 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. Dê a ele um nome adequado (por exemplo, `decision-doc.md`, `technical-spec.md`).

Informe que a estrutura inicial, com texto provisório em todas as seções, será criada.

Crie o arquivo com todos os títulos das seções e o texto provisório.

Confirme que o nome do arquivo foi criado e indique que é hora de preencher cada seção.

**Para cada seção:**

### Passo 1: Perguntas de esclarecimento

Anuncie que o trabalho começará pela seção [NOME DA SEÇÃO]. Faça de 5 a 10 perguntas de esclarecimento sobre o que deve ser incluído:

Gere de 5 a 10 perguntas específicas com base no contexto e na finalidade da seção.

Informe que ele pode responder de forma resumida ou apenas indicar o que é importante cobrir.

### Passo 2: Brainstorming

Para a seção [NOME DA SEÇÃO], faça um brainstorming de [5-20] itens que podem ser incluídos, conforme a complexidade da seção. Procure:
- Contexto compartilhado que possa ter sido esquecido
- Ângulos ou considerações ainda não mencionados

Gere de 5 a 20 opções numeradas conforme a complexidade da seção. No final, ofereça-se para fazer mais brainstorming se ele quiser opções adicionais.

### Passo 3: Curadoria

Pergunte quais pontos devem ser mantidos, removidos ou combinados. Peça justificativas breves, para ajudar a aprender as prioridades das próximas seções.

Dê exemplos:
- "Manter 1,4,7,9"
- "Remover 3 (duplica o 1)"
- "Remover 6 (o público já sabe disso)"
- "Combinar 11 e 12"

**Se o usuário der um feedback livre** (por exemplo, "está bom" ou "gostei da maior parte, mas...") em vez de seleções numeradas, extraia as preferências dele e prossiga. Interprete o que ele quer manter/remover/mudar e aplique.

### Passo 4: Verificação de lacunas

Com base no que ele selecionou, pergunte se falta algo importante na seção [NOME DA SEÇÃO].

### Passo 5: Redação

Use `str_replace` para substituir o texto provisório desta seção pelo conteúdo redigido de fato.

Anuncie que a seção [NOME DA SEÇÃO] será redigida agora, com base no que ele selecionou.

**Se estiver usando artefatos:**
Depois de redigir, forneça um link para o artefato.

Peça que ele leia e indique o que mudar. Observe que ser específico ajuda a aprender para as próximas seções.

**Se estiver usando um arquivo (sem artefatos):**
Depois de redigir, confirme a conclusão.

Informe que a seção [NOME DA SEÇÃO] foi redigida em [nome do arquivo]. Peça que ele leia e indique o que mudar. Observe que ser específico ajuda a aprender para as próximas seções.

**Instrução-chave ao usuário (inclua ao redigir a primeira seção):**
Faça uma observação: em vez de editar o documento diretamente, peça que ele indique o que mudar. Isso ajuda a aprender o estilo dele para as próximas seções. Por exemplo: "Remova o marcador X - já coberto pelo Y" ou "Deixe o terceiro parágrafo mais conciso".

### Passo 6: Refinamento iterativo

À medida que o usuário der feedback:
- Use `st

[…] Conteúdo completo no GitHub.

Funciona com:Claude

Para:Escrever texto