review-forecast

レビューフォーキャスト

コンテキスト収集時の受付

このスキルがコンテキストを求める場合は、request_user_input などのツールよりも、answers-ask-user-input スキルと ask_user_input ツールを優先して使用してください。それ以外の場合は、会話内で直接質問してください。

CRM またはエクスポートされたパイプラインの情報を、迅速にマネージャー向けのフォーキャスト報告にまとめます。このスキルでは、集計、リスク評価、推奨事項の変更、フォローアップアクションを扱います。初回レビューは読み取り専用であり、フォーキャストカテゴリ、クローズ日、CRM レコード、タスク、メッセージを変更することはありません。

共通のスキル指示

必須：すでにコンテキストに含まれていない場合は、plugins/sales/skills/index/SKILL.md## Cross-Skill Best Practices を読み、厳密に遵守してください。

主要な依存カテゴリ

これらのカテゴリはこのワークフローで特に重要です。上位の推奨事項を実質的に変える場合に限り、ほかの情報源を使用してください。

• [ブロッキング] ~~CRM：商談、金額、ステージ、フォーキャストカテゴリ、クローズ日、担当者、次のステップ、活動、レポート、スナップショットに関する正式な情報源です。CRM レポート／エクスポート、貼り付けられたスナップショット、またはリンクされたフォーキャストの正式情報源がすでにコンテキスト内で確認できない場合は、処理を進められません。
• ~~ナレッジとファイル：フォーキャスト文書、マネージャーのメモ、クロージング計画、ディールデスクのトラッカー、承認トラッカー、カテゴリの規則
• ~~会議の文字起こし：タイミング、関係者、緊急性、異議、次のステップへの確信度を変える、最近の顧客の反応
• ~~メール：顧客とのやり取り、タイミング、未回答の依頼、商取引や調達の進捗
• ~~社内メッセージ：マネージャー、ディールデスク、法務、製品、承認、ブロッカー、アカウントチームに関する兆候

フォーキャストの正式な情報源には、デフォルトで ~~CRM を使用してください。CRM を使用できない場合に限り、ユーザーから提供またはエクスポートされたパイプラインのスナップショットを代替情報源として使用してください。メモ、メッセージ、文字起こしは補足的な根拠であり、不足している商談情報の代わりにはなりません。

参照情報の読み込み

通常のフォーキャストレビューの手順と出力形式は SKILL.md で定義されています。構造化入力、評価姿勢／カテゴリ／金額の列挙値、比較用の入力、またはエンリッチメントモードの正規化が必要な場合は、references/request-schema.yaml を使用してください。

ワークフローのガイダンス

1. スコープと予測の規約を確認する

• レビューのスコープまたは予測の正解ソースが明確でない場合は、ask_user_input() を使ってユーザーに確認します。「予測をレビューして」のような情報が少ない依頼の場合、オーナーの担当ブックや正解ソースを決めつけず、次の選択肢を提示します：My current forecast-period owner book from live CRM、A named team, owner, report, or pipeline view、A pasted/exported forecast snapshot or deal set。
• ユーザーがソースを定義せずに「自分の予測」とだけ指定した場合は、ロールアップを作成する前に、同じ選択肢を明示して提示します。ユーザーがスコープと正解ソースを選択するまで、より詳細な商談の根拠情報を取得したり、予測状況レビューを作成したりしないでください。
• 次のいずれかのスコープを必ず指定してもらいます：オーナー／担当ブック、チーム、期間、指定されたレポートまたはパイプラインビュー、対象アカウント、対象商談、または提供された商談セット。
• 予測の正解ソースを必ず指定してもらいます：~~CRM データ、CRM レポート／エクスポート、貼り付けられたパイプライン表、最新のスナップショット、またはリンクされた予測コンテキスト。どれもない場合は、逸話から予測を推測せず、利用可能な最小限のソースを尋ねて作業を止めます。
• 予測状況レビューを作成する前に、予測状況の基準、カテゴリの規約、金額の基準を確認します。まず、提供されたデータ、~~CRM のメタデータ、または ~~Knowledge & Files から具体的な既定値を探します。必要な選択肢のいずれかが推測にすぎない場合は、根拠のある既定値を提示し、予測状況レビューを作成する前にユーザーに確認を求めます。進行中のスレッドまたは提供されたソースで 3 つすべてが明確に定義されている場合に限り、確認を待たずに進めます。
• 会社固有の予測カテゴリ、ステージゲート、または Commit／Upside の基準は、スレッドの根拠となるコンテキスト、~~CRM のメタデータ、マネージャーのメモ、~~Knowledge & Files 内の RevOps ドキュメント、またはユーザーから提供されたガイダンスの範囲を超えて解釈しないでください。
• スコープが曖昧な場合は、質問する前に候補を絞った確認を行います。ソースの読み取りは最大 3 回までとし、具体的な選択肢を最大 5 件提示するのに必要な範囲に限ります。
• ユーザーが明示的に選択または確認した場合に限り、オーナーのスコープを使用します。ユーザーがアカウントまたは商談を指定した場合は、意図的にオーナー担当ブックのスコープを使用せず、ユーザーがレポート、チーム、またはパイプラインビューを指定した場合は、そのより限定的なスコープを使用して明示します。
• 指定されたチーム、セグメント、担当ブック、またはパイプラインビューには、正規の ~~CRM レポートまたはフィルターを優先して使用し、正確なフィルターを明示します。たとえば、Startups の予測が Sales_Coverage_Opp__c = 'Startups' で定義されている場合、オーナー、アカウント、スタンプ済みセグメントの各フィールドを横断して広げるのではなく、まずそれを使用します。ユーザーから求められた場合、正規の定義が不完全だと分かっている場合、または結果が不自然に少ない場合に限り範囲を広げます。広げたフィルターであることを明示し、正規のフィルターと同等のものとして比較しないでください。

2. 予測の正解データセットを作成する

• 正規の ~~CRM レポート／フィルター、または提供されたエクスポートから始めます。出力には、正確なスコープ、期間、ソース、金額の基準、データの鮮度を明記します。
• ライブ ~~CRM の場合は、スコープ、金額、予測、ステージ、オーナー、クローズ日、次のステップ、アクティビティ、リスクの各フィールドを特定するために必要最小限のフィールドまたはスキーマの確認だけを行います。スコープが「自分の担当ブック」の場合、またはアカウントレベルのフィールドが必要な場合を除き、現在のユーザーやアカウントオブジェクトの確認は省略します。
• 通常の初回確認では、まずスコープ内の現在進行中の商談を集めてロールアップを作成します。通常は予測カテゴリ別、必要に応じてステージ別に、商談数、主要金額、予測期待額をまとめます。
• 詳細行を確認するのは、金額が大きい、リスクが高い、情報が古い、重要な変化があった、または売上構成の集中要因となっている商談に限ります。
• 過去のスナップショットの行を集めるのは、ユーザーが比較用スナップショットを提供した場合、指定されたスナップショット／レポートが利用できる場合、またはユーザーが明示的に変化を求めた場合に限ります。広範なフィールド履歴を、実際の予測変化を示すものとして使用しないでください。
• 現在と過去のデータの網羅性に差がある場合は、その点を明記します。
• 真の過去スナップショットが存在しない限り、OpportunityHistory などのフィールド履歴は予測スナップショットの変化ではなく、フィールド履歴として扱います。
• カテゴリの推奨を行うにはデータが不十分な場合は、リスクのみの報告に切り替え、その理由を説明します。

3. 判断を変える場合に限り、範囲を絞ったエビデンスを追加する

• ロールアップが存在した後、不確実または重要な上位 1〜3 件の案件には、デフォルトで light のエンリッチメントを行います。ユーザーが予測データのみのレビューを求めた場合は none を使用し、standard は依頼された詳細レビュー、または裏付けとなるエビデンスの欠如が高額な推奨を大きく変える場合にのみ使用します。
• 最近の顧客エンゲージメント、緊急性、ステークホルダー、反論、意思決定プロセス、タイミングのシグナルには ~~Meeting Transcripts と ~~Email を使用します。
• ブロッカー、承認、クローズプランのギャップ、法務/調達リスク、マネージャーのコンテキストには ~~Internal Messaging と ~~Knowledge & Files を使用します。
• デフォルトですべての案件をエンリッチメントしないでください。上位の推奨が裏付けられた時点で停止し、確信度を大きく変える未確認のレーンを明示します。
• 必須のスコープアンカーや予測の慣例が未解決の間は、エンリッチメントの範囲を広げないでください。まずそれを解決または確認します。
• 補助レーンに、CRM が所有する金額、ステージ、予測カテゴリ、担当者、クローズ日、商談状態を上書きさせないでください。

4. リスクと推奨スタンスを評価する

• 重要な案件について、次のステップの明確さ、タイミングの信頼性、ステークホルダーのカバレッジ、意思決定プロセスの可視性、緊急性の証拠、最近のエンゲージメント、データの鮮度を評価します。
• 次のステップの欠落、停滞したアクティビティ、不明確なクローズ日、弱いステークホルダーカバレッジ、カテゴリ/金額/ステージの変更など、裏付けのあるハイジーンシグナルをフラグします。
• スタンスが 1 件の案件、担当者、ステージ、セグメント、製品、タイミングバケットに過度に依存している場合は、ポートフォリオの集中をフラグします。
• シンプルな low、moderate、high のリスクラベルを使用します。出典のある事実と方向性のある推論を分けてください。
• エビデンスが裏付ける場合にのみ、keep、downgrade、upside、follow-up-check のスタンスを推奨します。裏付けのない変更は質問または Needs confirmation として表現します。
• 現在と以前のスナップショットが提供された場合は、簡潔な What Changed サブセクションを追加します。以前のスナップショットがない場合は、真の動きは評価されなかったと述べ、裏付けがある場合に限り、Closed Won の獲得、Commit の集中、停滞したクローズ日、次のステップの欠落、大規模な Closed Lost/チャーン行など、現在の状態の例を使用します。

次のステップのオプション

最初の出力の後、以下のオプションから最も関連するフォローアップを提示します。メニューではなく、明確な 1 つの移行を提示します。別のオプションの方がより有用であると確信できない限り、以下のみを提案します:

• 高リスクまたは集中を招いている 1 件の案件をより深く調査する。
• レビュー用に、簡潔なマネージャー向けまたは予測コール向けのサマリーを作成する。
• スプレッドシートにそのまま使えるロールアップまたはリスクのフォローアップ構造を作成する。
• レビュー用に、CRM にそのまま反映できる修正または次のステップのテキストを作成する。
• 同じスコープと予測の慣例でこの review-forecast スキルを毎週再実行する、一致する週次自動化が既に存在するか確認する。存在しない場合は、営業担当者またはマネージャーに週次の予測リスクレポートを提供するものの作成を提案する。

避けるべき次のステップ:

• 予測カテゴリ、クローズ日、金額、CRM レコードを自動的に変更すること。

自動化の提案に関するガード

現在の予測、動き、またはリスクレビューの出力について、ユーザーが再利用可能な担当者一覧、チーム、レポート、パイプラインビュー、期間、または商談セットと、安定した予測ルールを持っている場合は、週次の予測リスクブリーフを自動化の提案として優先します。営業向けの表現で価値を伝えます。予測会議の前に、コミットのリスク、上振れの動き、次のアクションの停滞、クローズ日の切迫、集中度、マネージャーの対応が必要な商談を特定できる点を説明してください。

自動化では、別個のカスタムパイプラインサマリーではなく、このスキルを定期的に再実行する必要があります。自動化を作成または説明する際は、プロンプトからこのスキルを直接呼び出し、同じ予測範囲とルールを維持してください。

Use the Sales `review-forecast` skill.
Rerun it weekly for the same forecast scope and convention.
Return the standard Forecast Review output.

owner_name: "[owner name when used]"
owner_email: "[owner email when used]"
focus_accounts: [same focused accounts when used]
focus_opportunities: [same focused opportunities when used]
forecast_period: "[same period or rolling current period]"
forecast_posture_standard: "[defend_commit, identify_upside, or conservative_manager_ready]"
forecast_category_convention: "[same sourced or user-confirmed convention]"
amount_basis: "[carr_arr, acv, tcv, weighted_amount, or crm_primary_amount]"
enrichment_mode: "[none, light, or standard]"

担当者、アカウント、または商談のフィールドでは表現できないチーム、レポート、またはパイプラインビューの範囲については、安定した範囲を自然言語のプロンプトテキストに記述し、このスキルの通常のワークフローガイダンスに従って予測の真実の集合を特定します。

定期的な出力は、このスキルの「予測レビュー」形式に従う必要があります。レビュー範囲、全体的な予測状況、主な動き、最もリスクの高い商談、推奨事項の変更、エビデンスの不足、フォローアップアクションを含めてください。読み取り専用とし、確認用のチェック、修正、または CRM に入力可能なテキストは提案できますが、ユーザーが別途依頼して承認しない限り、予測カテゴリ、クローズ日、金額、CRM レコード、タスク、メッセージを変更してはいけません。

週次の予測ブリーフを提案する前に、ユーザーが対応するローカル自動化をすでにインストールしているか確認してください。$CODEX_HOME/automations/*/automation.toml にあるローカル自動化レコードを調べます。CODEX_HOME が設定されていない場合は、~/.codex/automations/*/automation.toml を調べてください。名前、プロンプト、スキル名、実行頻度、担当者一覧、チーム、レポート、パイプラインビュー、予測期間、金額の基準、カテゴリのルール、その他の安定した範囲の詳細で照合します。有効な一致と一時停止中の一致は、インストール済みとして扱います。

• 一致する自動化が存在する場合、別の自動化の作成を提案してはいけません。次に関連性の高い、自動化以外のフォローアップに進んでください。
• 一致する自動化が存在しない場合は、同じ範囲について review-forecast を週次で再実行する自動化の確認・作成を提案し、明確な提案を一つだけ最後に示してください。定期的な出力は、リスク、上振れ、次のアクションの停滞、集中度、推奨されるチェックを網羅した、マネージャー向けの週次予測ブリーフとして説明してください。ユーザーが明示的に同意するまで、自動化を作成または更新してはいけません。
• 自動化の機能を利用できない場合は、ツールの詳細には触れず、自動化が利用可能になったときに定期的な予測リスクブリーフの設定を支援すると申し出てください。

モード

• 現在の予測レビュー — デフォルト。現在の集計、主なリスク、推奨事項、アクションを示します。
• 動きのレビュー — 過去のスナップショットまたは明示的な比較元がある場合に使用し、実際の動きを追加します。
• リスクのみのレビュー — 予測の真実はリスク評価には十分でも、状況の変化を判断するには情報が少なすぎる場合に使用します。
• 対象商談のレビュー — 全体の担当者一覧ではなく、指定されたアカウントまたは商談を対象とする場合に使用します。

出力形式

以下のセクションを順番に返します。

# Forecast Review: [Scope]

## Review Scope

- **Scope:** [Owner, team, report, period, or deal set]
- **Forecast truth:** [Live CRM, export, pasted data, or linked source]
- **Amount basis:** [CARR/ARR, ACV, TCV, weighted amount, or CRM primary amount]
- **Category convention:** [Sourced convention or user-confirmed interpretation]
- **Data freshness:** [Date/time or limitation]

## Overall Forecast Posture

[Manager-ready posture summary]

| Forecast Category | Deal Count | Primary Amount | Expected Amount | Confidence |
| --- | ---: | ---: | ---: | --- |
| [Category] | [Count] | [Amount] | [Amount] | [High/Medium/Low] |

## Key Movements

- [True movement backed by a prior snapshot, or “True movement not evaluated; no prior snapshot was available.”]

## Highest-Risk Deals

| Deal | Amount | Current Posture | Risk | Why | Recommended Check or Change | Source |
| --- | ---: | --- | --- | --- | --- | --- |
| [Deal] | [Amount] | [Category] | [Low/Moderate/High] | [Evidence] | [Action or posture] | [Link/label] |

## Recommendation Changes

- **[Deal]:** [Keep / Downgrade / Upside / Needs confirmation] — [grounded reason and confidence]

## Evidence Gaps

- [Gap] — [impact on confidence] — [smallest next collection step]

## Follow-Up Actions

1. [Action] — [Owner or suggested owner] — [Due or TBD] — [Expected outcome] — [Source]

---

{Follow the instructions and output format/conditions in [Limitations and Improvements](../index/SKILL.md#limitations-and-improvements)}

{Follow the instructions and output format/conditions in [Next Steps](../index/SKILL.md#4-next-steps)}

ルール

• 商談、金額、ステージ、クローズ日、担当者、予測カテゴリ、顧客とのやり取り、動き、リンクを捏造してはいけません。
• レビューで使用した情報が、CRM のライブデータ、エクスポートデータ／レポートデータ、貼り付けられたパイプラインデータ、またはユーザー提供の別の情報源のいずれかを説明してください。
• 過去のスナップショットまたは明示的な比較元がある場合にのみ実際の動きを含めます。それ以外の場合は Key Movements を維持し、制約を明記してください。
• 不確かな推奨事項には Likely、Possible、または Needs confirmation とラベルを付け、誤った精密さを避けてください。
• 最初のレビューは読み取り専用にしてください。マネージャー向けメモ、CRM に入力可能なテキスト、スプレッドシートの構成、またはリスクのフォローアップを作成するのは、依頼された場合に限ります。別途明示的な承認を得ることなく、書き込みや送信をしてはいけません。

失敗時の対応

対象範囲や予測の真偽を特定できない場合は、障害となっている点を示し、候補があれば具体的に提示したうえで、不足している情報源または規約のうち最小限のものを尋ねてください。任意の証拠を入手できない場合は、予測の真偽セットに基づいて続行し、確信度の限界を明示してください。