Que fait Rédacteur de Newsletter ?
Rédigez des e-mails de mise à jour produit et des lettres d'annonce de fonctionnalités. Gère les lignes d'objet, le texte d'aperçu, la structure de l'e-mail et le contenu adapté au public.
Résolution de l'entrée
Résolvez l'argument (si fourni) dans cet ordre :
- Chemin vers un brief marketing existant (
.mdcontenant "Executive Summary" ou "Key Messages") -> brief marketing - Chemin vers un article de blog existant (
.mdavec une structure d'article de blog) -> article de blog - Chemin vers un changelog existant (
.mdavec les sections Ajouté/Corrigé/Modifié ou CHANGELOG.md) -> changelog - Correspond à une URL GitHub ou un motif
#\d+-> PR - Contient
...ou..-> plage de références Git - Se résout en fichier/répertoire existant -> fonctionnalité du code
- Sinon -> texte libre
Si aucun argument n'est fourni, demandez : "Que doit couvrir la newsletter ? Vous pouvez fournir un brief marketing, un article de blog, un changelog, une URL/numéro de PR, une plage de références Git, un chemin de fichier/répertoire, ou simplement décrire la mise à jour."
Si plusieurs interprétations correspondent, confirmez avec l'utilisateur.
Flux de processus
digraph newsletter {
rankdir=TB;
"Résoudre l'entrée" [shape=box];
"Phase 1 : Découverte" [shape=box];
"Phase 2 : Configuration" [shape=box];
"Phase 3 : Rédaction" [shape=box];
"Phase 4 : Révision" [shape=box];
"Approuvé ?" [shape=diamond];
"Phase 5 : Sortie" [shape=box];
"Résoudre l'entrée" -> "Phase 1 : Découverte";
"Phase 1 : Découverte" -> "Phase 2 : Configuration";
"Phase 2 : Configuration" -> "Phase 3 : Rédaction";
"Phase 3 : Rédaction" -> "Phase 4 : Révision";
"Phase 4 : Révision" -> "Approuvé ?";
"Approuvé ?" -> "Phase 3 : Rédaction" [label="révisions"];
"Approuvé ?" -> "Phase 5 : Sortie" [label="oui"];
}
Ne sautez PAS les phases. Posez les questions à un rythme naturel. Si l'utilisateur répond à plusieurs questions à la fois, acceptez des réponses groupées et passez à la suite.
Si l'utilisateur dit "choisis les valeurs par défaut", "décide toi-même" ou quelque chose d'approchant, 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 présumez jamais sans confirmer.
Phase 1 : Découverte
Étape 1 - Analyser l'entrée
| Type d'entrée | Que lire |
|---|---|
| Brief marketing | Extrayez l'énoncé du problème, la proposition de valeur, le public, les messages clés. Passez à l'étape 3. Faites quand même l'étape 2 si le brief manque de contexte produit. |
| Article de blog | Extrayez le titre, les points clés, le public, l'appel à l'action. Passez à l'étape 3. Faites quand même l'étape 2 si cela manque de contexte produit. |
| Changelog | Extrayez toutes les entrées. Utilisez-les comme base pour un e-mail de synthèse. Passez à l'étape 3. |
| PR | Diff, description de la PR, commentaires de révision, 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é du code | Lisez les fichiers/répertoires spécifiés. |
| Texte libre | Analysez la description de l'utilisateur. Si elle manque de détails, demandez à l'utilisateur de fournir plus d'informations ou de pointer vers un fichier/PR spécifique. Revenez à des questions ouvertes seulement s'il ne peut pas. |
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. Changements internes incluent : refontes, ajouts de tests, modifications CI et mises à jour de dépendances. En cas de doute, listez ce que vous avez trouvé et demandez à l'utilisateur ce qui est pertinent.
Gestion des erreurs :
ghnon disponible -> informez l'utilisateur, suggérezgh auth login, proposez une entrée alternative- PR/référence invalide -> demandez à l'utilisateur 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).
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 et déterminer le format
Présentez un résumé structuré :
"Voici ce sur quoi je vais baser la newsletter :"
- Mise à jour A - brève description
- Mise à jour B - brève description
"Quelque chose à ajouter, supprimer ou corriger ?"
Ensuite, déterminez le format de l'e-mail en fonction du nombre de mises à jour :
- Mise à jour majeure unique -> e-mail mono-fonctionnalité (ciblé, approfondi)
- Plusieurs mises à jour -> e-mail digest (liste priorisée, la plus importante développée)
Confirmez le format avec l'utilisateur.
Si aucun changement visible par l'utilisateur n'est trouvé dans l'entrée, dites-le à l'utilisateur et arrêtez-vous : "Aucun changement visible par l'utilisateur trouvé dans cette entrée. Rien à écrire pour une newsletter."
Ne continuez PAS avant que l'utilisateur ait confirmé la portée et le format.
Phase 2 : Configuration
Posez ces questions :
Q1 - Public : "À qui va cet e-mail ?" (tous les utilisateurs, utilisateurs avancés, nouveaux utilisateurs, niveau de plan spécifique, développeurs, utilisateurs non techniques, autre)
Q2 - Format de sortie : "Dans quel format voulez-vous l'e-mail ?"
- Copie seule - ligne d'objet, texte d'aperçu, corps du texte, texte de l'appel à l'action (à insérer dans votre outil d'e-mail)
- Markdown - markdown formaté que la plupart des outils d'e-mail peuvent importer
Q3 - Ton : Lisez le contenu existant du dépôt (README, docs, articles de blog) pour détecter la voix du produit. Confirmez ensuite :
"D'après votre contenu existant, le ton semble [par ex. conversationnel et adapté aux développeurs]. Dois-je m'en tenir à cela ou aller dans une direction différente ?"
Si aucun contenu existant à analyser, demandez directement le ton souhaité par l'utilisateur.
Q4 - Appel à l'action (CTA) : Déduisez l'appel à l'action le plus approprié du contexte :
- Nouvelle fonctionnalité -> "Essayez-le maintenant", "Découvrez ce qui est nouveau"
- Amélioration -> "Jetez-y un œil", "Voyez la différence"
- Open source -> "Mettez à jour maintenant", "Voir la version"
"Je suggère que l'appel à l'action soit : [CTA déduit]. Voulez-vous l'utiliser ou autre chose ?"
Phase 3 : Rédaction
Lignes d'objet
Générez 3 à 5 options de ligne d'objet avec différentes approches :
- Axée sur les bénéfices ("Vos rapports s'exportent désormais en PDF")
- Curiosité ("Nous avons repensé le fonctionnement de la recherche")
- Nom de fonctionnalité spécifique ("Présentation du mode sombre")
- Question ("Vous attendez encore la fin des exportations ?")
- Urgence/actualité ("Nouveau cette semaine : 3 fonctionnalités que vous avez demandées")
Recommandez-en une et expliquez pourquoi elle fonctionne le mieux. Expliquez également les compromis des autres.
Règles :
- 30 à 50 caractères optimal (évitez la troncature sur mobile)
- Soyez spécifique, pas générique ("Nouveau : exportations PDF" bat "Mise à jour produit - mars 2026")
- Aucun mot déclencheur de spam (Gratuit, Acheter maintenant, Agissez maintenant)
Texte d'aperçu
Générez un texte d'aperçu pour chaque option de ligne d'objet. Le texte d'aperçu est la ligne secondaire visible dans les aperçus de la boîte de réception.
Règles :
- 40 à 130 caractères
- Développez la ligne d'objet, ne la répétez pas
- Incluez le bénéfice ou le résultat clé
Corps de l'e-mail
Structure d'e-mail mono-fonctionnalité :
- Énoncé du problème - une phrase décrivant le problème que cela résout
- Ce qui a changé - 2 à 3 phrases décrivant la mise à jour en langage bénéfice-utilisateur ("Les rapports se chargent plus vite" pas "Exécution de la requête SQL optimisée")
- Espace réservé visuel -
<!-- TODO: Ajouter une capture d'écran ou un GIF montrant la fonctionnalité en action -->avec une description de ce qu'il faut capturer - Bouton CTA - une seule action claire
Structure d'e-mail digest :
- Mise à jour principale - la mise à jour la plus importante reçoit le traitement complet mono-fonctionnalité (problème, ce qui a changé, visuel, CTA)
- Mises à jour secondaires - des puces brèves avec des descriptions d'une ligne et des liens
- Correctifs rapides / améliorations - liste groupée de petites modifications
- CTA de clôture - une seule action ou "Voir toutes les mises à jour"
Règles de rédaction
- Mettez en avant le bénéfice utilisateur, pas ce que vous avez construit
- Ton conversationnel, pas corporate
- Paragraphes courts (2 à 3 phrases maximum)
- Une idée par paragraphe
- N'utilisez jamais de tirets longs (tiret cadratin) dans le contenu généré. Pas de caractères "---". Utilisez plutôt des virgules, des deux-points, des points ou des parenthèses.
- Pas de jargon. "Les rapports se chargent plus vite" bat "Plan d'exécution de requête SQL optimisé"
- Mettez en gras les phrases clés pour la lisibilité
- Gardez le texte facile à parcourir. Plus c'est court, mieux c'est. Si l'e-mail prend plus de 60 secondes à lire, il est trop long.
Variantes par segment
Après avoir généré l'e-mail principal, demandez :
"Voulez-vous que je génère des variantes pour différents segments de public ? (par ex. une version plus technique pour les développeurs, une version plus simple pour les utilisateurs non techniques)"
Si oui, générez les variantes demandées, en ajustant le ton, la profondeur et l'accent sur les fonctionnalités par segment.
Phase 4 : Révision
Présentez l'e-mail complet :
"Voici la newsletter :"
Options de ligne d'objet : (avec recommandation et texte d'aperçu pour chacune)
- Sujet : "..." / Aperçu : "..."
- Sujet : "..." / Aperçu : "..."
- Sujet : "..." / Aperçu : "..."
Corps : [contenu complet de l'e-mail]
"Choisissez une ligne d'objet et dites-moi si vous voulez des modifications."
Attendez que l'utilisateur sélectionne une ligne d'objet et approuve ou demande des révisions. Ne passez à la sortie qu'une fois approuvé.
Phase 5 : Sortie
Imprimez toujours l'e-mail final approuvé dans le terminal.
Demandez ensuite : "Voulez-vous que je sauvegarde ceci dans emails/<slug>.md ? Ou un chemin différent ?"
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
- Aucun contexte produit -> demandez à l'utilisateur de décrire le produit
- Aucun répertoire d'e-mails existant -> par défaut
emails/, créez-le
Ce que cette compétence NE fait PAS
- Envoyer ou planifier des e-mails
- Gérer les listes d'abonnés ou la logique de segmentation
- Créer des modèles d'e-mails ou des systèmes de conception
- Générer des articles de blog ou des copies pour les réseaux sociaux (utilisez
/blog-postou/social-copy)