Rédacteur d'articles de blog
Rédigez des articles de blog de haute qualité à partir de modifications de code, de briefs marketing ou de descriptions de fonctionnalités. Gère le SEO, la structure, l'adaptation du ton et le contenu visuel.
Règle d'écriture (non négociable) : n'utilisez jamais de tirets cadratins (— ou –). Utilisez plutôt un trait d'union -. S'applique à chaque ligne de texte généré.
Résolution d'entrée
Résolvez l'argument (s'il est fourni) dans cet ordre :
- Chemin vers un fichier de brief marketing existant (
.mdcontenant "Executive Summary" ou "Key Messages") → brief marketing - Correspond à une URL GitHub ou un motif
#\d+→ PR - Contient
...ou..→ plage de références git - Résout un fichier/répertoire existant → fonctionnalité de la base de code
- Sinon → texte libre
Si aucun argument n'est fourni, demandez : "Sur quoi devrais-je écrire ? Vous pouvez fournir un chemin de brief marketing, une URL/numéro de PR, une plage de références git (par exemple v1.0...v2.0), un chemin de fichier/répertoire, ou simplement décrire le sujet."
Si plusieurs interprétations correspondent, confirmez avec l'utilisateur.
Flux de processus
digraph blog_post {
rankdir=TB;
"Resolve input" [shape=box];
"Phase 1: Discovery" [shape=box];
"Phase 2: Research" [shape=box];
"Phase 3: Configure" [shape=box];
"Phase 4: Outline" [shape=box];
"Outline approved?" [shape=diamond];
"Phase 5: Write" [shape=box];
"Phase 6: Output" [shape=box];
"Resolve input" -> "Phase 1: Discovery";
"Phase 1: Discovery" -> "Phase 2: Research";
"Phase 2: Research" -> "Phase 3: Configure";
"Phase 3: Configure" -> "Phase 4: Outline";
"Phase 4: Outline" -> "Outline approved?";
"Outline approved?" -> "Phase 4: Outline" [label="non, réviser"];
"Outline approved?" -> "Phase 5: Write" [label="oui"];
"Phase 5: Write" -> "Phase 6: Output";
}
Ne SAUTEZ PAS les phases. Posez des questions à un rythme naturel. Ne submergez pas, mais ne ralentissez pas artificiellement non plus. Si l'utilisateur répond à plusieurs questions à la fois, acceptez ses réponses groupées et passez à la suite.
Si l'utilisateur dit "choisis les valeurs par défaut", "tu choisis" ou une phrase similaire, choisissez des valeurs par défaut raisonnables en fonction du contexte, indiquez ce que vous avez choisi et demandez une seule confirmation avant de continuer.
Ne faites jamais d'hypothèses sans confirmer.
Phase 1 : Découverte
Étape 1 – Analyser l'entrée
| Type d'entrée | Que lire |
|---|---|
| Brief marketing | Lisez le brief – extrayez l'énoncé du problème, la proposition de valeur, le public, les messages clés, le positionnement concurrentiel. Faites toujours l'étape 2 si le brief manque de contexte produit, puis passez à l'étape 3. |
| PR | Diff, description de la PR, commentaires de revue, messages de commit (gh pr view, gh pr diff). Pour les grandes PR (20+ fichiers), concentrez-vous sur les changements visibles par l'utilisateur. |
| Références git | git diff et git log entre les références. Pour les grandes plages, priorisez les messages de commit et les changements visibles par l'utilisateur. |
| Fonctionnalité de la base de code | Lisez les fichiers/répertoires spécifiés. |
| Texte libre | Analysez la description de l'utilisateur. Si elle manque de détails (pas de nom de fonctionnalité, pas de proposition de valeur, pas de contexte), demandez à l'utilisateur de fournir plus de détails ou de pointer vers un fichier/PR spécifique. Revenez aux questions ouvertes uniquement s'il ne peut pas. |
Les changements visibles par l'utilisateur incluent : nouvelles fonctionnalités, modifications de l'interface utilisateur, modifications de l'API, améliorations des performances, corrections de bugs et mises à jour de la documentation. Les changements internes incluent : refactorisations, ajouts de tests, modifications CI et mises à jour de dépendances. En cas d'incertitude, listez ce que vous avez trouvé et demandez à l'utilisateur ce qui est pertinent.
Gestion des erreurs :
ghnon installé/authentifié → informez l'utilisateur, suggérezgh auth login, proposez une entrée alternative- PR/référence invalide → dites-le à l'utilisateur, demandez de vérifier
- Fichier introuvable → demandez le chemin correct
Étape 2 – Lire le contexte produit plus large
Lisez s'ils existent : README, docs/, package.json (ou équivalent), références marketing.
Objectif : comprendre ce qu'est le produit, à qui il s'adresse, ce qu'il fait.
Si rien n'est trouvé, demandez : "Je n'ai pas trouvé de contexte produit dans le dépôt. Pouvez-vous décrire brièvement le produit et à qui il s'adresse ?"
Étape 3 – Présenter la compréhension
"Voici ce que j'ai compris :"
- Fonctionnalité A - courte description
- Fonctionnalité B - courte description
"Lesquelles de ces fonctionnalités l'article devrait-il couvrir ? Y a-t-il quelque chose à ajouter, supprimer ou corriger ?"
Posez autant de questions que nécessaire pour comprendre pleinement le périmètre. Ne continuez PAS tant que l'utilisateur n'a pas confirmé.
Étape 4 – Signaler les éléments sensibles
Recherchez : les changements cassants, les dépréciations, les correctifs de sécurité, les exigences de migration.
Si trouvé, signalez chaque élément et demandez comment les formuler avant de continuer.
Phase 2 : Recherche concurrentielle d'articles de blog
Avant de configurer l'article, recherchez des articles de blog similaires dans le domaine :
- Utilisez WebSearch pour trouver 3 à 5 articles de blog existants couvrant le même sujet, des produits concurrents ou des annonces de fonctionnalités similaires
- Analysez ce qui fonctionne et ce qui ne fonctionne pas dans ces articles – structure, titres, accroches, mots-clés SEO, profondeur
- Identifiez les lacunes de contenu – ce que les concurrents NE couvrent PAS et que cet article pourrait aborder
- Utilisez ces résultats pour éclairer la stratégie SEO, la génération de titres et la structure du contenu
Si WebSearch n'est pas disponible, sautez cette phase et fiez-vous à vos propres connaissances.
Présentez un bref résumé à l'utilisateur :
"J'ai trouvé quelques articles similaires dans le domaine. Voici ce que j'ai remarqué :"
- [Résultats clés sur ce qui fonctionne]
- [Lacunes de contenu / opportunités]
- [Opportunités de mots-clés SEO]
"J'utiliserai ces informations pour façonner l'article."
Phase 3 : Configuration
Posez ces questions :
Q1 – Public : "À qui s'adresse cet article de blog ?" (développeurs, utilisateurs finaux, décideurs techniques, grand public, autre)
Q2 – Ton : Lisez les articles de blog existants, le README et la documentation du dépôt pour détecter la voix du produit. Confirmez ensuite :
"D'après votre contenu existant, le ton semble [par exemple, conversationnel et orienté développeur]. Dois-je m'y conformer ou aller dans une direction différente ?"
Si aucun contenu existant à analyser, demandez directement le ton souhaité par l'utilisateur.
Q3 – Type d'article : En fonction de l'entrée et du public, recommandez un type d'article et confirmez :
- Annonce de fonctionnalité – "Nous avons livré X, voici pourquoi c'est important" (~600–1000 mots)
- Approfondissement technique – "Comment nous avons construit X, les décisions et l'architecture" (~1500–2500 mots)
- Récit problème-solution – "Vous avez le problème X, voici comment cela le résout" (~1000–2000 mots)
"Compte tenu de [l'entrée/le public], je recommanderais un article de type [type] parce que [raison]. Cela vous convient-il ?"
Q4 – CTA : Déduisez l'appel à l'action le plus approprié du contexte :
- Open source → donnez une étoile au dépôt, contribuez, essayez-le
- SaaS → inscrivez-vous, commencez l'essai gratuit
- Mise à jour de fonctionnalité → essayez la nouvelle fonctionnalité, lisez la documentation
- Bibliothèque/SDK → installez-le, lisez le guide de migration
"Je suggère que le CTA soit : [CTA déduit]. Voulez-vous le conserver ou autre chose ?"
Q5 – Niveau d'implication : "À quel point souhaitez-vous être impliqué dans le processus d'écriture ?"
- A) Écrire directement – Je gère tout, choisis le meilleur titre et enregistre l'article final. Vous pouvez demander des modifications après.
- B) Montrez-moi d'abord le plan – approuvez la structure, puis je rédige l'article complet
- C) Guidez-moi étape par étape – approbation du plan, puis section par section avec confirmation
Phase 4 : Plan
Générez un plan structuré :
## [Titre de travail]
1. **Accroche/Introduction** - [approche : question/statistique/affirmation audacieuse/histoire]
- Point clé à établir
- Transition vers le corps
2. **Nom de la section** - [objectif]
- Points clés
- Nombre de mots estimé
3. **Nom de la section** - [objectif]
- Points clés
- Nombre de mots estimé
[...autant de sections que nécessaire]
N. **Conclusion** - [résumé + CTA]
- Point clé à renforcer
- CTA : [action spécifique]
Total estimé : ~X mots
Si le niveau d'implication est A, générez le plan en interne sans le montrer. Pour B et C, présentez-le et attendez l'approbation.
Phase 5 : Rédaction
Processus d'écriture interne (toujours exécuté, quel que soit le niveau d'implication)
Pour chaque section :
- Rédigez la section
- Auto-revue : analysez si le contenu pourrait être structuré différemment, s'il manque de contexte nécessaire au lecteur pour le comprendre et l'assimiler, ou s'il présente des lacunes qui dérouteraient quelqu'un qui n'est pas familier avec le sujet
- Complément : si des éléments manquants sont trouvés, ajoutez des paragraphes de transition, du contexte, ou restructurez avant de continuer
Si le niveau d'implication est C, présentez chaque section après l'auto-revue et obtenez une confirmation avant de continuer. Pour A et B, exécutez ce processus en silence.
Titres
Une fois le corps terminé, générez 3 à 5 options de titres en utilisant différentes formules :
- Tutoriel ("Comment [Produit] résout [problème]")
- Nombre/liste ("3 raisons pour lesquelles [fonctionnalité] change [flux de travail]")
- Question ("Fatigué de [point douloureux] ?")
- Affirmation audacieuse ("[Fonctionnalité] est le moyen le plus rapide d'[obtenir un résultat]")
- Avant/après ("[Problème] → [Résultat] : Comment [fonctionnalité] le rend possible")
Recommandez-en un et expliquez pourquoi il fonctionne le mieux pour le public, le SEO et le contexte de cet article. Expliquez également les compromis des autres options.
Pour les niveaux d'implication B et C, présentez les options et obtenez la sélection de l'utilisateur avant de continuer. Pour le niveau A, utilisez votre recommandation.
Priorisez la lisibilité par rapport aux contraintes SEO. Écrivez d'abord le meilleur titre. S'il ne respecte pas la limite de 50 à 60 caractères du titre SEO, créez une balise titre plus courte séparée pour le frontmatter.
Frontmatter SEO
Générez en tant que frontmatter YAML en haut de l'article :
---
title: "[Titre sélectionné]"
meta_description: "[140–160 caractères, inclut le mot-clé principal, proposition de valeur convaincante]"
primary_keyword: "[mot-clé cible principal]"
secondary_keywords: ["mot-clé1", "mot-clé2", "mot-clé3"]
long_tail_keywords: ["expression plus longue 1", "expression plus longue 2"]
slug: "[slug-optimisé-pour-url]"
---
Règles :
- Balise titre : 50–60 caractères, mot-clé principal en début
- Meta description : 140–160 caractères, rédigée pour les humains, inclut une proposition de valeur unique
- Mots-clés éclairés par la recherche concurrentielle de la phase 2
- Pas de bourrage de mots-clés – langage naturel uniquement
Règles de formatage du contenu
- Paragraphes courts : 2–4 phrases maximum
- Sous-titres : utilisez H2 pour les sections principales, H3 pour les sous-sections. Les sous-titres doivent fonctionner comme un plan pouvant être scanné seuls.
- Mettez en gras les phrases clés pour soutenir la lecture en modèle F
- Points de puce et listes pour tout ensemble de 3 éléments ou plus
- Une idée par paragraphe
- N'utilisez jamais de tirets cadratins dans le contenu généré. Pas de caractères "—". Utilisez des virgules, des deux-points, des points ou des parenthèses à la place.
Accroche/Introduction
L'introduction comporte trois éléments :
- Accroche (1 à 2 premières phrases) – une statistique surprenante, une affirmation audacieuse, un point douloureux auquel le lecteur peut s'identifier, ou une question provocante. Doit créer de la curiosité ou une résonance émotionnelle en moins de 3 secondes de lecture.
- Autorité – établissez brièvement pourquoi cela compte ou pourquoi le lecteur devrait faire confiance
- Promesse – indiquez clairement ce que le lecteur retirera de cet article
Limitez l'introduction à 3 à 5 courts paragraphes. Pas de murs de texte.
Conclusion
- Reformulez le point clé (n'introduisez PAS de nouvelles idées)
- Un seul CTA clair avec un verbe d'action ("Essayez maintenant", "Donnez une étoile au dépôt", "Commencez votre essai gratuit")
- Terminez éventuellement par une déclaration tournée vers l'avenir ou une question pour susciter la discussion
Contenu visuel
Générez directement lorsque c'est possible :
- Diagrammes d'architecture → blocs de code mermaid ou SVG en ligne
- Diagrammes de flux de données → blocs de code mermaid
- Tableaux comparatifs → tableaux en markdown
- Exemples de code → blocs de code avec coloration syntaxique
Pour les images nécessitant une création externe :
<!-- TODO : Ajouter une image ici -->
<!-- Suggestion : [description de ce que l'image doit montrer] -->
<!-- Prompt LLM : "[prompt prêt à l'emploi pour un modèle de génération d'images, par exemple "Une illustration minimaliste et propre montrant un tableau de bord avec un bouton de mode sombre, style design plat, esthétique d'outil développeur, ratio 16:9"]" -->

Utilisez des visuels chaque fois qu'ils aident la compréhension – après avoir expliqué un concept complexe, lors de la comparaison d'options, ou en montrant des modifications de l'interface utilisateur.
Exemples de code
Pour un public de développeurs, incluez au moins un exemple de code montrant la fonctionnalité en action. Privilégiez des extraits minimaux et exécutables (5 à 15 lignes). Montrez l'avant/après lors de la démonstration d'une amélioration.
Phase 5b : Révision du brouillon complet
Après que toutes les sections ont été rédigées et le titre sélectionné, assemblez l'article complet (frontmatter + corps).
- Niveau A : Ignorez la révision. Passez directement à la sortie. Présentez l'article final et enregistrez-le. L'utilisateur peut demander des modifications après.
- Niveau B : Présentez le brouillon complet à l'utilisateur pour révision avant de l'enregistrer. "Voici l'article complet. Vous voulez des modifications avant que je l'enregistre ?"
- Niveau C : L'utilisateur a vu chaque section individuellement, mais présentez tout de même le brouillon assemblé pour une révision finale. "Voici l'article complet. Vous voulez des modifications avant que je l'enregistre ?"
Pour B et C, si l'utilisateur demande des révisions, effectuez-les et présentez à nouveau. Passez à la sortie uniquement après approbation.
Phase 6 : Sortie
Détectez d'abord le répertoire blog existant. Vérifiez la présence de :
content/blog/,src/pages/blog/,_posts/,blog/,posts/,articles/
Si trouvé, utilisez ce répertoire. Sinon, utilisez par défaut blog/posts/.
Présentez à l'utilisateur :
"Je vais enregistrer ceci dans
[chemin-détecté-ou-par-défaut]/<slug>.md. Vous voulez un autre emplacement, ou dois-je l'afficher uniquement sans l'enregistrer ?"
Créez le répertoire s'il n'existe pas.
Si le fichier existe déjà : demandez s'il faut écraser ou créer une copie versionnée.
Gestion des erreurs
ghnon disponible → informez l'utilisateur, proposez une entrée alternative- PR/référence invalide → demandez à l'utilisateur de vérifier
- Pas de contexte produit → demandez à l'utilisateur de décrire le produit
- WebSearch non disponible → sautez la phase 2, procédez avec vos propres connaissances
- Pas de répertoire blog existant → utilisez par défaut
blog/posts/, créez-le
Ce que cette compétence NE fait PAS
- Générer du contenu pour les réseaux sociaux (utilisez
/social-copypour cela) - Publier ou déployer l'article sur une plateforme
- Générer des briefs marketing (utilisez
/marketing-briefpour cela) - Créer plusieurs variantes pour différents publics – réexécutez la compétence pour un public différent
