Snippets de Prompt de Configuration

Vous utilisez une skill qui vous guidera dans la création et la gestion des snippets de prompt dans LaunchDarkly. Votre travail consiste à identifier le texte réutilisable, créer des snippets, les référencer dans les variations de config, et vérifier que tout est correctement connecté.

Prérequis

Cette skill nécessite que le serveur MCP LaunchDarkly hébergé à distance soit configuré dans votre environnement.

Outils MCP requis :

create-prompt-snippet -- créer un nouveau bloc de texte réutilisable
list-prompt-snippets -- parcourir les snippets existants du projet
get-prompt-snippet -- inspecter le contenu d'un snippet spécifique

Outils MCP optionnels :

update-prompt-snippet -- modifier le texte, le nom ou les tags d'un snippet
delete-prompt-snippet -- supprimer définitivement un snippet
update-ai-config-variation -- mettre à jour les prompts de variation pour référencer des snippets

Concepts Fondamentaux

Qu'est-ce que les Snippets de Prompt ?

Les snippets de prompt sont des blocs de texte nommés et versionnés stockés au niveau du projet. Ils contiennent des pièces réutilisables de texte de prompt — personas, garde-fous, instructions de format de sortie, connaissance métier — qui peuvent être partagées entre plusieurs variations de config.

Quand un snippet est mis à jour, une nouvelle version est créée. Les variations de config qui référencent le snippet peuvent utiliser la dernière version, maintenant tous vos configs synchronisés.

Quand Utiliser les Snippets

Scénario	Exemple
Persona partagée	« Vous êtes un agent de support client utile pour Acme Corp… » utilisé par 5 configs différentes
Garde-fous de sécurité	« Ne révélez jamais les tarifs internes. Ne générez jamais de code accédant aux bases de données de production. »
Format de sortie	« Répondez toujours en JSON avec les clés : answer, confidence, sources. »
Connaissance métier	Terminologie spécifique à l'entreprise, noms de produits ou descriptions de processus
Texte réglementaire	Avertissements de conformité qui doivent figurer dans chaque réponse

Quand NE PAS Utiliser les Snippets

Texte unique à une seule variation — mettez-le directement dans le prompt
Contenu dynamique qui change par requête — utilisez plutôt des variables de template
Prompts complets — les snippets sont des briques, pas des prompts complets

Principes Fondamentaux

Réutilisabilité d'abord : Créez un snippet uniquement si le texte sera utilisé dans 2 endroits ou plus
Responsabilité Unique : Chaque snippet doit couvrir une seule préoccupation (persona OU garde-fous, pas les deux)
Clés Descriptives : Utilisez des clés comme safety-guardrails, json-output-format, support-persona
Taggez pour la Découverte : Ajoutez des tags pour que vos collègues trouvent les snippets par catégorie
Vérifiez les Références : Après créer un snippet, confirmez qu'il apparaît dans le projet

Flux de Travail

Étape 1 : Identifier le Texte Réutilisable

Avant de créer des snippets, comprenez ce qui est partagé :

Listez les configs existantes du projet en utilisant get-ai-config pour chacune
Cherchez du texte répété entre les prompts de variation
Identifiez le texte qui doit rester cohérent (garde-fous, personas, formats)
Vérifiez les snippets existants avec list-prompt-snippets pour éviter les doublons

Étape 2 : Créer des Snippets

Utilisez create-prompt-snippet avec :

key -- identifiant unique (minuscules, tirets, ex. safety-guardrails)
name -- nom d'affichage lisible
text -- le contenu du texte de prompt réutilisable
description (optionnel) -- expliquez quand/pourquoi utiliser ce snippet
tags (optionnel) -- catégorisez pour la découverte (ex. ["guardrails", "safety"])

{
  "projectKey": "my-project",
  "key": "support-persona",
  "name": "Customer Support Persona",
  "text": "You are a friendly, knowledgeable customer support agent for Acme Corp. Always greet the customer by name when available. Be empathetic but concise. If you don't know the answer, say so honestly and offer to escalate.",
  "description": "Standard persona for all customer-facing support configs",
  "tags": ["persona", "support"]
}

Étape 3 : Vérifier

Utilisez get-prompt-snippet pour confirmer que le snippet a été créé avec le texte correct
Utilisez list-prompt-snippets pour le voir dans la liste du projet
Vérifiez que la version est 1 pour les snippets nouvellement créés

Rapportez les résultats :

Snippet créé avec clé, nom et texte
Numéro de version confirmé
Tags appliqués correctement

Étape 4 : Mettre à Jour les Snippets (Au Besoin)

Utilisez update-prompt-snippet pour modifier un snippet existant. Passez uniquement les champs que vous voulez modifier :

{
  "projectKey": "my-project",
  "snippetKey": "safety-guardrails",
  "text": "Updated guardrail text with new compliance requirements..."
}

Chaque mise à jour crée une nouvelle version. Les variations de config existantes référençant le snippet peuvent utiliser la nouvelle version.

Cas Limites

Situation	Action
Clé de snippet déjà existante	Utilisez `get-prompt-snippet` pour vérifier, puis mettez à jour ou choisissez une clé différente
Texte très long	Les snippets peuvent contenir de grands blocs — mais considérez les diviser en plusieurs snippets pour la modularité
Snippet référencé par des configs	Mettez à jour avec prudence — les changements se propagent à toutes les configs référençantes
Suppression d'un snippet référencé	Avertissez l'utilisateur que les configs perdront la référence. Utilisez `delete-prompt-snippet` avec `confirm: true`

Ce qu'il NE FAUT PAS Faire

Ne créez pas de snippets pour du texte utilisé dans un seul endroit
Ne mettez pas un prompt complet dans un seul snippet — divisez-le en pièces ciblées
Ne supprimez pas les snippets sans vérifier quelles configs les référencent
Ne dupliquez pas les snippets existants — vérifiez d'abord avec list-prompt-snippets