guideline-generation

Par anthropics · knowledge-work-plugins

Cette compétence génère, crée ou élabore des directives de voix de marque à partir de matériaux sources. Elle doit être utilisée lorsque l'utilisateur demande à « générer des directives de marque », « créer un guide de style », « extraire la voix de la marque », « créer des directives à partir d'appels », « consolider des matériaux de marque », « analyser mes appels commerciaux pour la voix de marque », « construire un playbook de marque à partir de documents », « synthétiser un guide de voix et de ton », ou télécharge des documents de marque, des transcriptions ou des enregistrements de réunions pour une analyse de marque. Se déclenche également lorsque l'utilisateur dispose d'un rapport de découverte et souhaite le convertir en directives exploitables.

npx skills add https://github.com/anthropics/knowledge-work-plugins --skill guideline-generation

Génération de directives de marque

Générez des directives complètes de voix de marque prêtes pour LLM à partir de n'importe quelle combinaison de sources — documents de marque, transcriptions d'appels commerciaux, rapports de découverte ou entrées directes de l'utilisateur. Transformez les matériaux bruts en directives structurées et applicables avec scoring de confiance et questions ouvertes.

Entrées

Acceptez n'importe quelle combinaison de :

  • Rapport de découverte issu de la skill discover-brand (structuré, pré-trié)
  • Documents de marque uploadés ou provenant de plateformes connectées (PDF, PPTX, DOCX, MD, TXT)
  • Transcriptions de conversations de Gong, Granola, uploads manuels ou notes de réunions Notion
  • Entrée directe de l'utilisateur sur sa voix de marque et ses valeurs

Quand un rapport de découverte est fourni, utilisez-le comme entrée principale — les sources sont déjà triées et classées. Complétez par une analyse supplémentaire si nécessaire.

Workflow de génération

1. Identifier et classer les sources

Déterminez ce que l'utilisateur a fourni. Si aucune source n'est disponible :

  • Vérifiez si un rapport de découverte existe d'une exécution antérieure de /brand-voice:discover-brand
  • Vérifiez .claude/brand-voice.local.md pour connaître les emplacements de matériaux de marque
  • Suggérez d'exécuter d'abord la découverte : /brand-voice:discover-brand

2. Traiter les sources

Pour les documents : Déléguez à l'agent d'analyse de documents pour un parsing complet. Extrayez les attributs de voix, les thèmes de messaging, la terminologie, la guidance de ton et les exemples.

Pour les transcriptions : Déléguez à l'agent d'analyse de conversation pour la reconnaissance de motifs. Extrayez les attributs de voix implicites, les motifs de langage réussis, le ton par contexte et les anti-motifs.

Pour les rapports de découverte : Extrayez les sources pré-triées, les conflits et les lacunes. Utilisez directement les sources classées.

3. Synthétiser en directives

Fusionnez tous les résultats dans un document de directive unifié suivant le template dans references/guideline-template.md. Sections clés :

Tableau « We Are / We Are Not » — L'ancre identitaire de marque centrale :

We Are We Are Not
[Attribut — p. ex., « Confiant »] [Contre — p. ex., « Arrogant »]
[Attribut — p. ex., « Accessible »] [Contre — p. ex., « Désinvolte ou négligé »]

Dérivez les attributs des motifs les plus cohérents dans toutes les sources. Chaque ligne doit avoir une preuve à l'appui.

Voice Constants vs. Tone Flexes — Clarifiez ce qui reste fixe et ce qui s'adapte :

  • Voice = personnalité, valeurs, « We Are / We Are Not » — constant dans tout contenu
  • Tone = formalité, énergie, profondeur technique — flexes par contexte

Matrice Tone-by-Context :

Contexte Formalité Énergie Profondeur technique Exemple
Prospection à froid Moyen Élevé Faible « [exemple de phrase] »
Proposition entreprise Élevé Moyen Élevé « [exemple de phrase] »
Réseaux sociaux Faible Élevé Faible « [exemple de phrase] »

4. Assigner des scores de confiance

Notez chaque section en utilisant la méthodologie dans references/confidence-scoring.md :

  • Confiance élevée : 3+ sources corroborantes, guidance explicite trouvée
  • Confiance moyenne : 1-2 sources, ou déduite de motifs
  • Confiance faible : source unique, déduite ou données conflictuelles

5. Surfacer les questions ouvertes

Générez des questions ouvertes pour toute ambiguïté qui ne peut pas être résolue :

## Questions ouvertes pour discussion d'équipe

### Priorité élevée (bloque l'achèvement des directives)
1. **[Titre de la question]**
   - Ce qui a été trouvé : [info conflictuelle ou incomplète]
   - Recommandation de l'agent : [résolution suggérée avec raisonnement]
   - Besoin de votre part : [décision spécifique ou confirmation requise]

Chaque question ouverte DOIT inclure une recommandation de l'agent. Transformez l'ambiguïté en « confirmer ou dépasser » — jamais une impasse.

6. Contrôle qualité

Avant présentation, vérifiez via l'agent d'assurance qualité (défini dans agents/quality-assurance.md) :

  • Toutes les sections majeures remplies (y compris Brand Personality et Content Examples si les sources les soutiennent)
  • Au moins 3 attributs de voix avec preuve
  • Tableau « We Are / We Are Not » avec 4+ lignes
  • Matrice de ton couvre au moins 3 contextes
  • Scores de confiance assignés par section
  • Attribution de source pour tous les éléments extraits
  • Aucune PII exposée
  • Questions ouvertes incluent des recommandations

7. Présenter et offrir les prochaines étapes

Résumez les conclusions clés :

  • Nombre total de sections générées avec décomposition de confiance
  • Attribut de voix le plus fort et message le plus efficace
  • Nombre de questions ouvertes (le cas échéant)

8. Enregistrer pour les sessions futures

L'emplacement d'enregistrement par défaut est .claude/brand-voice-guidelines.md dans le dossier de travail de l'utilisateur.

Important : Le répertoire de travail de l'agent peut ne pas être la racine du projet utilisateur (particulièrement dans Cowork, où les plugins s'exécutent à partir d'un répertoire de cache de plugin). Résolvez toujours le chemin par rapport au dossier de travail de l'utilisateur, pas au répertoire courant. Si aucun dossier de travail n'est défini, passez l'enregistrement de fichier et dites à l'utilisateur que les directives seront uniquement disponibles dans cette conversation.

  1. Résolvez le chemin d'enregistrement. Le fichier DOIT être enregistré à .claude/brand-voice-guidelines.md dans le dossier de travail de l'utilisateur. Confirmez le chemin du dossier de travail avant d'écrire.
  2. Vérifiez si les directives existent déjà à ce chemin
  3. Si elles existent, archivez la version précédente : Renommez le fichier existant à brand-voice-guidelines-YYYY-MM-DD.md dans le même répertoire (en utilisant la date d'aujourd'hui)
  4. Enregistrez les nouvelles directives à .claude/brand-voice-guidelines.md dans le dossier de travail
  5. Confirmez à l'utilisateur avec le chemin absolu complet : « Directives enregistrées à <chemin-complet>. /brand-voice:enforce-voice les trouvera automatiquement dans les sessions futures. »

Les directives sont aussi présentes dans cette conversation, donc /brand-voice:enforce-voice peut les utiliser immédiatement sans charger depuis le fichier.

Après enregistrement, proposez :

  1. Parcourir les directives section par section
  2. Commencer à créer du contenu avec /brand-voice:enforce-voice
  3. Résoudre les questions ouvertes

Confidentialité et sécurité

Appliquez ces contraintes de confidentialité dans tout le workflow de génération, pas seulement au moment de la sortie :

  • Masquez les noms de clients et les informations de contact de tous les exemples
  • Anonymisez les noms d'entreprises dans les extraits de transcription si demandé
  • Signalisez toute information sensible détectée lors du traitement

Fichiers de référence

  • references/guideline-template.md — Template de sortie complet avec toutes les sections, définitions de champs et guidance de formatage
  • references/confidence-scoring.md — Méthodologie de scoring de confiance, seuils et exemples

Skills similaires