pipeline-update

/digital-marketing-pro:pipeline-update

脚本位置。 如果你的宿主未设置 ${CLAUDE_PLUGIN_ROOT}，脚本位于此插件的 scripts/ 文件夹中，与 skills/ 同级。请使用 Python 3.10 或更高版本运行：python；如果找不到 python，则使用 python3（macOS 和许多 Linux 系统）。

用途

更新 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。如果存在歧义，系统会显示匹配的候选项供用户选择。
• 要应用的更新：一项或多项更改——阶段变更（例如，从“已发送提案”变为“谈判中”）、交易金额更新（增加、减少或拆分）、成交日期调整、概率覆盖、失败原因（如果转为已关闭-失败），或自定义字段修改
• 备注或背景信息：更新原因、会议摘要、异议详情、竞争对手情报、后续步骤，或要作为带时间戳的备注附加到交易记录的任何定性背景信息
• 销售管道名称（如有多个）：交易所属的销售管道——适用于新业务、续约、追加销售、合作伙伴关系或不同产品线各自使用独立销售管道的企业
• CRM 平台：Salesforce、HubSpot、Zoho 或 Pipedrive，以及平台支持多种销售管道类型时所使用的具体销售管道／商机对象
• 活动关联（可选）：是否将更新记录为特定活动类型——通话、会议、电子邮件、任务、演示或自定义活动——并附上时间戳、时长和参与者
• 后续操作（可选）：因本次更新而创建的任务——安排下一次通话、发送提案、邀请技术资源参与、创建 SOW，或为后续日期设置提醒，并指定负责人和截止日期
• 通知偏好（可选）：是否通过何种渠道（CRM 通知、电子邮件、Slack）通知交易负责人、客户经理或经理此次销售管道变更
• 批量更新范围（可选）：如果要一次更新多笔交易——提供要应用相同更新的交易标识符列表，或用于筛选交易的条件（例如，“所有处于探索阶段且成交日期早于 3 月 1 日的交易”）
• 赢单／输单分析字段（可选）：关闭交易时填写——赢单／输单原因、涉及的竞争对手、决定性因素、经验教训，以及是否应将联系人加入挽回或推荐序列
• 收入确认详情（可选）：适用于已关闭-赢单的交易——合同条款（月付／年付）、开始日期、续约日期、一次性收入与经常性收入的拆分，以及应用的任何折扣或促销定价
• 相关交易（可选）：此次更新是否会影响相关交易——基于本交易的阶段变更而应创建或更新的追加销售机会、交叉销售交易或续约销售管道

流程

1. 加载品牌背景信息：读取 ~/.claude-marketing/brands/_active-brand.json 获取当前启用的 slug，然后加载 ~/.claude-marketing/brands/{slug}/profile.json。应用品牌语气、目标市场的合规规则（skills/context-engine/compliance-rules.md）和行业背景信息。同时检查是否有指南：查看 ~/.claude-marketing/brands/{slug}/guidelines/_manifest.json；如果存在，则加载限制要求和相关类别文件。检查 ~/.claude-marketing/sops/ 中是否有代理机构的标准作业流程。如果没有品牌，询问：“先设置一个品牌？（/digital-marketing-pro:brand-setup）”——或者使用默认设置继续。
2. 检查已连接的 CRM 和销售管道配置：确认 CRM 连接状态，获取可用的销售管道及其阶段定义（包括每个阶段的必填字段、阶段顺序和默认概率），并确认用户对目标销售管道具有写入权限。如果存在多个销售管道，提供选项供用户选择。
3. 查找现有交易记录：使用提供的标识符，在 CRM 中搜索交易——可通过名称、电子邮件、公司或 ID 搜索。如果找到多个匹配项，则向用户展示候选项及关键详情（交易名称、阶段、金额、负责人、最近活动日期、当前阶段持续天数），供用户选择正确的记录。
4. 展示当前交易状态：显示完整的当前记录——交易名称、销售管道、当前阶段、金额、概率、成交日期、负责人、关联联系人和公司、近期活动时间线（最近 5 条活动）、自定义字段值，以及当前阶段持续天数。此记录作为变更审计的“变更前”快照。
5. 根据销售管道规则验证拟议更新：检查阶段转换是否有效（除非销售管道允许，否则不得跳过必经阶段）、交易金额是否处于目标阶段的可接受范围内、根据阶段位置判断成交日期是否合理，以及目标阶段的所有必填字段是否已填写。标记违规项并明确指出需要进行的修正。
6. 计算销售管道影响预览：执行更新前，计算此变更对销售管道指标的影响——加权销售管道金额变化、对当前周期预测的影响、阶段转化率调整，以及该交易的变动是否会造成销售管道覆盖缺口或集中度过高。
7. 准备更新载荷：构建适用于 CRM 的更新载荷，包含所有变更——阶段、金额、成交日期、概率、自定义字段、备注、活动日志条目、后续任务，以及任何关联记录更新（例如，更新上级客户账户的销售管道金额汇总值）。
8. 设置审批关卡：将所有销售管道更新的风险评估为中等（交易会直接影响收入预测）。以变更前后对比的形式呈现更新摘要——当前状态与拟议状态，并说明销售管道速度影响、预测变化和任何验证警告。
9. 获批后，通过 CRM MCP 更新：通过平台 MCP 将更新载荷推送到 CRM。创建活动日志条目，附上备注，分配正确的负责人并设置到期日以创建后续任务，并在已配置的情况下发送通知。通过从 CRM 重新读取更新后的记录，确认更新成功。
10. 计算销售管道速度影响：计算此更新对销售管道速度指标的影响——阶段转化率、该阶段的平均交易周期、加权销售管道金额、预测相对于目标的准确性，以及与类似交易金额和阶段的历史平均值的比较。
11. 处理赢单／输单数据（如交易即将关闭）：如果交易即将以赢单或输单结案，则记录赢单／输单原因、竞争对手数据和决定因素。对于输单交易，判断联系人是否应进入赢回培育序列。对于赢单交易，触发任何售后工作流（客户入门引导、标记案例研究候选对象、安排推荐请求）。
12. 生成销售管道健康度评估：更新后，评估整体销售管道健康度——销售管道覆盖率与配额的对比、各阶段的平均交易时长、有流失风险的交易（已超过预期成交日期，或停滞时间超过历史平均值），以及逐阶段识别瓶颈。
13. 记录更新：将完整更新记录到 ~/.claude-marketing/brands/{slug}/logs/pipeline-update-log.json——包括时间戳、交易 ID、变更前状态、变更后状态、发起用户、速度影响、创建的后续任务、赢单／输单数据以及已发送的通知。

输出

结构化的销售管道更新报告，包含：

• 已更新的交易记录：应用所有更改后的完整交易记录 — 阶段、金额、概率、成交日期、负责人、自定义字段、关联联系人和下一个计划活动
• 变更前后对比：并排展示每个已变更字段，包括之前的值、新值、变更幅度（数值字段）以及变更原因或背景
• 销售管道速度指标：更新后的阶段转化率、当前阶段的平均天数与历史平均值对比、加权销售管道金额变化，以及根据类似金额交易的历史阶段时长数据得出的预计成交日期置信度
• 活动日志条目：记录的活动 — 类型（电话、会议、电子邮件、备注）、时间戳、时长、参与者、摘要和后续步骤，按其在 CRM 活动时间线中的显示方式呈现
• 已创建的后续任务：由此次更新生成的所有任务 — 描述、截止日期、受派人、优先级、关联交易引用和提醒设置
• 销售管道快照：更新后的完整销售管道当前状态 — 各阶段的交易总数、加权总金额、按阶段划分的明细及转化率、存在风险的交易（成交日期已逾期或在某阶段停留时间超过平均值），以及相对于配额的销售管道覆盖率
• 预测影响：此次单笔交易更新对整体销售管道预测的影响 — 加权销售管道金额变化、销售管道覆盖率变化、置信度调整，以及对当前周期收入预测的影响
• 赢单／失单分析（如已结束交易）：记录的赢单／失单原因、涉及的竞争对手、决定因素，以及触发的结束交易后续操作（客户引导、赢回流程、案例研究候选资格或转介绍请求）
• 销售管道健康状况评估：更新后的整体销售管道健康状况 — 相对于配额的覆盖率、各阶段的平均交易时长、瓶颈阶段、存在延期风险的交易，以及与之前销售管道快照的对比
• 停滞交易提醒：销售管道健康检查中识别出的停滞交易 — 交易名称、阶段、阶段停留天数、预期阶段时长，以及建议采取的操作（重新接洽、升级处理或标记为失单）
• 历史阶段时长对比：该交易在上一阶段停留的时长与类似金额交易的平均时长对比 — 快于或慢于预期，以及对成交概率的影响
• 交易的营销归因：促成该交易的营销触点 — 来源营销活动、内容互动、电子邮件互动，以及与交易联系人关联的广告点击，呈现从营销到收入的关联
• 通知送达确认：向交易负责人、经理或团队发送的通知 — 使用的渠道、送达状态和通知内容摘要
• 执行日志：带时间戳的更新记录 — 发出的 API 调用、响应状态、已送达的通知、已创建的任务、处理时长和 CRM 确认

使用的 Agent

• crm-manager — 交易查询、销售管道阶段验证、更新准备、CRM 架构解析、速度计算、活动记录、预测影响分析和销售管道分析
• marketing-strategist — 交易的营销归因、营销活动到收入的关联分析、用于战略营销优化的赢单／失单模式识别，以及销售管道健康状况评估解读