Coautoría de documentos

Fuente: Contenido adaptado de anthropics/skills (MIT).

Esta habilidad proporciona un flujo de trabajo estructurado para guiar a los usuarios a través de la creación colaborativa de documentos. Actúe como una guía activa, guiando a los usuarios a través de tres etapas: recopilación de contexto, refinamiento y estructura, y prueba de lectura.

Cuándo ofrecer este flujo de trabajo

Condiciones de activación:

• El usuario menciona la redacción de documentación: "escribir un documento", "redactar una propuesta", "crear una especificación", "redactar"
• El usuario menciona tipos de documentos específicos: "PRD", "documento de diseño", "documento de decisión", "RFC"
• El usuario parece estar iniciando una importante tarea de escritura.

Oferta inicial: Ofrezca al usuario un flujo de trabajo estructurado para la coautoría del documento. Explique las tres etapas:

1. Recopilación de contexto: el usuario proporciona todo el contexto relevante mientras Claude hace preguntas aclaratorias
2. Refinamiento y estructura: cree cada sección de forma iterativa mediante una lluvia de ideas y edición
3. Prueba de lectura: prueba el documento con un Claude nuevo (sin contexto) para detectar puntos ciegos antes de que otros lo lean.

Explique que este enfoque ayuda a garantizar que el documento funcione bien cuando otros lo lean (incluso cuando lo peguen en Claude). Pregúnteles si quieren probar este flujo de trabajo o prefieren trabajar de forma libre.

Si el usuario lo rechaza, trabaje de forma libre. Si el usuario acepta, continúe con la Etapa 1.

Etapa 1: recopilación de contexto

Objetivo: Cerrar la brecha entre lo que sabe el usuario y lo que sabe Claude, permitiendo una orientación inteligente más adelante.

Preguntas iniciales

Comience pidiendo al usuario el metacontexto sobre el documento:

1. ¿Qué tipo de documento es este? (por ejemplo, especificaciones técnicas, documento de decisión, propuesta)
2. ¿Quién es la audiencia principal?
3. ¿Cuál es el impacto deseado cuando alguien lee esto?
4. ¿Existe alguna plantilla o formato específico a seguir?
5. ¿Alguna otra limitación o contexto que deba conocer?

Infórmeles que pueden responder de forma taquigráfica o descargar información como mejor les convenga.

Si el usuario proporciona una plantilla o menciona un tipo de documento:

• Pregúntales si tienen un documento modelo para compartir.
• Si proporcionan un enlace a un documento compartido, utilice la integración adecuada para recuperarlo.
• Si te proporcionan un archivo, léelo.

Si el usuario menciona editar un documento compartido existente:

• Utilice la integración adecuada para leer el estado actual.
• Buscar imágenes sin texto alternativo
• Si existen imágenes sin texto alternativo, explique que cuando otros usen Claude para entender el documento, Claude no podrá verlas. Pregúntales si quieren que se genere texto alternativo. Si es así, solicite que peguen cada imagen en el chat para generar texto alternativo descriptivo.

Descarga de información

Una vez que se respondan las preguntas iniciales, anime al usuario a deshacerse de todo el contexto que tiene. Solicite información como:

• Antecedentes del proyecto/problema
• Discusiones de equipo relacionadas o documentos compartidos
• Por qué no se utilizan soluciones alternativas
• Contexto organizacional (dinámica de equipo, incidentes pasados, política)
• Presiones o limitaciones en el cronograma
• Arquitectura técnica o dependencias.
• Preocupaciones de las partes interesadas

Aconséjeles que no se preocupen por organizarlo, simplemente sáquenlo todo. Ofrezca múltiples formas de proporcionar contexto:

• Volcado de información flujo de conciencia
• Señale los canales o hilos del equipo para leer
• Enlace a documentos compartidos

Si hay integraciones disponibles (por ejemplo, Slack, Teams, Google Drive, SharePoint u otros servidores MCP), mencione que se pueden usar para obtener contexto directamente.

Si no se detectan integraciones y en Claude.ai o la aplicación Claude: Sugiera que puedan habilitar conectores en su configuración de Claude para permitir extraer contexto de las aplicaciones de mensajería y el almacenamiento de documentos directamente.

Infórmeles que se les harán preguntas aclaratorias una vez que hayan realizado su volcado inicial.

Durante la recopilación de contexto:

• Si el usuario menciona canales del equipo o documentos compartidos:

  • Si hay integraciones disponibles: infórmeles que el contenido se leerá ahora y luego utilice la integración adecuada.
  • Si las integraciones no están disponibles: explique la falta de acceso. Sugiérales que habiliten los conectores en la configuración de Claude o que peguen el contenido relevante directamente.

• Si el usuario menciona entidades/proyectos desconocidos:

  • Pregunte si se deben buscar herramientas conectadas para obtener más información.
  • Espere la confirmación del usuario antes de buscar

• A medida que el usuario proporciona contexto, realice un seguimiento de lo que se está aprendiendo y de lo que aún no está claro.

Haciendo preguntas aclaratorias:

Cuando el usuario indique que ha realizado su volcado inicial (o después de proporcionar un contexto sustancial), haga preguntas aclaratorias para garantizar la comprensión:

Genere de 5 a 10 preguntas numeradas basadas en lagunas en el contexto.

Infórmeles que pueden usar taquigrafía para responder (por ejemplo, "1: sí, 2: ver #canal, 3: no porque es compatible con versiones anteriores"), vincular a más documentos, señalar canales para leer o simplemente seguir descargando información. Lo que sea más eficiente para ellos.

Condición de salida: Se ha reunido suficiente contexto cuando las preguntas muestran comprensión, cuando se pueden plantear casos extremos y compensaciones sin necesidad de explicar los conceptos básicos.

Transición: Pregunte si quieren brindar más contexto en esta etapa o si es hora de pasar a redactar el documento.

Si el usuario quiere agregar más, déjelo. Cuando esté listo, continúe con la Etapa 2.

Etapa 2: Refinamiento y Estructura

Objetivo: Construir el documento sección por sección mediante lluvia de ideas, curación y refinamiento iterativo.

Instrucciones para el usuario: Explique que el documento se construirá sección por sección. Para cada sección:

1. Se harán preguntas aclaratorias sobre qué incluir.
2. Se intercambiarán entre 5 y 20 opciones
3. El usuario indicará qué conservar/eliminar/combinar
4. La sección será redactada
5. Se perfeccionará mediante ediciones quirúrgicas.

Comience con la sección que tenga más incógnitas (generalmente la decisión/propuesta central) y luego trabaje con el resto.

Orden de secciones:

Si la estructura del documento es clara: Pregúnteles con qué sección les gustaría comenzar.

Sugiera comenzar con la sección que tenga más incógnitas. Para los documentos de decisión, esa suele ser la propuesta principal. Para las especificaciones, suele ser el enfoque técnico. Es mejor dejar las secciones de resumen para el final.

Si el usuario no sabe qué secciones necesita: Según el tipo de documento y plantilla, sugiera de 3 a 5 secciones apropiadas para el tipo de documento.

Pregunte si esta estructura funciona o si quieren ajustarla.

Una vez acordada la estructura:

Cree la estructura del documento inicial con texto de marcador de posición para todas las secciones.

Si el acceso a los artefactos está disponible: Utilicecreate_filepara crear un artefacto. Esto les da a Claude y al usuario un andamio desde el cual trabajar.

Infórmeles que se creará la estructura inicial con marcadores de posición para todas las secciones.

Cree un artefacto con todos los encabezados de sección y un breve texto de marcador de posición como "[Por escribir]" o "[Contenido aquí]".

Proporcione el enlace del andamio e indique que es hora de completar cada sección.

Si no hay acceso a los artefactos: Cree un archivo de rebajas en el directorio de trabajo. Nómbrelo apropiadamente (por ejemplo,decision-doc.md,technical-spec.md).

Infórmeles que se creará la estructura inicial con marcadores de posición para todas las secciones.

Cree un archivo con todos los encabezados de sección y el texto del marcador de posición.

Confirme que se haya creado el nombre del archivo e indique que es hora de completar cada sección.

Para cada sección:

Paso 1: Preguntas aclaratorias

El trabajo de anuncio comenzará en la sección [NOMBRE DE LA SECCIÓN]. Haga de 5 a 10 preguntas aclaratorias sobre lo que se debe incluir:

Genere de 5 a 10 preguntas específicas según el contexto y el propósito de la sección.

Infórmeles que pueden responder de forma taquigráfica o simplemente indicar lo que es importante cubrir.

Paso 2: Lluvia de ideas

Para la sección [NOMBRE DE LA SECCIÓN], piense en [5-20] cosas que podrían incluirse, según la complejidad de la sección. Buscar:

• Contexto compartido que podría haber sido olvidado
• Ángulos o consideraciones aún no mencionadas

Genere entre 5 y 20 opciones numeradas según la complejidad de la sección. Al final, ofrézcase a realizar más lluvias de ideas si desean opciones adicionales.

Paso 3: curación

Pregunte qué puntos deben conservarse, eliminarse o combinarse. Solicite breves justificaciones para ayudar a conocer las prioridades para las siguientes secciones.

Proporcione ejemplos:

• "Mantener 1,4,7,9"
• "Eliminar 3 (duplica 1)"
• "Eliminar 6 (el público ya lo sabe)"
• "Combina 11 y 12"

Si el usuario proporciona comentarios de forma libre (p. ej., "se ve bien" o "Me gusta la mayor parte, pero...") en lugar de selecciones numeradas, extraiga sus preferencias y continúe. Analice lo que quieren conservar/eliminar/cambiar y aplicarlo.

Paso 4: Verificación de brechas

Según lo que hayan seleccionado, pregunte si falta algo importante en la sección [NOMBRE DE LA SECCIÓN].

Paso 5: Redacción

Utilicestr_replacepara reemplazar el texto del marcador de posición de esta sección con el contenido borrador real.

Anuncie que la sección [NOMBRE DE LA SECCIÓN] se redactará ahora en función de lo que seleccionaron.

Si usa artefactos: Después de redactar, proporcione un enlace al artefacto.

Pídales que lo lean e indiquen qué cambiar. Tenga en cuenta que ser específico ayuda a aprender para las siguientes secciones.

Si usa un archivo (sin artefactos): Después de redactar, confirme la finalización.

Infórmeles que la sección [NOMBRE DE LA SECCIÓN] se ha redactado en [nombre del archivo]. Pídales que lo lean e indiquen qué cambiar. Tenga en cuenta que ser específico ayuda a aprender para las siguientes secciones.

Instrucciones clave para el usuario (incluya al redactar la primera sección): Proporcione una nota: en lugar de editar el documento directamente, pídales que indiquen qué cambiar. Esto ayuda a aprender su estilo para secciones futuras. Por ejemplo: "Eliminar la viñeta X, ya cubierta por Y" o "Hacer el tercer párrafo más conciso".

Paso 6: refinamiento iterativo

Cuando el usuario proporciona comentarios:

• Utilicestr_replacepara realizar ediciones (nunca reimprima todo el documento)
• Si usa artefactos: Proporcione un enlace al artefacto después de cada edición.
• Si usa archivos: Simplemente confirme que las ediciones estén completas
• Si el usuario edita el documento directamente y solicita leerlo: anote mentalmente los cambios que realizó y téngalos en cuenta para secciones futuras (esto muestra sus preferencias).

Continuar iterando hasta que el usuario esté satisfecho con la sección.

Control de calidad

Después de 3 iteraciones consecutivas sin cambios sustanciales, pregunte si se puede eliminar algo sin perder información importante.

Cuando finalice la sección, confirme que [NOMBRE DE LA SECCIÓN] esté completa. Pregunte si está listo para pasar a la siguiente sección.

Repetir para todas las secciones.

Casi terminado

A medida que se acerca la finalización (más del 80% de las secciones terminadas), anuncie su intención de volver a leer el documento completo y verifique:

• Flujo y coherencia entre secciones.
• Redundancia o contradicciones
• Cualquier cosa que parezca "basura" o relleno genérico.
• Si cada frase tiene peso

Lea el documento completo y proporcione comentarios.

Cuando todas las secciones estén redactadas y refinadas: Anuncie que todas las secciones están redactadas. Indique su intención de revisar el documento completo una vez más.

Revisión de coherencia general, fluidez e integridad.

Proporcione sugerencias finales.

Pregunte si están listos para pasar a Reader Testing o si quieren perfeccionar algo más.

Etapa 3: Prueba de lector

Objetivo: Probar el documento con un Claude nuevo (sin sangrado de contexto) para verificar que funcione para los lectores.

Instrucciones para el usuario: Explique que ahora se realizarán pruebas para ver si el documento realmente funciona para los lectores. Esto detecta puntos ciegos: cosas que tienen sentido para los autores pero que pueden confundir a otros.

Enfoque de prueba

Si el acceso a subagentes está disponible (por ejemplo, en Claude Code):

Realice las pruebas directamente sin la participación del usuario.

Paso 1: predecir las preguntas del lector

Anuncie la intención de predecir qué preguntas podrían hacer los lectores al intentar descubrir este documento.

Genere de 5 a 10 preguntas que los lectores harían de manera realista.

Paso 2: prueba con el subagente

Anuncie que estas preguntas se probarán con una nueva instancia de Claude (sin contexto de esta conversación).

Para cada pregunta, invoque a un subagente con solo el contenido del documento y la pregunta.

Resuma lo que el lector Claude hizo bien o mal en cada pregunta.

Paso 3: ejecute comprobaciones adicionales

Anuncie que se realizarán controles adicionales.

Invoque al subagente para comprobar si hay ambigüedades, suposiciones falsas o contradicciones.

Resuma cualquier problema encontrado.

Paso 4: informar y solucionar

Si se encuentran problemas: Informe que el lector Claude tuvo problemas con problemas específicos.

Enumere los problemas específicos.

Indique la intención de solucionar estas brechas.

Vuelva al refinamiento para las secciones problemáticas.

---

Si no hay acceso a los subagentes (por ejemplo, la interfaz web claude.ai):

El usuario deberá realizar la prueba manualmente.

Paso 1: predecir las preguntas del lector

Pregunte qué preguntas podrían hacer las personas al intentar descubrir este documento. ¿Qué escribirían en Claude.ai?

Genere de 5 a 10 preguntas que los lectores harían de manera realista.

Paso 2: prueba de configuración

Proporcionar instrucciones de prueba:

1. Abra una nueva conversación de Claude: https://claude.ai
2. Pegue o comparta el contenido del documento (si utiliza una plataforma de documentos compartidos con conectores habilitados, proporcione el enlace)
3. Pregúntele al lector Claude las preguntas generadas.

Para cada pregunta, indique al lector Claude que proporcione:

• la respuesta
• Si algo era ambiguo o poco claro
• ¿Qué conocimiento/contexto asume el médico que ya se conoce?

Compruebe si el lector Claude da respuestas correctas o malinterpreta algo.

Paso 3: controles adicionales

Pregúntele también al lector Claude:

• "¿Qué hay en este documento que podría resultar ambiguo o poco claro para los lectores?"
• "¿Qué conocimiento o contexto supone este documento que los lectores ya tienen?"
• "¿Hay contradicciones o inconsistencias internas?"

Paso 4: iterar en función de los resultados

Pregunte al lector Claude en qué se equivocó o en qué tuvo problemas. Indique la intención de solucionar esas brechas.

Vuelva al refinamiento para ver cualquier sección problemática.

---

Condición de salida (ambos enfoques)

Cuando el lector Claude responde correctamente a las preguntas de forma constante y no descubre nuevas lagunas o ambigüedades, el documento está listo.

Revisión final

Cuando pasa la prueba de lectura: Anuncie que el documento pasó la prueba de Reader Claude. Antes de finalizar:

1. Recomiendo que ellos mismos realicen una lectura final: son propietarios de este documento y son responsables de su calidad.
2. Sugerir verificar nuevamente cualquier hecho, enlace o detalle técnico.
3. Pídales que verifiquen que logra el impacto que querían.

Pregúnteles si quieren una revisión más o si el trabajo ya está hecho.

Si el usuario desea una revisión final, proporciónela. De lo contrario: Anunciar la finalización del documento. Proporcione algunos consejos finales:

• Considere vincular esta conversación en un apéndice para que los lectores puedan ver cómo se desarrolló el documento.
• Utilice apéndices para proporcionar profundidad sin abultar el documento principal.
• Actualice el documento a medida que reciba comentarios de lectores reales.

Consejos para una orientación eficaz

Tono:

• Sea directo y procesal
• Explique brevemente la justificación cuando afecta el comportamiento del usuario.
• No intente "vender" el enfoque, simplemente ejecútelo

Manejo de desviaciones:

• Si el usuario quiere saltarse una etapa: pregúntele si quiere saltarse esta y escriba de forma libre.
• Si el usuario parece frustrado: reconozca que esto está tardando más de lo esperado. Sugerir formas de avanzar más rápido
• Siempre déle al usuario agencia para ajustar el proceso.

Gestión del contexto:

• En todo momento, si falta contexto sobre algo mencionado, pregunte de manera proactiva
• No permita que se acumulen brechas: abórdelas a medida que surjan

Gestión de artefactos:

• Utilicecreate_filepara redactar secciones completas.
• Utilicestr_replacepara todas las ediciones.
• Proporcionar enlace de artefacto después de cada cambio.
• Nunca uses artefactos para listas de lluvia de ideas: eso es solo conversación

Calidad sobre velocidad:

• No te apresures por las etapas
• Cada iteración debería aportar mejoras significativas.
• El objetivo es un documento que realmente funcione para los lectores.

Ver en GitHub

Ver en GitHub