ooligo
claude-skill

Salesforce + Gong + Claudeを使ったQBR準備

Difficulty
中級
Setup time
45min
For
revops · csm
RevOps

Stack

顧客アカウントと四半期を入力として受け取り、70%完成のQBRドラフトを生成するClaude スキルです。成功プランに紐付けた使用傾向、SalesforceとGongから取得した四半期の主な成果、オープンリスクテーブル、成功プランの進捗状況、拡張パスのランキングリストを含みます。CSMは空白のGoogle Slidesテンプレートから、チームのデッキ組み立てスクリプトが5分でインジェクトできるスロットマップ済みMarkdownへと移行できます。アーティファクトバンドルにはSKILL.mdとCSMチームが一度カスタマイズして全アカウントで再利用できる3つの参照ファイルが含まれています。

使用すべきタイミング

単一の指名アカウント向けにQBRデッキドラフトを準備しているCSM(またはCSMをサポートするRevOpsリード)であり、空白のテンプレートではなく編集可能な出発点が欲しい場合に使用します。このスキルは、Salesforceのアカウント履歴、四半期のSalesforceケース、過去90日のGongコール テーマ、アクティブな成功プランドキュメントという4つのデータストリームを統合し、チームの言葉遣いで指定されたプレースホルダースロットを埋めたデッキを作成するワークフロー向けに設計されています。

使用データが適度に整理されており、成功プランが最新の状態に保たれており、デッキ組み立てスクリプトがコンテンツをスロットに分割できる安定した名前付きスロットがQBRテンプレートにある場合に効果的に機能します。四半期中に少なくとも3回のGongコールがあり、過去60日以内に更新された成功プランを持つアカウントに対して最も有用なアウトプットを生成します。それ以外の場合、スキルは自信を持って誤ったドラフトを生成するのではなく、ギャップを明示的にフラグします。

使用すべきでないタイミング

CSMレビューなしにQBRデッキを自動公開するためにこのスキルを使用しないでください。スキルはドラフトエンジンです。すべてのデッキは顧客に届く前に人間のレビューを経ます。担当AE/CSMがフレーミングを承認していない顧客向けデッキには向けないでください。スキルはナラティブの種を蒔くものですが、AE/担当CSMがナラティブを所有します。

使用データが30日未満のアカウント、四半期中にGongコールが記録されていないアカウント、または60日以上更新されていない成功プランに対しては使用しないでください。スキルはギャップを検出して拒否するように設計されていますが、拒否を尊重する場合に限ります。ギャップの警告を無視すると、見た目は問題ないが顧客を誤解させるデッキが生成されます。

更新予測や解約予測には使用しないでください。該当するルーブリックはchurn-risk-summarizerスキルにあり、リテンションスコアリング向けにキャリブレーションされています。このスキルはデッキコンテンツ向けにキャリブレーションされており、リスクテーブルを解約シグナルとして読むと誤解を招きます。

非顧客向けレビュー(取締役会向け報告、社内QBR、ディールレビュー)には使用しないでください。スロットマップとトーンマッチのパスは外部向け聴衆を想定しています。

セットアップ

初回は約45分かかります。主にQBRテンプレートの名前付きスロットをスキルの期待するスロット語彙にマッピングする作業です。

  1. スキルをインストールします。 apps/web/public/artifacts/qbr-prep-skill/ からバンドルを ~/.claude/skills/qbr-prep/ にドロップします。スキルは単一のコマンド prep_qbr(account_id, quarter) と、Salesforce、Gong、成功プランの解析、3パスClaude パイプライン用の内部ヘルパーを定義します。
  2. 認証情報を設定します。 SFDC_TOKEN(Account、Opportunity、Caseへの読み取りアクセス)、GONG_API_KEY(コールとトランスクリプトへの読み取りアクセス)、GOOGLE_SLIDES_TOKEN またはローカルPPTXテンプレートへのパスを設定します。USAGE_WAREHOUSE_VIEW をチームが使用するBigQueryビューまたはCSVパスに設定します。スキルはCSVヘッダーを references/1-qbr-template-slots.md のスキーマに対して検証し、カラムが変更された場合は使用傾向の入力を拒否します。
  3. テンプレートファイルを適合させます。 references/1-qbr-template-slots.md を開き、スロットマニフェストをチームの実際のデッキの名前付きプレースホルダーに置き換えます。references/2-success-plan-format.md を開き、そのスキーマをCSMチーム全体で採用するか、既存のチームフォーマットに置き換えます。どちらのパスを選んでも、スキルが解析するための安定した形式が必要です。references/3-sample-output.md の作業例を、CSMチームの3〜5件の匿名化された過去QBRに置き換えます。これによりトーンマッチパスに実際の素材が提供されます。
  4. 成功プランのストレージをマッピングします。 Notion、Salesforceカスタムオブジェクト、Gainsight CTAのいずれかを選択し、それを維持します。スキルの success_plan_ref リゾルバーはアカウントごとに単一の標準ストレージロケーションを想定しています。混合ストレージは「スキルがプランが見つからないと言うが実際には存在する」という最も一般的な原因です。
  5. 1つのアカウントで実行します。 prep_qbr(account_id="0014x...XYZ", quarter="Q1-2026", last_qbr_path="...", success_plan_ref="...")。スキルはスロットごとに1つのフェンスブロックを持つMarkdownファイルと、別ファイルとして1ページのエグゼクティブサマリーを生成します。スロットファイルをチームのデッキ組み立てスクリプトに通すか、最初の実行では手動で貼り付けます。

スキルの動作

スキルは独立したシステムにアクセスし、ボトルネックがClaude トークンではなくAPIレイテンシーであるため、4つのデータストリームを並行して取得します。Salesforceのアカウント履歴にはARRの推移、拡張・縮小、更新日が含まれます。Salesforceのケースには前四半期比のチケット件数、重大度の内訳、中央値の解決時間が含まれます。Gongには過去90日のコールテーマ、エグゼクティブの発言、競合他社への言及が含まれます。成功プランドキュメントには、スライドコンテンツが報告すべき目標が含まれます。いずれかのストリームが空またはエラーを返した場合、スキルはそのストリームの値として unavailable を記録します。出力テンプレートはストリームが欠落している場合にも明示的に対応しています。

次に3つのClaudeパスを実行します。パス1は統合です:Claude は4つのストリームと前回のQBRを読み取り、成功プランの目標に紐付けた成果、課題、テーマ、使用傾向サマリーの内部スクラッチパッドを生成します。これを専用のパスとして実行する理由は、次の2つのパスが一貫した全体像を必要とするからです。統合とスライドを1パスで行うと、Claude が最後に読んだストリームを過剰に重み付けするため、スライドコンテンツが不均一になります。

パス2は統合スクラッチパッドと成功プランを読み取り、オープンリスクテーブル(赤/黄/緑、リスクごとに1行の対策)とランキング付き拡張パス(シグナル:使用状況、ペルソナ、契約;信頼度:高/中/低)を生成します。リスクと拡張はCSMが最も頻繁に編集する部分のため、専用パスで集中したトークンバジェットと明示的な推論を割り当てます。

パス3はトーンマッチとスロットマッピングです。Claude は同じCSMの3件の音声サンプルQBRを読み取り(存在しない場合は references/3-sample-output.md のサンプルにフォールバック)、統合・リスク・拡張コンテンツをチームの言葉遣いに書き直します。中立的で、データ主導で、誇張表現なし。その後、書き直したコンテンツを references/1-qbr-template-slots.md の名前付きスロットにマッピングします。テンプレートごとのスロットマッピングを最後に行うため、テンプレートを交換しても上流のパスを再実行する必要はありません。マッピングステップのみ再生成します。

アウトプットはスロットごとに1つのフェンスブロックを持つMarkdownファイル1つと、別ファイルとして1ページのエグゼクティブサマリーです。CSMは常に送信前に編集します。スキルはドラフトエンジンであり、パブリッシャーではありません。

コストの現実

Claude Sonnetでの完全実行は約25,000〜40,000インプットトークン、4,000〜7,000アウトプットトークンです。現在のSonnet価格でQBRあたり約8〜15セントです。最大のインプット変数はGongのトランスクリプトボリュームです。四半期中に20回の60分コールがあるアカウントは上限付近になり、3回の30分コールがあるアカウントは下限付近になります。3パス設計は適度なオーバーヘッドを追加しますが(各パスはプレフィックスコンテキストを共有)、アウトプットが書き直し不要な状態で編集可能になるため、その価値があります。

実際の処理時間はアカウントあたり約2〜4分で、ステップ1のSalesforce SOQLの取得とGongのトランスクリプト取得がボトルネックです。Claudeのパスは並行取得の後に順次実行され、合計で60〜90秒程度追加されます。

CSMがQBRをゼロから準備する場合、アカウントあたり通常90〜180分かかります。データの取得、過去のコールのレビュー、ナラティブの構成、スライドテキストの作成が含まれます。このスキルにより、作業時間は25〜45分(編集パス)に短縮されます。QBRあたり約1時間の節約です。30アカウントのCSMブックで四半期に1回のQBRは、CSM1人あたり四半期30時間の節約になります。

成功指標

QBRごとに「デッキを開いた時間」から「社内レビューに送信した時間」までを計測します。このスキルを使用し始めて最初の四半期以内に、スキルにより中央値が60分未満になるはずです。また、SUCCESS_PLAN_STALEGONG_COVERAGE_LOWTONE_REVIEW_NEEDED マーカーでフラグされたQBRの数も追跡します。これらはスキルが設計上検出する上流の衛生問題(成功プランが維持されていない、Gongカバレッジのギャップ、音声サンプルの欠如)の先行指標です。健全な月ではこれらのフラグが減少傾向にあるはずです。

もう一つ注目に値する指標:生成されたコンテンツのうちCSMの編集パスを経て残る割合です。70%以上を目指します。それを下回る場合は上流のデータソースに問題があります。通常は成功プラン、時にはGongカバレッジです。90%を超える場合はCSMが編集不足の可能性があります。スキルはドラフトであり、完成したデッキではありません。

代替手段との比較

vs Gainsight QBRテンプレート。 Gainsightは自動入力フィールド(ヘルススコア、NPS、主要メトリクス)を含む標準QBRテンプレートを提供しており、すでにGainsightを利用している場合は明らかなデフォルト選択です。トレードオフ:GainsightテンプレートはスライドコンテンツではなくヘルススコアリングとCTA管理を中心に設計されています。フィールドを表示しますが、ナラティブは書きません。このスキルはナラティブを書きます。オペレーションの足場にはGainsightを、デッキコンテンツにはこのスキルを使用してください。補完的な関係であり、競合ではありません。Gainsightをまだ利用していない場合、このスキルとSalesforceとGongの組み合わせで、QBRのユースケースのほとんどをはるかに低コストでカバーできます。

vs カスタムスライド自動化(SalesforceからデータをGoogleスライドにAPIで投入するPythonスクリプトなど)。 自前のスクリプトはリテラルなデータ→スライドのステップで速いですが、Gongのテーマを統合したり、使用傾向のナラティブを書いたり、拡張パスをランキングしたりできないため、味気ないデッキになります。すべてのスライドがチャートとラベルのデッキになり、CSMが依然としてすべての散文を書く必要があります。このスキルは散文を生成します。スライド組み立てスクリプトが動作している場合は、スキルが出力するスロットマップ済みMarkdownをそこに向けてください。それが意図した統合方法です。

vs CSMによる手動作成。 手動作成はCSMがスキルでは回収できないコンテキスト(チャンピオンが予算について不満を述べた過去のコール、競合他社のピッチについての非公式な会話)を持っているため、最高品質のQBRを生成します。トレードオフはアカウントあたり90〜180分です。最上位のアカウントには手動作成を使用し、それ以外のアカウントにはスキルを使用してください。スキルのアウトプットは最上位のアカウントでも有用な出発点です。CSMはより積極的に編集しますが、より進んだ状態から始められます。

注意点

  • 使用データのドリフト。 使用量ウェアハウスのビューは、データエンジニアリングによってカラム名やメトリクスの定義が変更されることがあります。その場合、傾向サマリーは黙って誤った状態になります。対策:スキルは使用量CSVのヘッダーを references/1-qbr-template-slots.md に対して検証し、カラムが欠落または名称変更されている場合は使用傾向スロットへの入力を拒否します。デッキ組み立てスクリプトは誤解を招くコンテンツではなく、スライドを空白のままレンダリングします。
  • 成功プランの陳腐化。 60日以上更新されていない成功プランは、自信に満ちた聞こえはするが古い success_plan_progress スロットを生成します。対策:スキルは成功プランドキュメントの last_updated フィールドを確認し、60日を超えている場合はそのスロットに SUCCESS_PLAN_STALE フラグを付加します。これによりスライドが承認される前にCSMが対処しなければならなくなります。
  • 顧客とのトーンの不一致。 デフォルトのトーンはCSMチームの言葉遣いですが、この特定の顧客の話し方とは一致しないかもしれません。エンタープライズの顧客はスタートアップよりフォーマルな表現を期待します。対策:voice_samples が渡される場合、トーンマッチパスは社内ドキュメントよりも顧客向けアーティファクト(顧客が受け取った過去のQBR)を重み付けします。音声サンプルが存在しない場合、スキルはニュートラルなレジスターでコンテンツを出力し、エグゼクティブサマリーに TONE_REVIEW_NEEDED フラグを付けます。
  • Gongカバレッジのギャップ。 四半期中に3回未満のGongコールしか記録されていない場合、テーマセクションが薄く、記録されたコールを過剰に重み付けします。対策:スキルは並行取得中にGongコールをカウントし、3回未満の場合、top_wins スロットはSalesforceのシグナルのみから生成され、GONG_COVERAGE_LOW のプレフィックスが付くため、CSMはデッキを送信する前に手動でカラーを追加しなければならないことがわかります。
  • 誤った過去QBRとの差分比較。 last_qbr_path が別のアカウントや四半期のデッキを指している場合、「当時の約束と現在の現実」のフレーミングが黙って崩壊します。対策:統合パスは過去QBRのタイトルスライドからアカウント名と四半期ラベルを抽出し、いずれかがインプットと一致しない場合は処理を停止します。

スタック

  • Salesforce — アカウント、商談、ケース履歴(REST API経由のSOQL)
  • Gong — コールテーマ、エグゼクティブの発言、競合他社への言及(Gong API、過去90日間)
  • Claude — 3パス統合:統合、リスク+拡張、トーンマッチ+スロットマッピング(コスト優先にはSonnet推奨;音声マッチがコストより重要な場合はOpus)
  • Notion / Salesforceカスタムオブジェクト / Gainsight — 成功プランのストレージ(1つを選択)
  • Google SlidesまたはPowerPoint — チームのデッキ組み立てスクリプト経由でスロットマップ済みMarkdownをインジェクトするデッキテンプレート

Files in this artifact

Download all (.zip)