扩展信号

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install expansion-signals
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 expansion-signals。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

扩展信号是一项 Openclaw Skills 工作流，用于在现有客户中发现扩展机会和续约风险。它会检查已成交交易历史、购买周期、最近价格、工作区定义的扩展策略，以及最多三个带日期的公开网络事件，例如融资、招聘或领导层变动。
该工作流会将五种分类之一——续约、扩展、重复购买、存在风险或无信号——连同简明原因和时间戳写入客户账户。随后每周发布一份 Slack 摘要，优先列出存在风险和有扩展机会的账户。示例使用 Cargo 原生账户和交易模型，也提供可选的 CRM 版本，支持 HubSpot、Salesforce 或 Attio。

应用场景

标记即将续约且可能适合追加销售或扩展的客户。
每周向客户经理提供续约前需要联系的账户清单。
检测重复购买行为，并建议按最近一次支付的价格进行续约沟通。
根据带日期的招聘、融资、领导层或其他公开事件，发现存在风险的续约。
在受限的 Slack 频道中发布每周一份续约和扩展信号摘要。
将工作流适配到 Cargo 原生模型，或由 CRM 支持的 HubSpot、Salesforce 和 Attio 记录。
避免重复处理续约或重新运行摘要时产生重复判断。

工作原理

一个 play 根据账户关联和成交日期，选择进入配置续约窗口的每笔已成交交易；默认窗口为成交后十至十二个月。
分析器通过 SQL 读取账户完整购买历史，检查是否有更新的续约、购买周期和最近支付价格。
分析器读取工作区的扩展策略；启用网络研究后，还会进行最多三次网络搜索以查找带日期的外部事件。
Agent 将账户分类为续约、扩展、重复购买、存在风险或无信号，并返回不超过三句话的原因、建议策略和支持网址。
play 仅将 expansion_signal、expansion_reason 和 expansion_signal_at 写入由 ID 标识的账户。
摘要 Agent 读取已存储的账户判断而非重新判断，对结果按风险和机会排序，并包含账户负责人。
台账确保每周只发布一份摘要，因此重新运行不会产生重复的 Slack 消息。
在完成验证、契约检查、Cargo CDK 计划审查和明确的部署批准之前，工作流保持禁用状态。

配置指南

安装 Cargo CLI，并从 Cargo CDK 项目初始化或添加 cookbook 示例。
cargo-ai cdk add cookbook/expansion-signals
cargo-ai cdk init --cookbook expansion-signals
cd
npm install
确认项目具有 @cargo-ai/cli 和 @cargo-ai/cdk 1.0.92 或更高版本、Cargo 工作区，以及经授权的 Slack 和 Anthropic 连接器。原生示例不需要 CRM 连接器。
部署前核对现有资源。重用现有的 Slack 或 Anthropic 连接器以及 gtm_accounts 或 gtm_opportunities 模型，以避免 slug 重复。
加载账户和已成交交易（包括 account_id），或连接已同步的 CRM 支持模型。
cargo-ai storage model list
cargo-ai connection connector list
cargo-ai storage record create-bulk --model-uuid --records '[{"data":{...}}]'
将 references/expansion-plays.md 复制到 context/expansion-plays.md，并根据团队使用的产品、信号和销售方式自定义策略。
配置续约窗口、Slack 频道 ID、语言模型连接器以及任何 CRM 专属映射。邀请 Slack 机器人加入目标频道。
启用前验证技能并审查部署计划。
node --import tsx evals/contract.mjs
npm run check
cargo-ai cdk plan
使用五笔续约窗口内的交易试运行工作流，检查每条写入的原因和来源，然后启用 play。新增 play 不会回填历史记录。

数据架构

该工作流通过 Cargo 原生模型、Agent、play、连接器、上下文文件和摘要台账组织数据。
区域 数据和行为
客户账户 gtm_accounts 存储客户记录，并接收 expansion_signal、expansion_reason 和 expansion_signal_at。不会修改交易、联系人或负责人字段。
已成交交易 gtm_opportunities 提供 is_won、账户关联、close_date、购买历史、周期和价格输入。没有关联账户的交易将被忽略。
信号分类 续约、扩展、重复购买、存在风险和无信号。已续约或没有可采取行动的信号的账户可写入无信号。
信号元数据 expansion_reason 最多包含三句话；expansion_signal_at 记录判断写入时间；引用网址为带日期的外部事件提供依据。
扩展策略上下文 context/expansion-plays.md 定义与各类客户信号对应的优惠或行动。
基础设施 infra/plays/flag-expansion.ts 选择续约窗口内的交易并写入账户字段；analyst.ts 负责研究和分类；digest.ts 格式化 Slack 消息。
摘要记录 expansion_digests 及其台账跟踪每周发送情况并防止重复发布。去重不会使用 Slack 历史记录。
CRM 支持版本 由 HubSpot、Salesforce 或 Attio 连接器支持的公司和交易模型将取代原生模型。执行写入前，CRM 公司属性必须已包含 expansion_signal、expansion_reason 和 expansion_signal_at。
文件夹和验证资源 项目包含基础设施资源、参考资料、评估契约，以及位于 infra/expansion-signals/ 和 .claude/skills/expansion-signals/ 下生成的技能流程。
默认 play 使用 changeKinds: [added]，因此每笔交易进入续约窗口时只会评估一次。写入时必须使用不带前缀的列 slug；带前缀的读取端 slug 不能作为有效写入目标。

高级特性

通过 Cargo 原生模型或由连接器支持的 HubSpot、Salesforce 和 Attio 版本实现 CRM 可移植性。
感知工作区的扩展手册，可将信号转化为针对具体公司的客户经理行动。
基于 Agent 的分析，将 SQL 购买历史与受控网络研究及引用来源相结合。
每个账户最多进行三次网络搜索；无网络合规版本会将结果限制在交易历史信号内。
严格的写入边界：分析器只读取数据，而 play 仅写入三个获准的账户字段。
为非年度合同自定义续约窗口，并通过保护措施避免对同一续约进行两次判断。
全量客户模式可定期判断所有客户，而不只处理临近续约的账户。
可选择向每位负责人发送私信，替代共享 Slack 摘要。
基于台账的每周去重机制，即使 Slack 消息被删除也仍然可靠。
确定性的 Slack 排序：先列出存在风险的账户，然后是扩展、重复购买和续约。
可组合的设计，适用于 CRM 丰富数据、输赢复盘和职位变动监控工作流。
契约评估、预置数据验收测试、Cargo CDK 规划、默认禁用的部署方式，以及明确的审批关卡，让上线更安全。

name: expansion-signals description: 'Every week the customers coming up on renewal are judged for an expansion moment (purchase cadence and last price from won deals, and dated outside events such as funding, hiring or a new leader); the signal and reason are written onto the account and posted as one digest for the customer team. Triggers: "flag customers ready to expand", "which customers should we upsell this quarter", "renewal and expansion signals every week", "tell account managers which accounts to reach out to before renewal", "find expansion opportunities in our customer base", "at-risk renewals digest in slack". Cargo CDK, native accounts and deals models, definePlay, defineAgent, webSearch, Slack; adapts to HubSpot, Salesforce or Attio. Skip when: you want who raised money across prospects, which is track-funding-rounds; or buying signals on accounts that are not customers yet, which is monitor-buying-signals.' version: "0.1.0"
compatibility: "Requires @cargo-ai/cli with @cargo-ai/cdk 1.0.92 or later, a Cargo workspace, and authorized Slack and Anthropic connectors. The worked example runs on native accounts and deals models, so no CRM connector is needed; the crm-backed variation swaps in HubSpot, Salesforce or Attio. Reads the workspace context when the project declares one."
homepage: https://github.com/getcargohq/gtm-skills/tree/main/expansion-signals