Modèle de prompt : Écriture compatible avec Gen AI

Cet article fournit un modèle d’invite prêt à l’emploi pour rédiger ou réviser des documents à l’aide d’un outil d’écriture IA. L’invite est conçue pour produire un contenu optimisé à la fois pour les lecteurs humains et pour les systèmes de récupération par IA comme Eddy AI.

Pour la logique complète de chaque règle dans cette invitation, consultez le contenu compatible avec Gen AI. Pour vérifier votre production avant publication, utilisez la liste de contrôle de contenu compatible avec Gen AI.

Quand utiliser cette invite

Utilisez cette invite lorsque vous souhaitez :

• Rédigez un nouvel article à partir d’un sujet ou d’un plan en utilisant un agent de rédaction IA.
• Révisé un article existant pour le rendre compatible avec GenAI.
• Générez un premier brouillon avant d’appliquer vos propres modifications et revues.

Invite maître pour l’agent IA

You are a technical documentation writer tasked with creating GenAI-friendly content that works effectively for both human readers and AI-powered assistants.
Follow these rules when drafting the article:

Follow These
Use clear, hierarchical headings (H1, H2, H3) with descriptive, keyword-rich titles.
Write short, focused sentences (<20 words) and one idea per paragraph.
Use bullet points for grouped info and numbered lists for steps (3–7 items max).
Present structured data in tables with clear labels (no merged cells, no empty placeholders).
Format code snippets cleanly, with syntax highlighting, consistent indentation, and meaningful comments.
Provide descriptive alt text for images and clear anchor text for links.
Write in a conversational, user-first tone, using plain language and "you" when guiding.
Apply SEO practices: natural keyword use, meta descriptions, glossary-approved terms.
Include a FAQ section (5–10 self-contained Q&A).
Make content modular and reusable so AI can extract, summarize, and repurpose easily.

Avoid These
Don't use generic headings like "Overview" or repeat the same heading multiple times.
Don't write long, complex sentences or dense paragraphs.
Don't include filler, background fluff, or unnecessary context inside instructional steps (link to supporting content instead).
Don't use vague anchor text like "here" or "this article."
Don't add placeholders in tables (like "Y/N," "—", emojis, or icons).
Don't format code blocks with line numbers or styling that prevents copy-paste.
Don't switch between synonyms or variations of glossary terms inconsistently.
Don't overuse jargon, acronyms, or unexplained abbreviations.
Don't stuff keywords unnaturally or repeat them excessively.

Instruction de tâche pour l’IA

Generate a [type of article: how-to guide, feature explanation, or FAQ] for [topic/product/feature].
Ensure the output is clear, modular, and optimized for both human readers and AI systems. Include:

Headings/subheadings
Short paragraphs
Bullet/numbered lists where needed
Tables for structured data
At least 5 FAQs with clear answers
Proper SEO keywords (without stuffing)
Consistent glossary

Comment personnaliser la consigne

Ajustez la section TÂCHES en bas pour chaque article que vous rédigez :

Vous pouvez également ajouter des instructions supplémentaires à la section TÂCHE, par exemple :

• « Le public cible est constitué de nouveaux utilisateurs de Document360 sans connaissance préalable de la plateforme. »
• « Référence aux termes produits suivants : [termes de liste]. »
• « L’article doit faire moins de 600 mots. »

Présentez votre prompt comme une compétence

Le thème principal ci-dessus fonctionne pour des brouillons ponctuels. Pour des flux de travail répétés comme la documentation des fonctionnalités issues de PRD, de spécifications ou de notes approximatives, emballez-le sous forme de fichier SKILL.md afin que des agents IA comme Claude suivent le même processus à chaque fois sans repasser le pastage de l’invite.

Un SKILL.md est un fichier Markdown structuré composé de deux parties : un bloc frontmatter (nom, description, phrases déclencheuses) et un corps (étapes, règles d’écriture, format de sortie). Installez-le une fois ; Réutilisez-le avec toute votre équipe.

Exemple : Rédacteur technique - compétence d’article de fond

Cette compétence aide Claude à rédiger des articles de documentation complets et prêts à publier pour toute fonctionnalité logicielle — en suivant les conventions MSTP (Microsoft Manual of Style for Technical Publications) tout au long du processus.
Installez-le quand vous devez documenter une fonctionnalité de zéro ou apporter de la structure à des notes approximatives. Une fois activée, décrivez votre fonctionnalité (ou collez un PRD, une spécification ou une capture d’écran) et Claude produit un article complet couvrant chaque section sur laquelle les lecteurs comptent : une introduction précise, les prérequis, le moment d’utiliser la fonctionnalité, les instructions étape par étape, les limitations, les meilleures pratiques, le dépannage et les FAQ.

Pour l’installer :

1. Téléchargez le .skill fichier.

   tech-rédacteur-article.compétence  
2. Dans Claude, allez dans Paramètres -> Connecteurs -> Personnaliser -> Compétences -> Ajouter une compétence -> Sélectionner Créer une compétence -> Télécharger une compétence.
Vous pouvez maintenant glisser-déposer ou cliquer pour télécharger le fichier de compétences installé.
3. Une fois la compétence ajoutée, il suffit de partager le nom de votre caractéristique, votre PRD ou vos notes — Claude s’occupe du reste.
Ça fonctionne mieux quand on donne à Claude un document d’exigence produit ou une description de fonctionnalité. Plus vous partagez de contexte, moins Claude a besoin de poser de questions.

Après avoir utilisé la consigne

La production IA est un premier brouillon, il faut toujours réviser avant de publier. Vérifier :

• Pensées incomplètes ou étapes manquantes.
• Des faits hallucinés ou des détails inexacts sur les produits.
• Un ton ou une formulation qui ne correspond pas à votre guide de style de documentation.
• Des termes de glossaire manquants ou utilisés de manière incohérente.