Voix de Newsletter

Que fait Voix de Newsletter ?

Environnement d'exécution Codex et Claude

• Utilisez cette compétence dans Codex ou Claude avec les outils réellement disponibles dans la tâche en cours. Les exemples AskUserQuestion décrivent les questions, pas une API obligatoire : utilisez un outil de question disponible dans ses limites, ou posez la question dans le chat. Réutilisez les réponses et le matériel source déjà fournis.
• Travaillez dans le projet sélectionné par l'utilisateur. Lisez ses fichiers about-me.md, voice.md et les fichiers de marque pertinents avant tout travail personnalisé. Confirmez l'auteur prévu si les fichiers sont en conflit ou contiennent des valeurs par défaut. Demandez les informations manquantes ou exécutez voice-builder ; n'héritez jamais de l'identité, des comptes ou des fichiers privés du mainteneur.
• Résolvez les references/ fournies par rapport à ce dossier de compétence. Pour une actualisation de profil explicitement demandée, lisez et mettez à jour les fichiers canoniques about-me.md, voice.md ou newsletter-voice.md sur place, en préservant les faits et règles non liés de l'utilisateur. Les consommateurs doivent relire ces fichiers canoniques. Utilisez un nouveau nom de fichier uniquement pour les nouveaux livrables qui entreraient en conflit avec des fichiers existants non liés. L'installation seule ne lance jamais d'interview ni n'écrit de fichiers. N'écrivez pas d'apprentissages persistants sauf si demandé.
• Utilisez d'abord les preuves fournies. Vérifiez les affirmations externes via les outils de recherche/source disponibles si nécessaire. Si une source ou une intégration est indisponible, nommez la capacité manquante et proposez la saisie de texte/export fournie. N'inventez jamais de faits, d'expérience à la première personne, de métriques ou d'exécution réussie d'outil.
• Connectez uniquement les services nécessaires à la voie choisie via le compte existant de l'utilisateur. N'imprimez jamais d'identifiants et ne remplacez jamais les connexions. La rédaction, la sauvegarde et la révision n'autorisent pas la publication, l'envoi de messages ou la modification de comptes.

Vérification des prérequis

Dès que cette compétence est déclenchée, vérifiez la présence de voice.md et about-me.md à la racine du projet.

Si l'un des deux fichiers est manquant, dites à l'utilisateur :

La voix de newsletter repose sur votre profil vocal général. Exécutez d'abord voice-builder (téléchargez la compétence ou dites "construis ma voix"), puis revenez ici une fois que about-me.md et voice.md sont dans le projet.

Puis arrêtez-vous. Ne continuez pas tant que les deux fichiers n'existent pas.

Si les deux fichiers existent, lisez-les entièrement, puis passez directement à l'Étape 1.

Étape 1. Vérification des échantillons

Demandez à l'utilisateur dans le chat :

Avez-vous 2 à 3 anciens numéros de newsletter dont je peux m'inspirer ?

Oui : collez-les ici (un par message ou tous en une fois) Non : tapez "archétype" et je construirai à partir d'un modèle adapté à votre voix

Attendez la réponse.

Si l'utilisateur colle 2 newsletters ou plus, passez à l'Étape 2a. Si l'utilisateur tape "archétype", passez à l'Étape 2b. Si l'utilisateur colle 1 newsletter, demandez-en au moins une autre. S'il n'en a qu'une, proposez : "Un seul échantillon ne suffit pas pour détecter des motifs. Voulez-vous passer en mode archétype et utiliser votre unique newsletter comme point de référence ?"

Étape 2a. Analyse basée sur les échantillons

Lisez entièrement chaque newsletter. Recherchez des motifs récurrents entre les numéros, pas des particularités isolées. Extrayez :

Formule d'ouverture

• Ce que font les 3 premières phrases (résultat spécifique, observation culturelle, affirmation, scène, question)
• Longueur de la section d'ouverture avant la première rupture structurelle
• Mouvement de crédibilité (comment l'auteur établit son autorité tôt)
• Promesse de valeur (ce que le lecteur apprendra)

Structure des sections

• Configuration du problème ou du contraste
• Cadre nommé ou prose libre
• Étapes numérotées, méthodes ou argumentation continue
• Exemples et schémas de preuves
• Section bonus ou extension
• Formule de clôture et signature

Philosophie des données

• Chiffres spécifiques par numéro (comptez-les)
• Style d'attribution des sources (lié, nommé, non crédité)
• Rapport exemple/abstraction
• Reconnaissance des limites ou échecs

Formatage

• Utilisation des titres (fréquence, hiérarchie)
• Utilisation des listes (numérotées, à puces, flèches)
• Utilisation du gras et de l'italique
• Formatage des invites, blocs de code ou citations
• Marqueurs visuels (flèches, coches, emojis le cas échéant)

Longueur

• Plage de nombre de mots entre les échantillons
• Nombres de mots par section

Marqueurs vocaux propres au format newsletter

• Conseils de pro ou appels (fréquence, format)
• Clôtures tournées vers l'avenir
• Phrase de signature si cohérente entre les échantillons
• Transparence méta (l'auteur réfléchit-il au processus ou demande-t-il des retours ?)

Signaux d'absence

• Mots, constructions ou structures absents de chaque échantillon
• Mouvements de clôture que l'auteur n'utilise jamais
• Sujets que l'auteur n'aborde jamais

Puis passez à l'Étape 3.

Étape 2b. Sélection d'archétype

Appelez l'outil AskUserQuestion avec une seule question :

[
  {
    "question": "Quel archétype de newsletter correspond à ce que vous voulez écrire ?",
    "header": "Archétype",
    "multiSelect": false,
    "options": [
      {"label": "Tutoriel de données", "description": "Chiffres, cadres, méthodes étape par étape avec invites"},
      {"label": "Essai iconoclaste", "description": "Prenez position, défendez-la, nommez l'opposition"},
      {"label": "Analyse d'étude de cas", "description": "Un sujet par numéro, détaillé en profondeur"},
      {"label": "Digest organisé", "description": "5 à 7 liens avec votre commentaire chaque semaine"},
      {"label": "Essai personnel", "description": "Réflexion sur un thème, récit en premier"},
      {"label": "Interview ou profil", "description": "Une personne par numéro, questions-réponses ou narration"}
    ]
  }
]

Une fois l'archétype choisi, chargez les valeurs par défaut correspondantes depuis references/archetypes.md dans ce dossier de compétence. Ajustez chaque champ en utilisant voice.md et about-me.md avant d'écrire newsletter-voice.md. Signalez dans le fichier de sortie que des valeurs par défaut d'archétype ont été utilisées et que le fichier devrait être revu après 5 numéros publiés.

Étape 3. Écrire newsletter-voice.md

Créez newsletter-voice.md à la racine du projet. Un seul fichier, 800 à 1 200 mots cible. Utilisez cette structure :

# Voix de Newsletter

## Source
[Basé sur échantillons : X numéros de newsletter analysés] OU [Basé sur archétype : [nom de l'archétype] ajusté à voice.md. À revoir après 5 numéros publiés.]

## Audience et objectif
[Qui lit cette newsletter et ce qu'il en retire. Rédigé à partir de about-me.md et voice.md. 2 à 3 phrases.]

## Principes vocaux
[3 à 5 principes fondamentaux que l'écriture respecte toujours. Chacun une courte phrase déclarative. Ajustés à la voice.md de cet utilisateur.]

## Formule d'ouverture
[Comment les numéros commencent. Incluez 2 modèles concrets avec des espaces réservés entre crochets, par exemple "[Résultat spécifique avec chiffre]. [Marqueur de crédibilité]. [Promesse de valeur pour ce numéro]." Nombre de mots cible pour la section d'ouverture.]

## Flux des sections
[Structure standard d'un numéro, section par section, 5 à 8 sections maximum. Brèves notes sur ce que chaque section fait et sa durée.]

## Données et preuves
[Comment les chiffres et exemples sont utilisés. Règles spécifiques, par exemple "toute affirmation nécessite un chiffre", "sources liées en ligne", "rapport exemple/abstraction environ 3:1".]

## Règles de formatage
[Titres, listes, gras, italique, blocs de code, marqueurs visuels. Ce qu'il faut utiliser, ce qu'il faut éviter. Tiré des échantillons ou des valeurs par défaut d'archétype.]

## Conclusion et signature
[Comment les numéros se terminent. Déclaration tournée vers l'avenir versus résumé. Phrase de signature si elle existe de manière cohérente entre les échantillons (n'en inventez pas).]

## Ce que cette newsletter ne fait jamais
[1 court paragraphe ou 3 à 5 éléments. Tiré des motifs d'absence des échantillons ou des valeurs par défaut d'archétype. Comportements uniquement, pas une liste de mots interdits.]

## Longueur
[Nombre de mots cible pour les numéros standards. Cible séparée pour les guides complets plus longs si l'utilisateur écrit les deux formats.]

Remplissez chaque section à partir des échantillons (ou des valeurs par défaut d'archétype ajustées). Pas de remplissage générique. Si les échantillons ne couvrent pas un aspect, dites "aucun motif clair entre les échantillons" plutôt que de deviner.

Étape 4. Confirmer et transmettre

Dites à l'utilisateur :

Votre voix de newsletter est construite. newsletter-voice.md se trouve à la racine de votre projet aux côtés de about-me.md et voice.md. Lorsque vous voulez rédiger un numéro, dites "écris une newsletter" et j'utiliserai les trois fichiers ensemble.

[Si mode archétype : N'oubliez pas que ce fichier a été construit à partir de valeurs par défaut d'archétype. Après environ 5 numéros publiés, relancez cette compétence avec vos vrais échantillons pour un profil plus précis.]

Ce que produit cette compétence

Un fichier à la racine du projet :

• newsletter-voice.md : instructions d'écriture spécifiques à la newsletter couvrant l'audience, les principes vocaux, la formule d'ouverture, le flux des sections, la philosophie des données, le formatage, la conclusion, les motifs d'absence et les objectifs de longueur

Règles

• Exigez voice.md et about-me.md à la racine du projet avant d'exécuter la compétence. Arrêtez-vous et redirigez vers voice-builder si l'un des deux manque.
• Minimum 2 échantillons de newsletter si l'utilisateur choisit le mode basé sur échantillons. Proposez le mode archétype si moins.
• Gardez newsletter-voice.md sous 1 200 mots. La concision prime sur l'exhaustivité.
• N'inventez pas de signaux vocaux. Travaillez uniquement à partir des échantillons ou des valeurs par défaut d'archétype ajustés à voice.md.
• Ne dupliquez pas le contenu de voice.md. Référencez-le lorsque pertinent. newsletter-voice.md ajoute uniquement les règles spécifiques à la newsletter.
• N'intégrez pas les noms spécifiques, URL ou phrases de signature de l'utilisateur sauf s'ils apparaissent de manière cohérente dans au moins 2 échantillons.
• Ne produisez pas de fichier vocal ou de mots interdits séparé. Les motifs d'absence résident dans newsletter-voice.md comme une seule section.
• Anglais britannique partout sauf si les échantillons sont clairement américains.
• N'utilisez jamais de tirets cadratins dans aucun fichier de sortie ou dans aucune ébauche.