pipeline-update

/digital-marketing-pro:pipeline-update

スクリプトの場所。 ホストで ${CLAUDE_PLUGIN_ROOT} が設定されていない場合、スクリプトはこのプラグインの scripts/ フォルダー内にあり、skills/ と同じ階層にあります。Python 3.10 以降で実行してください。python が見つからない環境（macOS、多くの Linux システム）では、python3 を使用してください。

目的

CRM パイプラインの案件と商談のレコードを更新します。案件をステージ間で移動し、金額を更新して、メモを追加し、パイプラインの速度を追跡します。すべての変更について明確な変更前後の状況を示し、パイプライン指標への下流の影響を計算することで、マーケティングチームと営業チームの双方が、案件の進捗、予測精度、目標に対する収益の進み具合を把握できるようにします。個別の案件更新とステージの一括移行の両方を対象に設計されており、不正なステージのスキップや必須項目の未入力を防ぐ検証機能を備えています。

案件のステージ、金額、または予測に影響するパイプラインの変更には、このコマンドを使用してください。リードから新しい案件を作成するには、まず /digital-marketing-pro:lead-import を使用してリードを CRM に取り込み、その後、このコマンドでパイプラインの進捗を管理してください。 個別更新を伴わない一括パイプラインレポートには、代わりに /digital-marketing-pro:executive-dashboard を使用してください。

実行ゲート（必須 — スキップ不可）

1. 稼働中のシステムに触れる前に、受信者／支出／変更／コンプライアンスを含むプレビュー全体を実行サマリーとして提示します。
2. ユーザーは yes（または同等の明示的な承認）を入力する必要があります。それ以外の入力（曖昧な承認、暗示的な承認、部分的な承認、承認なし）は、すべて実行をキャンセルします。
3. 曖昧な入力では絶対に続行しないでください。失敗した実行を自動で再試行しないでください。再実行の前に、人による確認が必要です。
4. ユーザーが yes を入力した後に限り、次のコマンドを実行して記録します。python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action create-approval --data '{"type":"pipeline-update","platform":"<platform>","content_summary":"<one line from the Execution Summary>","risk_level":"<tier>"}'、続けて python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action approve --id {approval_id}。いずれかのコマンドでエラーが発生した場合は停止してエラーを報告してください。別のツールで回避してはいけません。この記録は、この操作に対する承認手順が実行されたことを証明しますが、誰が yes を入力したかは証明できません。
5. 実行します。connector_executor.py 経由で送信する書き込みには --approval-id が必要で、一致する未使用かつ有効期限内の記録がある場合にのみ実行されます（/digital-marketing-pro:execute-action を参照）。接続済みの MCP サーバーツール経由の書き込みは、このコードチェックの対象外です。その場合は、ここで入力された yes とホストの権限確認プロンプトに依存します。実行後、python "${CLAUDE_PLUGIN_ROOT}/scripts/approval-manager.py" --brand {slug} --action mark-executed --id {approval_id} --data '{"execution_result":"success"}'（または failure）を実行します。

必要な入力

ユーザーは次の情報を提供する必要があります（または入力を求められます）。

• 取引の識別情報：取引を特定する方法です。取引名、関連する連絡先のメールアドレス、会社名、または CRM レコード ID を指定します。候補が複数ある場合は、システムが一致する候補を提示して選択を求めます。
• 適用する更新内容：1 つ以上の変更です。ステージの変更（例：「提案送信済み」から「交渉中」）、取引金額の更新（増額、減額、または分割）、終了日の調整、確度の上書き、失注理由（失注としてクローズする場合）、またはカスタムフィールドの変更などです。
• メモまたは背景情報：更新理由、会議の要約、懸念事項の詳細、競合情報、次のステップ、またはタイムスタンプ付きのメモとして取引レコードに追加する定性的な情報です。
• パイプライン名（複数ある場合）：取引が属するパイプラインです。新規事業、更新、アップセル、パートナーシップ、または異なる製品ラインごとに個別のパイプラインがある企業に関係します。
• CRM プラットフォーム：Salesforce、HubSpot、Zoho、または Pipedrive と、プラットフォームが複数のパイプラインタイプに対応している場合は、該当するパイプライン／商談オブジェクトを指定します。
• アクティビティとの関連付け（任意）：タイムスタンプ、所要時間、参加者を含め、更新を特定のアクティビティタイプ（電話、会議、メール、タスク、デモ、またはカスタムアクティビティ）として記録するかどうかです。
• フォローアップアクション（任意）：更新に伴って作成するタスクです。次の電話の予定を入れる、提案書を送る、技術担当者を加える、SOW を作成する、または担当者と期限を指定してフォローアップ日をリマインダーに設定するなどです。
• 通知設定（任意）：パイプラインの変更について、取引オーナー、アカウントエグゼクティブ、またはマネージャーに通知するかどうかと、通知チャネル（CRM 通知、メール、Slack）です。
• 一括更新の範囲（任意）：複数の取引を一度に更新する場合、同じ更新を適用する取引識別情報の一覧、または取引を選択するフィルター条件（例：「終了日が 3 月 1 日より前のディスカバリーステージのすべての取引」）です。
• 受注／失注分析フィールド（任意）：取引をクローズする場合の、受注／失注の理由、関与した競合、決定要因、学んだ教訓、連絡先を再獲得または紹介のシーケンスに追加するかどうかです。
• 収益認識の詳細（任意）：受注としてクローズした取引の場合、契約条件（月次／年次）、開始日、更新日、一時収益と継続収益の内訳、適用した割引またはプロモーション価格です。
• 関連する取引（任意）：この更新が関連する取引に影響するかどうかです。取引のステージ変更に基づいて作成または更新すべきアップセルの機会、クロスセルの取引、または更新のパイプラインが含まれます。

プロセス

1. ブランドのコンテキストを読み込む：~/.claude-marketing/brands/_active-brand.json を読み取り、アクティブなスラッグを確認してから、~/.claude-marketing/brands/{slug}/profile.json を読み込みます。ブランドのトーン、対象市場のコンプライアンスルール（skills/context-engine/compliance-rules.md）、業界のコンテキストを適用します。ガイドラインも確認します。~/.claude-marketing/brands/{slug}/guidelines/_manifest.json が存在する場合は、制限事項と関連するカテゴリーファイルを読み込みます。~/.claude-marketing/sops/ で代理店の SOP も確認します。ブランドが存在しない場合は、「先にブランドを設定しますか（/digital-marketing-pro:brand-setup）？」と尋ねます。または、デフォルト設定で進めます。
2. 接続済みの CRM とパイプラインの設定を確認する：CRM の接続状態を確認し、利用可能なパイプラインとそのステージ定義（ステージごとの必須フィールド、ステージの順序、デフォルトの確度を含む）を取得して、対象のパイプラインへの書き込み権限があることを確認します。複数のパイプラインがある場合は、選択肢を提示します。
3. 既存の商談レコードを検索する：指定された識別情報（名前、メールアドレス、会社名、または ID）で CRM 内の商談を検索します。複数の候補が見つかった場合は、ユーザーが正しいレコードを選択できるよう、主要な詳細（商談名、ステージ、金額、担当者、最終アクティビティ日、現在のステージに滞在している日数）とともに候補を提示します。
4. 現在の商談の状態を提示する：現在のレコード全体（商談名、パイプライン、現在のステージ、金額、確度、クローズ日、担当者、関連する連絡先と会社、最近のアクティビティのタイムライン（直近 5 件）、カスタムフィールドの値、現在のステージに滞在している日数）を表示します。これは変更監査の「変更前」のスナップショットになります。
5. パイプラインのルールに照らして更新案を検証する：ステージの移行が有効であること（パイプラインで許可されていない限り、必須ステージを飛ばしていないこと）、商談金額が移行先ステージの許容範囲内であること、クローズ日がステージの位置付けに照らして現実的であること、移行先ステージの必須フィールドが入力済みであることを確認します。違反があれば、必要な具体的な修正とともに警告します。
6. パイプラインへの影響のプレビューを計算する：実行前に、この変更がパイプライン指標に与える影響（加重パイプライン金額の変化、当期の予測への影響、ステージ成約率の調整、この商談の移動によってパイプラインのカバレッジに不足や偏りが生じるかどうか）を算出します。
7. 更新ペイロードを準備する：すべての変更を含む、CRM で使用可能な更新ペイロードを作成します。ステージ、金額、クローズ日、確度、カスタムフィールド、メモ、アクティビティログのエントリー、フォローアップタスク、関連レコードの更新（例：親アカウントのパイプライン金額のロールアップ更新）を含めます。
8. 承認ゲートを設ける：すべてのパイプライン更新は売上予測に直接影響するため、リスクを中程度と評価します。パイプラインの速度への影響、予測の変化、検証に関する警告とともに、現在の状態と提案された状態を比較する形式で更新内容を提示します。
9. 承認後、CRM MCP 経由で更新する：プラットフォーム MCP を通じて、更新ペイロードを CRM に送信します。アクティビティログのエントリーを作成し、メモを添付し、正しい担当者と期限を設定したフォローアップタスクを作成して、設定されている場合は通知を送信します。CRM から更新済みレコードを読み戻して、更新が成功したことを確認します。
10. パイプライン速度への影響を計算する：この更新がパイプライン速度の指標（ステージ成約率、このステージの商談サイクルの平均所要時間、加重パイプライン金額、目標に対する予測精度、同程度の商談金額およびステージにおける過去の平均との比較）に与える影響を算出します。
11. 成約・失注データを処理する（クローズ時）：商談を成約または失注としてクローズする場合は、成約・失注の理由、競合データ、決め手となった要因を記録します。失注した商談では、連絡先を再獲得用のナーチャリングシーケンスに登録するかどうかを判断します。成約した商談では、販売後のワークフロー（顧客オンボーディング、ケーススタディ候補のフラグ設定、紹介依頼のスケジュール設定）を開始します。
12. パイプラインの健全性評価を作成する：更新後に、パイプライン全体の健全性（ノルマに対するパイプラインカバレッジ率、ステージ別の商談の平均経過日数、クローズ予定日を過ぎた商談や過去の平均より長く停滞している商談など、失注リスクのある商談、ステージごとのボトルネック）を評価します。
13. 更新を記録する：更新の全内容（タイムスタンプ、商談 ID、変更前の状態、変更後の状態、開始したユーザー、速度への影響、作成したフォローアップタスク、成約・失注データ、送信した通知）を ~/.claude-marketing/brands/{slug}/logs/pipeline-update-log.json に記録します。

出力

以下を含む、構造化されたパイプライン更新レポートです。

• 更新後の商談レコード：すべての変更を適用した後の完全な商談レコード — ステージ、金額、確度、成約予定日、担当者、カスタムフィールド、関連する連絡先、次回予定されているアクティビティ
• 変更前後の比較：変更されたすべてのフィールドを並べて表示し、変更前の値、新しい値（数値フィールドの場合は変更差分）、変更の理由または変更時に提供された状況を示します
• パイプラインの進捗指標：更新後のステージ転換率、現在のステージでの平均滞在日数と過去の平均滞在日数との比較、加重パイプライン金額の変化、同程度の規模の商談における過去のステージ所要期間データに基づく成約予定日の確度
• アクティビティログエントリー：CRMのアクティビティタイムラインに表示される記録済みアクティビティ — 種別（通話、ミーティング、メール、メモ）、タイムスタンプ、所要時間、参加者、概要、次のステップ
• 作成されたフォローアップタスク：この更新によって作成されたタスク — 説明、期限日、担当者、優先度、関連する商談の参照情報、リマインダー設定
• パイプラインのスナップショット：この更新後のパイプライン全体の現在の状態 — ステージ別の商談総数、加重金額の合計、ステージごとの内訳と転換率、リスクのある商談（成約予定日超過、またはステージ滞在期間が平均を超過）、目標に対するパイプラインカバレッジ率
• 予測への影響：この単一の商談更新がパイプライン全体の予測に与える影響 — 加重パイプライン金額の変化、パイプラインカバレッジ率の変動、確度の調整、当期の売上予測への影響
• 受注／失注分析（成約の場合）：記録された受注／失注理由、競合他社、決め手となった要因、および実行された成約後のアクション（顧客オンボーディング、再獲得シーケンス、ケーススタディ候補の選定、紹介依頼）
• パイプラインの健全性評価：この更新後のパイプライン全体の健全性 — 目標に対するカバレッジ率、ステージ別の平均商談経過日数、ボトルネックとなっているステージ、失注に至るリスクのある商談、前回のパイプラインスナップショットとの比較
• 停滞商談のアラート：パイプラインの健全性チェックで停滞していると特定された商談 — 商談名、ステージ、ステージ滞在日数、想定されるステージ所要期間、推奨アクション（再アプローチ、エスカレーション、または失注としてクローズ）
• 過去のステージ所要期間との比較：この商談が前のステージに留まった期間を、同程度の規模の商談の平均と比較して示します — 想定より早いか遅いか、および成約確度への影響
• 商談のマーケティングアトリビューション：この商談に貢献したマーケティングタッチポイント — ソースキャンペーン、コンテンツの利用状況、メールへのエンゲージメント、商談の連絡先に関連付けられた広告のクリック。これにより、マーケティングから売上への貢献を可視化します
• 通知の配信確認：商談の担当者、マネージャー、またはチームに送信された通知 — 使用チャネル、配信状況、通知内容の概要
• 実行ログ：更新内容のタイムスタンプ付き記録 — 実行された API 呼び出し、応答ステータス、配信された通知、作成されたタスク、処理時間、CRMでの確認

使用されたエージェント

• crm-manager — 商談の検索、パイプラインステージの検証、更新内容の準備、CRMスキーマの解決、進捗指標の計算、アクティビティの記録、予測への影響の分析、パイプラインの分析
• marketing-strategist — 商談のマーケティングアトリビューション、キャンペーンと売上のつながりの分析、戦略的なマーケティング最適化に向けた受注／失注パターンの特定、パイプライン健全性評価の解釈