Lutie - Rédaction Collaborative de Documents

Workflow de Co-écriture de Documents

Ce skill fournit un workflow structuré pour guider les utilisateurs dans la création collaborative de documents. Agissez en tant que guide actif, en accompagnant les utilisateurs à travers trois étapes : Collecte de Contexte, Affinement & Structure, et Test Lecteur.

Quand Proposer Ce Workflow

Conditions de déclenchement :

• L'utilisateur mentionne la rédaction de documentation : "écrire un doc", "rédiger une proposition", "créer une spec", "rédiger"
• L'utilisateur mentionne des types de documents spécifiques : "PRD", "doc de conception", "doc de décision", "RFC"
• L'utilisateur semble entamer une tâche de rédaction substantielle

Proposition initiale : Proposez à l'utilisateur un workflow structuré pour co-écrire le document. Expliquez les trois étapes :

1. Collecte de Contexte : L'utilisateur fournit tout le contexte pertinent pendant que Claude pose des questions de clarification
2. Affinement & Structure : Construire chaque section de manière itérative grâce au brainstorming et à l'édition
3. Test Lecteur : Tester le document avec un Claude vierge (sans contexte) pour détecter les angles morts avant que d'autres ne le lisent

Expliquez que cette approche permet de s'assurer que le document fonctionne bien lorsque d'autres le lisent (y compris lorsqu'ils le collent dans Claude). Demandez s'ils veulent essayer ce workflow ou préfèrent travailler librement.

Si l'utilisateur décline, travaillez librement. S'il accepte, passez à l'étape 1.

Étape 1 : Collecte de Contexte

Objectif : Réduire l'écart entre ce que l'utilisateur sait et ce que Claude sait, permettant un guidage intelligent par la suite.

Questions Initiales

Commencez par demander à l'utilisateur un 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. Qui est le public principal ?
3. Quel est l'impact souhaité lorsque quelqu'un lira ce document ?
4. Y a-t-il un modèle ou un format spécifique à suivre ?
5. Y a-t-il d'autres contraintes ou contexte à connaître ?

Informez-les qu'ils peuvent répondre en abrégé ou déverser 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 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 l'édition d'un document partagé existant :

• Utilisez l'intégration appropriée pour lire l'état actuel
• Vérifiez la présence d'images sans texte alternatif
• Si des images existent sans texte alternatif, expliquez que lorsque d'autres utiliseront Claude pour comprendre le document, Claude ne pourra pas les voir. Demandez s'ils souhaitent générer un texte alternatif. Si oui, demandez-leur de coller chaque image dans le chat pour une génération descriptive du texte alternatif.

Déversement d'Informations

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

• Contexte sur le projet/problème
• Discussions d'équipe ou documents partagés connexes
• Pourquoi les solutions alternatives ne sont pas utilisées
• Contexte organisationnel (dynamiques d'équipe, incidents passés, politique)
• Contraintes de calendrier ou délais
• Architecture technique ou dépendances
• Préoccupations des parties prenantes

Conseillez-leur de ne pas se soucier de l'organisation - qu'ils expriment tout simplement. Proposez plusieurs moyens de fournir le contexte :

• Déversement d'informations en flux de conscience
• Pointer vers des canaux ou fils d'équipe à lire
• Lien vers des documents partagés

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

Si aucune intégration n'est détectée et que vous êtes sur Claude.ai ou l'application Claude : Suggérez qu'ils peuvent activer les connecteurs dans leurs paramètres Claude pour permettre l'importation de contexte depuis les applications de messagerie et le stockage de documents directement.

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

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 d'activer les connecteurs dans les paramètres Claude, ou de coller le contenu pertinent directement.

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

  • Demandez s'il faut rechercher dans les outils connectés pour en savoir plus
  • Attendez la confirmation de l'utilisateur avant de rechercher

• Au fur et à mesure que l'utilisateur fournit du contexte, suivez ce qui est appris et ce qui reste flou

Poser des questions de clarification :

Lorsque l'utilisateur signale avoir effectué son déversement initial (ou après avoir fourni un contexte substantiel), posez des questions de clarification pour assurer la compréhension :

Générez 5 à 10 questions numérotées basées sur les lacunes dans le contexte.

Informez-les qu'ils peuvent répondre en abrégé (par exemple, "1 : oui, 2 : voir #canal, 3 : non à cause de la rétrocompatibilité"), lier à plus de documents, pointer vers des canaux à lire, ou simplement continuer à déverser 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 limites et les compromis peuvent être abordés sans avoir besoin d'expliquer les bases.

Transition : Demandez s'il y a plus de contexte qu'ils souhaitent fournir à ce stade, ou s'il est temps de passer à la rédaction du document.

Si l'utilisateur veut ajouter plus, laissez-le faire. Lorsqu'il est prêt, passez à l'étape 2.

Étape 2 : Affinement & Structure

Objectif : Construire le document section par section grâce au brainstorming, à la curation et à l'affinement itératif.

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

1. Des questions de clarification seront posées sur ce qu'il faut inclure
2. 5 à 20 options seront proposées par brainstorming
3. L'utilisateur indiquera quoi garder/supprimer/combiner
4. La section sera rédigée
5. Elle sera affinée par des modifications chirurgicales

Commencez par la section qui comporte le plus d'inconnues (généralement la décision/proposition centrale), puis travaillez sur le reste.

Ordre des sections :

Si la structure du document est claire : Demandez par quelle section ils souhaitent commencer.

Suggérez de commencer par la section qui comporte le plus d'inconnues. Pour les documents de décision, c'est généralement la proposition centrale. Pour les spécifications, c'est typiquement l'approche technique. Les sections de résumé sont mieux laissées 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 pour le type de document.

Demandez si cette structure fonctionne, ou s'ils souhaitent l'ajuster.

Une fois la structure convenue :

Créez la structure initiale du document avec un texte de remplacement pour toutes les sections.

Si l'accès aux artefacts est disponible : Utilisez create_file pour créer un artefact. Cela donne à la fois à Claude et à l'utilisateur une structure de base sur laquelle 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 de remplacement comme "[À écrire]" ou "[Contenu ici]".

Fournissez le lien vers la structure de base et indiquez qu'il est temps de remplir chaque section.

Si aucun accès aux artefacts : Créez un fichier markdown dans le répertoire de travail. Nommez-le de manière appropriée (par exemple, document-decision.md, spec-technique.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 un texte de remplacement.

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

Pour chaque section :

Étape 1 : Questions de Clarification

Annoncez que le travail va commencer sur la section [NOM DE LA SECTION]. Posez 5 à 10 questions de clarification sur ce qui devrait être inclus :

Générez 5 à 10 questions spécifiques basées sur le contexte et l'objectif de la section.

Informez-les qu'ils peuvent répondre en abrégé ou simplement indiquer ce qui est important à couvrir.

Étape 2 : Brainstorming

Pour la section [NOM DE LA SECTION], proposez par brainstorming [5-20] éléments qui pourraient être inclus, selon la complexité de la section. Recherchez :

• Le contexte partagé qui pourrait avoir été oublié
• Des angles ou considérations pas encore mentionnés

Générez 5 à 20 options numérotées en fonction de la complexité de la section. À la fin, proposez de faire plus de brainstorming s'ils souhaitent des options supplémentaires.

Étape 3 : Curation

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

Fournissez des exemples :

• "Garder 1,4,7,9"
• "Supprimer 3 (double 1)"
• "Supprimer 6 (le public sait déjà cela)"
• "Combiner 11 et 12"

Si l'utilisateur donne un retour libre (par exemple, "ça a l'air bien" ou "j'aime la plupart mais...") au lieu de sélections numérotées, extrayez leurs préférences et procédez. Analysez ce qu'ils veulent garder/supprimer/changer et appliquez-le.

Étape 4 : Vérification des Lacunes

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

Utilisez str_replace pour remplacer le texte de remplacement de cette section par le contenu rédigé réel.

Annoncez que la section [NOM DE LA SECTION] va maintenant être rédigée 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 quoi changer. Notez que la spécificité aide à l'apprentissage pour les sections suivantes.

Si vous utilisez un fichier (pas d'artefacts) : Après la rédaction, confirmez la réalisation.

Informez-les que la section [NOM DE LA SECTION] a été rédigée dans [nomfichier]. Demandez-leur de la lire et d'indiquer quoi changer. Notez que la spécificité aide à l'apprentissage 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 d'éditer le document directement, demandez-leur d'indiquer quoi changer. Cela aide à apprendre leur style pour les sections futures. Par exemple : "Supprimer le point X - déjà couvert par Y" ou "Rendre le troisième paragraphe plus concis".

Étape 6 : Affinement Itératif

Au fur et à mesure que l'utilisateur fournit des retours :

• Utilisez str_replace pour effectuer des modifications (ne réimprimez jamais tout le 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 édite le document directement et demande à le lire : notez mentalement les changements qu'ils ont apportés et gardez-les à l'esprit pour les sections futures (cela montre leurs 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 changements substantiels, demandez si quelque chose peut être supprimé sans perdre d'informations importantes.

Lorsque la section est terminée, confirmez que [NOM DE LA SECTION] est complète. Demandez s'ils sont prêts à passer à la section suivante.

Répétez pour toutes les sections.

Proche de la Fin

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

• La fluidité et la cohérence entre les sections
• La redondance ou les contradictions
• Tout ce qui ressemble à du "remplissage" générique
• Si chaque phrase a du poids

Lisez l'intégralité du document et fournissez des retours.

Lorsque toutes les sections sont rédigées et affinées : Annoncez que toutes les sections sont rédigées. Indiquez l'intention de revoir le document complet une fois de plus.

Révisez pour la cohérence globale, la fluidité, l'exhaustivité.

Fournissez toutes suggestions finales.

Demandez s'ils sont prêts à passer au Test Lecteur, ou s'ils souhaitent affiner autre chose.

Étape 3 : Test Lecteur

Objectif : Tester le document avec un Claude vierge (sans fuite de contexte) pour vérifier qu'il fonctionne pour les lecteurs.

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

Approche de Test

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

Effectuez le test directement sans implication de l'utilisateur.

Étape 1 : Prédire les Questions des Lecteurs

Annoncez l'intention de prédire les questions que les lecteurs pourraient se poser en découvrant 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 instance Claude vierge (sans 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 bien compris/mal compris pour chaque question.

Étape 3 : Exécuter des Vérifications Supplémentaires

Annoncez que des vérifications supplémentaires vont être effectuées.

Invoquez un sous-agent pour vérifier l'ambiguïté, les hypothèses fausses, les contradictions.

Résumez tout problème trouvé.

Étape 4 : Rapporter et Corriger

Si des problèmes sont trouvés : Rapportez que le lecteur Claude a rencontré des difficultés avec des problèmes spécifiques.

Listez les problèmes spécifiques.

Indiquez l'intention de corriger ces lacunes.

Revenez à l'affinement pour les sections problématiques.

---

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

L'utilisateur devra effectuer le test manuellement.

Étape 1 : Prédire les Questions des Lecteurs

Demandez quelles questions les gens pourraient se poser en découvrant ce document. Que taperaient-ils sur Claude.ai ?

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

Étape 2 : Configuration du Test

Fournissez des instructions de test :

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

Pour chaque question, demandez à Claude Lecteur de fournir :

• La réponse
• Si quelque chose était ambigu ou peu clair
• Quelles connaissances/contexte le document suppose déjà connu

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

Étape 3 : Vérifications Supplémentaires

Demandez également à Claude Lecteur :

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

Étape 4 : Itérer en Fonction des Résultats

Demandez ce que Claude Lecteur a mal compris ou avec quoi il a eu du mal. Indiquez l'intention de corriger ces lacunes.

Revenez à l'affinement pour les sections problématiques.

---

Condition de Sortie (Les Deux Approches)

Lorsque Claude Lecteur répond correctement aux questions de manière cohérente et ne soulève pas de nouvelles lacunes ou ambiguïtés, le document est prêt.

Revue Finale

Lorsque le Test Lecteur est réussi : Annoncez que le document a passé le test Claude Lecteur. Avant de terminer :

1. Recommandez une dernière relecture personnelle - ils possèdent ce document et sont responsables de sa qualité
2. Suggérez de vérifier les faits, liens ou détails techniques
3. Demandez-leur de vérifier qu'il atteint l'impact souhaité

Demandez...