launchdarkly-flag-command

Par launchdarkly · agent-skills

Résoudre les requêtes de style `/flag` dans le bon flux de recherche de flag LaunchDarkly. À utiliser lorsque l'utilisateur tape `/flag`, demande à trouver rapidement un flag par nom/clé, souhaite un résumé direct des détails d'un flag, ou a besoin d'une disambiguation rapide entre des flags similaires.

npx skills add https://github.com/launchdarkly/agent-skills --skill launchdarkly-flag-command

Routeur de commande de drapeaux LaunchDarkly

Vous utilisez une skill qui standardise les requêtes rapides /flag. Votre travail consiste à analyser l'intention de l'utilisateur, résoudre le drapeau demandé avec un minimum de friction, retourner un résumé actionnable et router vers des workflows plus profonds si nécessaire.

Limite de périmètre

Cette skill est un point d'entrée de consultation en lecture seule. Elle retourne les détails du drapeau et route vers l'avant.

Contraintes strictes — vous NE DEVEZ PAS :

  • Créer, basculer, mettre à jour ou supprimer des drapeaux
  • Évaluer si un drapeau est sûr à supprimer, obsolète ou prêt pour le nettoyage
  • Fournir un « verdict », une conclusion « sûr à supprimer », des étapes de suppression ou des conseils « avant de supprimer »
  • Proposer d'archiver ou supprimer le drapeau

Quand l'utilisateur demande à propos de la suppression ou de l'obsolescence, votre réponse entière pour cette partie doit être le tableau de résumé du drapeau suivi de ce message de routing exact (vous pouvez reformuler légèrement mais devez conserver la substance) :

Cette consultation rapide ne peut vous montrer que la config actuelle du drapeau. Pour évaluer s'il est sûr à supprimer, vous avez besoin de la skill flag discovery ou flag cleanup — elles scannent les références de code, vérifient le statut dans tous les environnements et analysent les dépendances en aval.

C'est tout. Pas d'analyse. Pas de puces. Pas de verdict. La question de suppression est répondue par le message de routing, pas par vous.

Prérequis

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

Outils MCP requis :

  • list-flags — rechercher et lever l'ambiguïté sur les candidats drapeaux
  • get-flag — récupérer la configuration détaillée d'un drapeau résolu

Outils MCP optionnels :

  • get-flag-status-across-envs — comparer le statut du cycle de vie entre environnements
  • get-flag-health — aperçu rapide de la santé pour un seul drapeau

Contrat de commande

Traitez ces formes comme des intents équivalentes :

  • /flag <requête>
  • flag <requête>
  • "find flag <requête>"
  • "show me <requête> flag"

Utilisez production comme environnement par défaut sauf si l'utilisateur en spécifie un autre.

Workflow

Étape 1 : Analyser et normaliser l'entrée

  1. Extraire le texte de requête après /flag.
  2. Si aucune requête n'est fournie, demander un identifiant concis (clé de drapeau, fragment de nom ou tag).
  3. Capturer les indices optionnels de la requête :
    • Environnement (staging, production, etc.)
    • Clé de projet
    • Préférence pour clé exacte vs recherche floue

Étape 2 : Résoudre le drapeau

Utiliser list-flags d'abord sauf si l'utilisateur a clairement fourni une clé exacte et un projet.

  1. Rechercher avec list-flags en utilisant la requête.
  2. Si une correspondance exacte claire existe, résoudre à ce drapeau.
  3. Si plusieurs correspondances plausibles existent, retourner une courte liste de désambiguïsation (clé + nom + état) et demander à l'utilisateur de choisir.
  4. Si aucune correspondance n'existe, dire à l'utilisateur et suggérer une requête plus large.

Étape 3 : Retourner un résumé utile

Pour un drapeau résolu, appeler get-flag et retourner :

  1. Clé et nom du drapeau
  2. État de l'environnement (on/off)
  3. Variation off et comportement fallthrough
  4. Complexité des règles/cibles (simple vs complexe)
  5. URL LaunchDarkly directe pour le drapeau (quand le projet + clé sont connus)

Si l'utilisateur a demandé à propos de la suppression, de l'obsolescence ou du nettoyage (ex : "est-ce sûr à supprimer?", "puis-je nettoyer ceci?", "est-ce obsolète?") :

Afficher UNIQUEMENT le tableau de résumé ci-dessus, puis écrire :

Cette consultation rapide ne peut vous montrer que la config actuelle du drapeau. Pour évaluer s'il est sûr à supprimer, vous avez besoin de la skill flag discovery ou flag cleanup — elles scannent les références de code, vérifient le statut dans tous les environnements et analysent les dépendances en aval.

N'ajoutez pas de verdict, d'analyse par puces, d'étapes de suppression, de checklist « avant de supprimer » ou d'offre d'archivage/suppression. La question de suppression est complètement répondue par le message de routing ci-dessus. Procéder à l'étape 4.

Étape 4 : Router vers le bon workflow de suivi

Après le retour du résumé, vérifier si la requête de l'utilisateur implique un workflow plus profond. Si c'est le cas, nommer la skill et arrêter — n'essayez pas le workflow vous-même.

Intent utilisateur Router vers
Créer ou modifier un drapeau flag create skill
Modifier le targeting ou le rollout flag targeting skill
« Est-ce sûr à supprimer? », « Est-ce obsolète? », nettoyage flag discovery / flag cleanup

Pour les questions de suppression/obsolescence spécifiquement : suivre les instructions de limite de périmètre ci-dessus — tableau de résumé uniquement, puis router. Pas de verdict.

Style de sortie

Gardez les réponses /flag brèves et opérationnelles :

  • Commencer par le drapeau résolu (ou liste de désambiguïsation)
  • Inclure seulement les détails de config minimum nécessaires pour l'action suivante
  • Terminer par une question de prochaine étape claire quand l'intent utilisateur est ambigu

Contexte important

  • /flag est un point d'entrée rapide, pas un workflow de cycle de vie complet.
  • Préférer la désambiguïsation à la devinette quand plusieurs drapeaux correspondent.
  • Traiter le projet + environnement comme contexte de première classe ; éviter les hypothèses cachées.
  • Quand partager les pourcentages de rollout, toujours utiliser des pourcentages lisibles pour l'humain.
  • Ne jamais improviser l'analyse de suppression, d'obsolescence ou de nettoyage. Toujours router vers la skill dédiée.

Skills similaires