ooligo
claude-skill

Narrative de prévision depuis Salesforce + Gong

Difficulty
intermédiaire
Setup time
45min
For
revops
RevOps

Stack

Un Claude Skill qui transforme la réalité désordonnée des données de pipeline en une narrative de prévision d’une page pour l’appel de prévision hebdomadaire. L’output est le document que le VP Ventes / DRV lit dans les trente minutes avant l’appel en direct : un chiffre titre avec une fourchette de confiance, les trois principales affaires faisant bouger le chiffre, le risque unique le plus important, et une demande à la direction.

Le Skill lit Salesforce comme source de vérité sur l’état du pipeline et Gong comme vérification de ce que les commerciaux disent par rapport à ce que les clients ont réellement dit. Il combat deux modes d’échec spécifiques que les équipes RevOps rencontrent chaque semaine : des affaires en commit portées par l’espoir plutôt que par des preuves, et des briefs exécutifs rédigés dans un langage si édulcoré que le dirigeant arrête de les lire.

Quand l’utiliser

Utilisez le Skill sur une cadence récurrente — une fois par semaine par segment de prévision, posté dans le canal Slack de prévision environ trente minutes avant l’appel en direct. L’objectif est de donner aux dirigeants le temps de le lire à froid, d’entrer avec des questions plus précises, et de raccourcir l’appel.

Il est rentable quand :

  • Vos segments de prévision comptent au moins dix affaires en commit actif chaque semaine. En dessous, la valeur marginale par rapport à un brief rédigé manuellement diminue.
  • Vos commerciaux journalisent les appels Gong de manière fiable. Si l’activité Gong est inégale, la section risques du Skill devient du bruit.
  • La discipline des étapes et des dates de clôture Salesforce est raisonnable. Le Skill ne peut pas corriger de mauvaises données ; il les rend plus visibles, ce qui est utile mais pas ce que la plupart des équipes attendent d’un « outil de prévision ».

Quand NE PAS l’utiliser

Trois situations où l’output du Skill est le mauvais artifact :

  • Supports pour le conseil d’administration sans revue du CFO. La narrative est un artifact RevOps interne réconcilié avec Salesforce, pas avec le grand livre des réservations de la finance. Les chiffres présentés au conseil doivent passer par la finance sous la politique de contrôle. Le Skill refuse explicitement de produire un output formaté pour le conseil.
  • Communications soumises à divulgation financière (10-Q, 10-K, préparation des résultats, mises à jour aux investisseurs, guidances publiques, tout ce que le juridique verra). Utilisez le processus de la finance ; ne collez pas cette narrative dans tout document déposé en externe.
  • Rétablir le commit officiel. Cette narrative explique le commit que le responsable de segment a déjà fixé. Elle ne remplace pas la réunion de fixation du commit elle-même. Si vous vous retrouvez à utiliser le Skill pour découvrir quel devrait être le commit, vous avez deux problèmes et ce Skill n’en résout aucun.

Configuration

Le bundle se trouve dans apps/web/public/artifacts/forecast-narrative-skill/. Il contient :

  1. SKILL.md — à installer dans ~/.claude/skills/forecast-narrative/SKILL.md. Définissez SFDC_TOKEN, GONG_API_KEY dans votre environnement.
  2. references/1-narrative-structure.md — le modèle de section et les règles par section. Modifiez les noms de rubriques si votre dirigeant cherche des libellés différents, mais conservez le nombre de sections : chaque section existe parce que la supprimer a créé une confusion lors des appels passés.
  3. references/2-hedge-words-blocklist.md — l’input du pass de suppression des formulations édulcorées. Modifiez selon le ton de votre entreprise ; étendez-le chaque fois qu’un mot édulcoré survit à une vraie exécution. La liste de blocage est l’artifact durable — pas le prompt.
  4. references/3-sample-output.md — un exemple travaillé avec la checklist de révision. Exécutez d’abord une invocation du Skill sur un segment connu et comparez avec ceci ; si la structure ne correspond pas, corrigez le prompt avant de le livrer au dirigeant.

Configurez vos segments de prévision dans references/segment-config.md — une ligne par segment avec l’ID de rapport Salesforce, l’ID d’espace de travail Gong et le nom du responsable de segment (pour que la ligne « Demande au VP/DRV » se résolve automatiquement). Les snapshots atterrissent dans snapshots/<segment>/<week_ending>.json et sont vérifiés par version à chaque exécution ; si le nombre de lignes du fichier ne correspond pas au nombre de lignes attendu du rapport, le Skill s’interrompt avant de calculer les deltas.

Invoquez chaque semaine avec le slug de segment et la date de fin de semaine : build_forecast_narrative(segment="enterprise-amer", week_ending="2026-05-01").

Ce que le Skill fait réellement

Six étapes, exécutées dans l’ordre. Elles sont séquentielles par conception — chaque étape après la première dépend du snapshot, et le pass de suppression des formulations édulcorées dépend de l’existence du draft complet.

  1. Snapshot Salesforce à l’heure de coupure. Extrayez le rapport sauvegardé au timestamp de fin de semaine. Persistez sur disque pour que la prochaine exécution ait un vrai snapshot de la semaine précédente comme référence pour le diff. Différencier par rapport à l’état Salesforce en direct plutôt qu’un snapshot stocké perd la piste d’audit.
  2. Calculez les deltas. Faites remonter chaque opportunité qui a changé de catégorie de prévision, dont la date de clôture a glissé de plus de 14 jours, dont le montant a changé de plus de 10 %, ou qui a été créée ou supprimée du segment.
  3. Extrayez les preuves Gong par affaire en commit. Pour chaque affaire en commit, interrogez Gong sur l’activité côté client dans les 14 derniers jours. C’est la partie qui rend le Skill différent de « résumer Salesforce en joli Markdown » — la combinaison des deux systèmes attrape les affaires maintenues en commit par espoir, que Salesforce seul ne peut pas voir.
  4. Classez les moteurs. Scorez par abs(amount_change) × close_date_proximity. Prenez les trois premiers. Plafond ferme à trois car la narrative est pour le dirigeant, pas pour une inspection.
  5. Identifiez le risque unique le plus important. Dans l’ensemble des commits, choisissez une affaire où Gong est silencieux depuis quatorze jours ou plus, dont la date de clôture a glissé deux fois en 60 jours, ou qui a été ajoutée au commit dans les 7 derniers jours sans appel client correspondant. Choisissez-en une. Une liste de cinq risques est lue comme aucun risque.
  6. Pass de suppression des formulations édulcorées. Générez le draft en suivant references/1-narrative-structure.md. Ensuite, exécutez un second pass qui scanne contre references/2-hedge-words-blocklist.md et réécrit chaque formulation signalée en affirmation directe ou en aveu de « ne sait pas ». La raison des deux passes plutôt que d’une seule invite en amont : les modèles de langage dérivent vers les formulations édulcorées plus la sortie est longue, et un pass de suppression dédié attrape de manière fiable ce qu’un prompt à passe unique manque.

Le choix d’utiliser un format de narrative structuré — ordre fixe des sections, rubriques fixes, forme de raisonnement fixe — plutôt que de la prose libre est délibéré. L’output libre dérive dans sa structure de semaine en semaine, ce qui oblige le dirigeant à se réorienter à chaque lecture. La structure fixe signifie que le dirigeant scanne les mêmes cinq emplacements chaque semaine et arrive aux mêmes types d’informations aux mêmes endroits. La prévisibilité est la fonctionnalité.

Réalité des coûts

Une seule narrative de segment consomme environ 18 000-24 000 tokens d’entrée (le snapshot, le snapshot précédent, les lignes d’activité Gong, les trois fichiers de référence) et produit environ 1 200-1 800 tokens de sortie, y compris le pass de suppression des formulations édulcorées. Au tarif affiché de Sonnet 4.6, c’est de l’ordre de 0,07-0,11 $ par narrative. Avec Opus 4.7, prévoyez 0,35-0,55 $. Exécutez sur Sonnet pour la cadence hebdomadaire et réservez Opus pour la fin de trimestre quand les enjeux justifient la dépense.

Temps économisé par rapport à un brief rédigé manuellement : un analyste RevOps senior prend 60-90 minutes par segment par semaine pour assembler le même artifact depuis des rapports Salesforce bruts et des notes Gong. Sur quatre segments, c’est environ une demi-journée par semaine récupérée. Le Skill prend 90-120 secondes par segment à exécuter, plus 5-10 minutes de revue humaine avant de poster dans Slack.

La contrainte honnête : le temps économisé disparaît entièrement si l’étape de revue humaine est sautée. Les réviseurs attrapent les spécificités hallucinées que ce Skill ne peut pas éliminer ; sans cette étape, la réalité des coûts se retourne et le Skill devient un passif. Budgétez explicitement le temps de revue.

Métriques de succès

Suivez un seul chiffre : durée des appels de prévision sur une fenêtre glissante de six semaines. Si le brief fait son travail, les dirigeants entrent pré-lus et l’appel se raccourcit de 15-25 %. La narrative remplace la partie « qu’est-ce qui a changé cette semaine » de l’appel, qui est la partie qui s’adapte le moins bien à la croissance du volume d’affaires.

Métriques secondaires à suivre après le premier mois :

  • Précision de dépassement/manquement du chiffre titre par rapport aux réels à la clôture de période (cible : dans les 500 000 $ sur les segments au-dessus de 10M$ de commit).
  • Nombre de corrections « c’est faux » des responsables de segment par semaine (cible : tendant vers zéro à la semaine six).
  • Si l’affaire « risque unique le plus important » a effectivement glissé — les faux positifs sont tolérables, mais un pattern de faux négatifs (affaires glissées qui n’ont pas été signalées) signifie que les heuristiques de risque à l’étape 5 du Skill ont besoin d’ajustement.

Alternatives

  • Clari Narrative. Clari produit un artifact similaire nativement si vous êtes déjà sur Clari. Le Skill gagne quand (a) vous n’êtes pas sur Clari et votre outil de prévision de référence est Salesforce + Gong + feuilles de calcul, ou (b) vous êtes sur Clari mais voulez étendre la narrative avec un raisonnement spécifique à l’entreprise que le modèle Clari ne peut pas exprimer. Clari gagne sur le déploiement out-of-the-box et sur des hooks Salesforce plus solides.
  • Gong Forecast Notes. Les fonctionnalités de prévision de Gong s’appuient fortement sur le signal côté appels et sont plus faibles sur le raisonnement d’état du pipeline. Le Skill relie explicitement l’état côté Salesforce avec les preuves côté Gong ; Gong Forecast Notes fait l’inverse et traite le pipeline comme un complément. Choisissez ce Skill quand Salesforce est la source de vérité et Gong est la couche de vérification.
  • Brief exécutif rédigé manuellement. Un analyste RevOps senior produit encore la meilleure narrative — le Skill est au mieux à 80 % de cet output, et ce 80 % porte sur la structure factuelle, pas sur les jugements concernant quelles affaires faire remonter. Le Skill gagne sur la cohérence, la cadence et la demi-journée par semaine qu’il rend à l’analyste. L’analyste doit réviser et modifier chaque exécution ; c’est un outil de co-auteur, pas un remplacement.

Points de vigilance

  • Hallucinations à consonance confiante sur les spécificités des affaires. Le modèle peut inventer une étape d’achat, un nom de partie prenante ou une valeur contractuelle qui semble plausible. Protection : chaque affirmation sur une affaire spécifique doit être tracée vers un champ Salesforce ou un résumé d’appel Gong dans les données sources. Le Skill libelle toute affirmation inférée-non-observée avec (inferred) ou l’omet. Si une affirmation spécifique confiante apparaît sans citation de source, traitez l’exécution comme échouée et relancez avec un ensemble d’affaires plus petit.
  • Formulations édulcorées qui glissent malgré le pass de suppression. « Pourrait », « potentiellement », « semble » reviennent, surtout dans la section risques. Protection : étendez references/2-hedge-words-blocklist.md chaque fois qu’un nouveau mot édulcoré survit à un pass. La liste de blocage est l’artifact durable ; le prompt ne l’est pas. RevOps possède ce fichier.
  • Le résumé cité comme la prévision réelle. La narrative explique le commit ; elle ne le fixe pas. Protection : le titre cite le chiffre de commit du responsable de segment, jamais un chiffre calculé par le Skill seul. Si current_commit n’a pas été passé en entrée, le Skill libelle sa plage calculée comme « plage de couverture de pipeline calculée par le Skill, pas un commit approuvé » pour que le document ne puisse pas être mal interprété comme le chiffre officiel.
  • Dérive de snapshot. Si snapshots/<segment>/<week_ending>.json a été écrit depuis un rapport partiellement chargé (timeout Salesforce en cours d’extraction, par exemple), les deltas de la prochaine exécution seront faux de manière invisible. Protection : la première ligne du fichier snapshot enregistre le nombre de lignes attendu vs reçu ; s’ils divergent, le Skill s’interrompt et demande à l’opérateur de refaire le snapshot avant de continuer.
  • Discipline des étapes. Si les commerciaux font avancer des affaires en commit sans que le travail soit fait, aucun Skill ne corrige ça. La narrative rapportera fidèlement ce que dit Salesforce. Associez ce Skill à un workflow de validateur de progression des étapes en amont.

Stack

  • Salesforce — état du pipeline, historique des étapes, montants des affaires, le rapport sauvegardé qui définit chaque segment.
  • Gong — signal d’activité côté client et résumés d’appels utilisés comme vérification de la narrative du commercial.
  • Claude — synthèse narrative, classement et pass de suppression des formulations édulcorées. Sonnet pour la cadence hebdomadaire ; Opus pour la fin de trimestre quand les enjeux le justifient.

Files in this artifact

Download all (.zip)