review-forecast

预测审查

上下文收集

每当此技能要求提供上下文时，优先使用 answers-ask-user-input 技能和 ask_user_input 工具，而不是 request_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() 询问用户。对于“review the forecast”这类未指定信息的请求，不要假定负责人名下的商机集或事实来源；请提供以下选项：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。
• 如果用户只说“my forecast”，却未定义来源，请在汇总之前提供相同的明确选项。用户选定范围和事实来源路径之前，不要检索更深入的商机证据或生成预测状态审核。
• 必须有一个范围锚点：负责人／商机集、团队、期间、指定报告或销售管道视图、重点客户、重点商机，或用户提供的交易集。
• 必须有一个预测事实来源：~~CRM 数据、~~CRM 报告／导出文件、粘贴的销售管道表格、当前快照，或关联的预测上下文。如果都没有，请停止并询问最小可用数据源，不要根据零散信息推断预测。
• 生成预测状态审核之前，先确定预测状态标准、类别惯例和金额依据。首先从用户提供的数据、~~CRM 元数据或 ~~Knowledge & Files 中查找具体默认值。如果任何必需选项只是推断得出的，请提供有来源支持的默认值，并在生成预测状态审核前请用户确认；只有当当前对话或用户提供的来源明确定义了这三项时，才可不经确认直接继续。
• 不要超出有来源支持的对话上下文、~~CRM 元数据、经理备注、~~Knowledge & Files 中的 RevOps 文档或用户提供的指导，解读公司特定的预测类别、阶段门槛或 Commit／Upside 规范。
• 如果范围有歧义，提问前先进行有限的候选检索：最多读取三个来源，只检索足以提供最多五个具体选项的信息。
• 只有在用户明确选择或确认负责人范围后，才能使用该范围。用户指定客户或商机时，刻意绕过负责人名下的商机集范围；用户指定报告、团队或销售管道视图时，使用更窄的范围并说明这一点。
• 对于指定的团队、细分市场、商机集或销售管道视图，优先使用规范的 ~~CRM 报告或筛选条件，并说明确切筛选条件。例如，如果 Startups 预测以 Sales_Coverage_Opp__c = 'Startups' 表示，应优先使用此条件，而不是在负责人、客户和已标记细分市场字段之间扩大筛选范围。只有用户要求、已知规范定义不完整，或结果少得不合理时，才扩大范围；注明扩大后的筛选条件，且不要将其当作规范结果进行比较。

2. 构建预测事实集

• 从规范的 ~~CRM 报告／筛选条件或用户提供的导出文件开始。在输出中说明确切范围、期间、来源、金额依据和数据新鲜度。
• 对于实时 ~~CRM，只进行识别范围、金额、预测、阶段、负责人、成交日期、下一步、活动和风险字段所需的最低限度字段或架构发现。除非范围是“my book”或需要客户级字段，否则跳过当前用户和客户对象发现。
• 对于常规的初步分析，先收集范围内当前未关闭的交易并进行汇总，通常按预测类别汇总，也可按阶段汇总：交易数量、主要金额和预期预测金额。
• 仅检查金额最高、风险最高、已过时、发生重大变化或推动集中度的商机详情行。
• 仅当用户提供了对比快照、存在指定快照／报告，或用户明确要求查看变动时，才收集此前快照的行。不要用宽泛的字段历史来暗示预测确实发生了变化。
• 如果当前与此前数据的覆盖范围不完整，请明确标注。
• 除非存在真实的此前快照，否则应将 OpportunityHistory 或类似字段历史视为字段历史，而非预测快照变动。
• 如果数据过于稀疏，无法推荐类别，则改为仅提供风险分析，并说明原因。

3. 仅在会影响判断时补充有限的证据

• 汇总完成后，默认仅对最不确定或最重要的 1 至 3 笔交易进行 light 级补充。用户要求仅审查预测数据时，使用 none；只有用户要求深入审查，或缺失的支持证据会实质性影响高价值建议时，才使用 standard。
• 使用 ~~Meeting Transcripts 和 ~~Email，了解近期客户互动、紧迫性、利益相关方、异议、决策流程和时间安排等信号。
• 使用 ~~Internal Messaging 和 ~~Knowledge & Files，了解阻碍因素、审批、成交计划缺口、法律或采购风险，以及经理的背景信息。
• 默认不要为每笔交易补充证据。只有在主要建议得到支持后才停止；指出可能实质性影响判断信心的缺失信息渠道。
• 必需的范围锚点或预测约定尚未明确时，不要扩大证据补充范围；应先解决或确认这些问题。
• 不要让辅助渠道中的信息覆盖由 CRM 管理的金额、阶段、预测类别、负责人、成交日期或商机状态。

4. 评估风险和建议倾向

• 评估重要交易的下一步是否明确、时间安排是否可信、利益相关方覆盖是否充分、决策流程是否清晰、紧迫性是否有证据、近期互动情况，以及数据的新鲜度。
• 标记有依据的数据维护问题，例如缺少下一步、活动记录过时、成交日期不明确、利益相关方覆盖不足，以及类别、金额或阶段发生变更。
• 如果预测倾向过度依赖某一笔交易、负责人、阶段、细分市场、产品或时间区间，则标记组合集中风险。
• 使用简单的 low、moderate 和 high 风险标签。将来源明确的事实与方向性推断分开。
• 仅在证据支持时，才建议维持、下调、视为上行机会或跟进核查。对缺乏依据的变更，应以问题形式表述或标注为 Needs confirmation。
• 如果提供了当前和先前的快照，请添加简洁的 What Changed 小节。若未提供先前快照，应说明未评估实际变动，并且仅在有依据时举例说明当前状态，例如已签约的 Closed Won、Commit 集中度、成交日期过时、缺少下一步，或大额 Closed Lost／客户流失记录。

下一步选项

首次输出后，从以下选项中提供最相关的一项后续行动。给出一个明确的衔接选项，而不是列出菜单。除非你非常确信其他选项更有用，否则仅建议以下选项：

• 深入检查一笔高风险或导致集中风险的交易。
• 起草简洁的经理或预测会议摘要，供审核。
• 创建可直接用于电子表格的汇总或风险跟进结构。
• 起草可供审核的 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 的自动化。将定期输出描述为面向经理的每周预测简报，涵盖风险、上行空间、过时的后续步骤、集中度和建议的核查事项。除非用户明确同意，否则不要创建或更新自动化。
• 如果自动化功能不可用，不要提及工具细节；可提出在自动化功能可用时协助设置定期预测风险简报。

模式

• Current Forecast Review — 默认模式；提供当前汇总、主要风险、建议和行动。
• Movement Review — 存在先前快照或明确的比较来源时使用；补充真实变动。
• Risk-Only Review — 预测事实足以评估风险，但不足以评估态势变化时使用。
• Focused Deal Review — 针对指定客户或商机，而非完整业务组合进行审查。

输出格式

按顺序返回以下部分。

# 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 的文本、电子表格结构或风险跟进内容；未经单独明确批准，绝不写入或发送。

失败处理

如果无法确定范围或预测事实，请说明阻碍；如有可用的具体候选项，请一并提供，并询问最少缺少的来源或惯例。如果无法获取可选证据，请基于预测事实集继续，并明确说明置信度限制。