Co-rédaction de documents

Source: Contenu adapté de anthropics/skills (MIT).

Cette compétence fournit un flux de travail structuré pour guider les utilisateurs dans la création collaborative de documents. Agir en tant que guide actif, guidant les utilisateurs à travers trois étapes: collecte du contexte, raffinement et structure, et test des lecteurs.

Quand proposer ce flux de travail

Conditions de déclenchement:

• L'utilisateur mentionne la rédaction de la documentation: "écrire un document", "rédiger une proposition", "créer une spécification", "rédiger"
• L'utilisateur mentionne des types de documents spécifiques: "PRD", "design doc", "decision doc", "RFC"
• L'utilisateur semble commencer une tâche d'écriture importante

Offre initiale: Offrez à l’utilisateur un flux de travail structuré pour la co-création du document. Expliquez les trois étapes:

1. Gathering de contexte: l'utilisateur fournit tout le contexte pertinent pendant que Claude pose des questions de clarification
2. Raffinement et structure: créez de manière itérative chaque section grâce au brainstorming et à l'édition
3. Test des lecteurs: testez le document avec un nouveau Claude (sans contexte) pour détecter les angles morts avant que les autres ne le lisent

Expliquez que cette approche permet de garantir que le document fonctionne correctement lorsque d'autres le lisent (y compris lorsqu'ils le collent dans Claude). Demandez-leur s'ils veulent essayer ce flux de travail ou préfèrent travailler de manière libre.

Si l'utilisateur refuse, travaillez de manière libre. Si l'utilisateur accepte, passez à l'étape 1.

Étape 1: Rassemblement du contexte

Objectif: Combler l'écart entre ce que l'utilisateur sait et ce que Claude sait, permettant ainsi un guidage intelligent plus tard.

Questions initiales

Commencez par demander à l'utilisateur le méta-contexte sur le document:

1. De quel type de document s'agit-il? (par exemple, spécification technique, document de décision, proposition)
2. Quel est le public principal?
3. Quel est l’impact souhaité lorsque quelqu’un lit ceci?
4. Existe-t-il un modèle ou un format spécifique à suivre?
5. D'autres contraintes ou contexte à connaître?

Informez-les qu'ils peuvent répondre en sténographie ou vider les informations de la manière qui leur convient le mieux.

Si l'utilisateur fournit un modèle ou mentionne un type de document:

• Demandez-leur s'ils ont un modèle de document à partager
• S'ils fournissent un lien vers un document partagé, utilisez l'intégration appropriée pour le récupérer
• S'ils fournissent un fichier, lisez-le

Si l'utilisateur mentionne la modification d'un document partagé existant:

• Utilisez l'intégration appropriée pour lire l'état actuel
• Rechercher des images sans texte alternatif
• Si les images existent sans texte alternatif, expliquez que lorsque d'autres utilisent Claude pour comprendre le document, Claude ne pourra pas les voir. Demandez-leur s'ils souhaitent que du texte alternatif soit généré. Si tel est le cas, demandez-leur de coller chaque image dans le chat pour générer un texte alternatif descriptif.

Dumping d'informations

Une fois les questions initiales répondues, encouragez l'utilisateur à vider tout le contexte dont il dispose. Demander des informations telles que:

• Contexte du projet/problème
• Discussions d’équipe associées ou documents partagés
• Pourquoi les solutions alternatives ne sont pas utilisées
• Contexte organisationnel (dynamique d'équipe, incidents passés, politique)
• Pressions ou contraintes liées au calendrier
• Architecture technique ou dépendances
• Préoccupations des parties prenantes

Conseillez-leur de ne pas s'inquiéter de l'organisation, mais de tout sortir. Proposez plusieurs façons de fournir du contexte:

• Flux d'information de décharge de conscience
• Pointez vers les canaux ou les fils de discussion de l'équipe à lire
• Lien vers les documents partagés

Si des intégrations sont disponibles (par exemple, Slack, Teams, Google Drive, SharePoint ou autres serveurs MCP), mentionnez qu'elles peuvent être utilisées pour extraire directement le contexte.

Si aucune intégration n'est détectée et dans Claude.ai ou l'application Claude: Suggérez-leur d'activer les connecteurs dans leurs paramètres Claude pour permettre d'extraire directement le contexte des applications de messagerie et du stockage de documents.

Informez-les que des questions de clarification leur seront posées une fois qu'ils auront effectué leur premier vidage.

Pendant la collecte de contexte:

• Si l'utilisateur mentionne des canaux d'équipe ou des documents partagés:

  • Si des intégrations sont disponibles: informez-les que le contenu sera lu maintenant, puis utilisez l'intégration appropriée
  • Si les intégrations ne sont pas disponibles: expliquez le manque d'accès. Suggérez-leur d'activer les connecteurs dans les paramètres de Claude ou de coller directement le contenu pertinent.

• Si l'utilisateur mentionne des entités/projets inconnus:

  • Demandez si les outils connectés doivent être recherchés pour en savoir plus
  • Attendez la confirmation de l'utilisateur avant de rechercher

• À mesure que l'utilisateur fournit le contexte, suivez ce qui est appris et ce qui n'est pas encore clair.

Poser des questions de clarification:

Lorsque l'utilisateur signale qu'il a effectué son vidage initial (ou après avoir fourni un contexte substantiel), posez des questions de clarification pour garantir sa compréhension:

Générez 5 à 10 questions numérotées en fonction des lacunes du contexte.

Informez-les qu'ils peuvent utiliser un raccourci pour répondre (par exemple, "1: oui, 2: voir #channel, 3: non car compatibilité ascendante"), créer un lien vers plus de documents, pointer vers des chaînes à lire ou simplement continuer à diffuser des informations. Tout ce qui est le plus efficace pour eux.

Condition de sortie: Un contexte suffisant a été recueilli lorsque les questions montrent une compréhension - lorsque les cas extrêmes et les compromis peuvent être abordés sans avoir besoin d'expliquer les bases.

Transition: Demandez-leur s'ils souhaitent fournir davantage de contexte à ce stade, ou s'il est temps de passer à la rédaction du document.

Si l'utilisateur souhaite en ajouter davantage, laissez-le faire. Lorsque vous êtes prêt, passez à l'étape 2.

Étape 2: raffinement et structure

Objectif: Créez le document section par section grâce à un brainstorming, une curation et un affinement itératif.

Instructions à l'utilisateur: Expliquez que le document sera construit section par section. Pour chaque rubrique:

1. Des questions de clarification seront posées sur ce qu'il faut inclure
2. 5 à 20 options feront l'objet d'un brainstorming
3. L'utilisateur indiquera ce qu'il doit conserver/supprimer/combiner
4. La section sera rédigée
5. Il sera affiné grâce à des modifications chirurgicales

Commencez par la section comportant le plus d’inconnues (généralement la décision/proposition principale), puis parcourez le reste.

Ordre des sections:

Si la structure du document est claire: Demandez-leur par quelle section ils aimeraient commencer.

Suggérez de commencer par la section comportant le plus d’inconnues. Pour les documents de décision, il s'agit généralement de la proposition principale. Pour les spécifications, c'est généralement l'approche technique. Il est préférable de laisser les sections de résumé pour la fin.

Si l'utilisateur ne sait pas de quelles sections il a besoin: En fonction du type de document et du modèle, suggérez 3 à 5 sections appropriées au type de document.

Demandez-leur si cette structure fonctionne ou s’ils souhaitent l’ajuster.

Une fois la structure convenue:

Créez la structure initiale du document avec du texte d'espace réservé pour toutes les sections.

Si l'accès aux artefacts est disponible: Utilisezcreate_filepour créer un artefact. Cela donne à Claude et à l'utilisateur un échafaudage sur lequel travailler.

Informez-les que la structure initiale avec des espaces réservés pour toutes les sections sera créée.

Créez un artefact avec tous les en-têtes de section et un bref texte d'espace réservé comme "[À écrire]" ou "[Contenu ici]".

Fournissez le lien de l'échafaudage et indiquez qu'il est temps de remplir chaque section.

Si aucun accès aux artefacts: Créez un fichier de démarque dans le répertoire de travail. Nommez-le de manière appropriée (par exemple,decision-doc.md,technical-spec.md).

Informez-les que la structure initiale avec des espaces réservés pour toutes les sections sera créée.

Créez un fichier avec tous les en-têtes de section et le texte d'espace réservé.

Confirmez que le nom du fichier a été créé et indiquez qu'il est temps de remplir chaque section.

Pour chaque rubrique:

Étape 1: questions de clarification

Annoncez le début des travaux sur la section [NOM DE LA SECTION]. Posez 5 à 10 questions de clarification sur ce qui doit être inclus:

Générez 5 à 10 questions spécifiques en fonction du contexte et de l'objectif de la section.

Informez-les qu'ils peuvent répondre en sténographie ou simplement indiquer ce qui est important à aborder.

Étape 2: brainstorming

Pour la section [NOM DE LA SECTION], réfléchissez à [5-20] éléments qui pourraient être inclus, en fonction de la complexité de la section. Recherchez:

• Contexte partagé qui aurait pu être oublié
• Angles ou considérations non encore évoqués

Générez 5 à 20 options numérotées en fonction de la complexité de la section. À la fin, proposez-leur de réfléchir davantage s’ils souhaitent des options supplémentaires.

Étape 3: conservation

Demandez quels points doivent être conservés, supprimés ou combinés. Demandez de brèves justifications pour vous aider à connaître les priorités pour les sections suivantes.

Donnez des exemples:

• "Gardez 1,4,7,9"
• "Supprimer 3 (doublons 1)"
• "Supprimer 6 (le public le sait déjà)"
• "Combinez 11 et 12"

Si l'utilisateur donne des commentaires libres (par exemple, « ça a l'air bien » ou « j'aime la plupart mais... ») au lieu de sélections numérotées, extrayez ses préférences et continuez. Analysez ce qu'ils veulent conserver/supprimé/modifié et appliquez-le.

Étape 4: Vérification des écarts

En fonction de ce qu'ils ont sélectionné, demandez s'il manque quelque chose d'important pour la section [NOM DE LA SECTION].

Étape 5: Rédaction

Utilisezstr_replacepour remplacer le texte d'espace réservé pour cette section par le contenu rédigé réellement.

Annoncez que la section [NOM DE LA SECTION] sera rédigée maintenant en fonction de ce qu'ils ont sélectionné.

Si vous utilisez des artefacts: Après la rédaction, fournissez un lien vers l’artefact.

Demandez-leur de le lire et d’indiquer ce qu’il faut changer. Notez qu'être précis aide à apprendre pour les sections suivantes.

Si vous utilisez un fichier (aucun artefact): Après la rédaction, confirmez l’achèvement.

Informez-les que la section [NOM DE LA SECTION] a été rédigée dans [nom du fichier]. Demandez-leur de le lire et d’indiquer ce qu’il faut changer. Notez qu'être précis aide à apprendre pour les sections suivantes.

Instruction clé pour l'utilisateur (à inclure lors de la rédaction de la première section): Fournissez une note: au lieu de modifier le document directement, demandez-leur d'indiquer ce qu'il faut modifier. Cela aide à apprendre leur style pour les sections futures. Par exemple: "Supprimez la puce X - déjà couverte par Y" ou "Rendre le troisième paragraphe plus concis".

Étape 6: raffinement itératif

Lorsque l'utilisateur fournit des commentaires:

• Utilisezstr_replacepour apporter des modifications (ne réimprimez jamais l'intégralité du document)
• Si vous utilisez des artefacts: Fournissez un lien vers l'artefact après chaque modification
• Si vous utilisez des fichiers: Confirmez simplement que les modifications sont terminées
• Si l'utilisateur modifie le document directement et demande à le lire: notez mentalement les modifications qu'il a apportées et gardez-les à l'esprit pour les sections futures (cela montre ses préférences)

Continuez à itérer jusqu'à ce que l'utilisateur soit satisfait de la section.

Contrôle de qualité

Après 3 itérations consécutives sans changement substantiel, demandez si quelque chose peut être supprimé sans perdre d'informations importantes.

Une fois la section terminée, confirmez que [NOM DE LA SECTION] est terminé. Demandez si vous êtes prêt à passer à la section suivante.

Répétez pour toutes les sections.

Presque terminé

À l'approche de la fin (plus de 80 % des sections terminées), annoncez votre intention de relire l'intégralité du document et vérifiez:

• Flux et cohérence entre les sections
• Redondance ou contradictions
• Tout ce qui ressemble à du « slop » ou à un remplissage générique
• Si chaque phrase a du poids

Lisez l’intégralité du document et fournissez vos commentaires.

Lorsque toutes les sections seront rédigées et peaufinées: Annoncez que toutes les sections sont rédigées. Indiquez votre intention de réviser le document complet une fois de plus.

Examen pour la cohérence globale, la fluidité et l’exhaustivité.

Fournissez toute suggestion finale.

Demandez-leur s'ils sont prêts à passer à Reader Testing ou s'ils souhaitent affiner autre chose.

Étape 3: test des lecteurs

Objectif: Testez le document avec un nouveau Claude (sans fond perdu) pour vérifier qu'il fonctionne pour les lecteurs.

Instructions à l'utilisateur: Expliquez que des tests vont maintenant avoir lieu pour voir si le document fonctionne réellement pour les lecteurs. Cela permet de détecter des angles morts – des choses qui ont du sens pour les auteurs mais qui pourraient dérouter les autres.

Approche de test

Si l'accès aux sous-agents est disponible (par exemple, dans Claude Code):

Effectuez les tests directement sans l’implication de l’utilisateur.

Étape 1: Prédire les questions des lecteurs

Annoncez votre intention de prédire les questions que les lecteurs pourraient poser en essayant de découvrir ce document.

Générez 5 à 10 questions que les lecteurs poseraient de manière réaliste.

Étape 2: Test avec un sous-agent

Annoncez que ces questions seront testées avec une nouvelle instance de Claude (aucun contexte de cette conversation).

Pour chaque question, invoquez un sous-agent avec uniquement le contenu du document et la question.

Résumez ce que le lecteur Claude a trouvé de bon ou de mauvais pour chaque question.

Étape 3: Effectuer des vérifications supplémentaires

Annoncer que des contrôles supplémentaires seront effectués.

Invoquez le sous-agent pour vérifier les ambiguïtés, les fausses hypothèses et les contradictions.

Résumez tous les problèmes trouvés.

Étape 4: Signaler et corriger

Si des problèmes sont détectés: Signalez que le lecteur Claude a eu du mal à résoudre des problèmes spécifiques.

Énumérez les problèmes spécifiques.

Indiquez votre intention de combler ces lacunes.

Revenez au raffinement pour les sections problématiques.

---

Si aucun accès aux sous-agents (ex. interface web claude.ai):

L'utilisateur devra effectuer les tests manuellement.

Étape 1: Prédire les questions des lecteurs

Demandez quelles questions les gens pourraient se poser en essayant de découvrir ce document. Que taperaient-ils dans Claude.ai?

Générez 5 à 10 questions que les lecteurs poseraient de manière réaliste.

Étape 2: Test de configuration

Fournir des instructions de test:

1. Ouvrez une nouvelle conversation avec Claude: https://claude.ai
2. Collez ou partagez le contenu du document (si vous utilisez une plateforme de documents partagés avec les connecteurs activés, fournissez le lien)
3. Posez au Lecteur Claude les questions générées

Pour chaque question, demandez au lecteur Claude de fournir:

• La réponse
• Si quelque chose était ambigu ou peu clair
• Les connaissances/contextes supposés par le document sont déjà connus

Vérifiez si le lecteur Claude donne des réponses correctes ou interprète mal quelque chose.

Étape 3: Vérifications supplémentaires

Demandez également au lecteur Claude:

• "Qu'est-ce qui, dans ce document, pourrait être ambigu ou peu clair pour les lecteurs?"
• "Quelles connaissances ou quel contexte ce document suppose-t-il que les lecteurs possèdent déjà?"
• "Y a-t-il des contradictions ou des incohérences internes?"

Étape 4: Itérer en fonction des résultats

Demandez avec quoi le lecteur Claude s'est trompé ou avec quoi il a eu du mal. Indiquez votre intention de combler ces lacunes.

Revenez au raffinement pour toutes les sections problématiques.

---

Condition de sortie (les deux approches)

Lorsque Reader Claude répond systématiquement correctement aux questions et ne fait pas apparaître de nouvelles lacunes ou ambiguïtés, le document est prêt.

Examen final

Lorsque le test du lecteur réussit: Annoncez que le document a réussi les tests Reader Claude. Avant la réalisation:

1. Recommandez-leur de faire eux-mêmes une dernière lecture: ils sont propriétaires de ce document et sont responsables de sa qualité.
2. Suggérez de revérifier tous les faits, liens ou détails techniques
3. Demandez-leur de vérifier qu'il obtient l'impact qu'ils souhaitent

Demandez-leur s'ils souhaitent un examen supplémentaire ou si le travail est terminé.

Si l'utilisateur souhaite un avis final, fournissez-le. Sinon: Annoncer l’achèvement du document. Fournissez quelques derniers conseils:

• Pensez à lier cette conversation dans une annexe afin que les lecteurs puissent voir comment le document a été développé.
• Utilisez des annexes pour apporter de la profondeur sans alourdir le document principal
• Mettez à jour le document au fur et à mesure que les commentaires sont reçus de vrais lecteurs

Conseils pour un guidage efficace

Tonalité:

• Soyez direct et procédural
• Expliquez brièvement la justification lorsqu'elle affecte le comportement de l'utilisateur
• N'essayez pas de « vendre » l'approche – exécutez-la simplement

Gestion des écarts:

• Si l'utilisateur souhaite sauter une étape: demandez-lui s'il souhaite ignorer cette étape et écrivez au format libre
• Si l'utilisateur semble frustré: reconnaissez que cela prend plus de temps que prévu. Suggérer des moyens d'avancer plus rapidement
• Donnez toujours à l'agence utilisateur le soin d'ajuster le processus

Gestion du contexte:

• Tout au long, si le contexte manque sur quelque chose mentionné, demandez de manière proactive
• Ne laissez pas les lacunes s'accumuler - corrigez-les au fur et à mesure qu'elles surviennent

Gestion des artefacts:

• Utilisezcreate_filepour rédiger des sections complètes
• Utilisezstr_replacepour toutes les modifications
• Fournir un lien d'artefact après chaque modification
• N'utilisez jamais d'artefacts pour des listes de brainstorming: ce n'est qu'une conversation

La qualité plutôt que la vitesse:

• Ne vous précipitez pas à travers les étapes
• Chaque itération devrait apporter des améliorations significatives
• L'objectif est un document qui fonctionne réellement pour les lecteurs

Voir dans GitHub

Voir dans GitHub