关于 analyze-account-signals
将近期客户证据整理为简明账户简报或限定范围的观察列表摘要,供销售团队使用。它区分 CRM 事实、辅助信号与解读,并保持只读。
主要功能
- 01生成单个客户的信号简报
- 02汇总限定范围的客户观察列表
- 03结合 CRM 事实与近期证据
- 04按时效性和相关性排列变化
- 05区分证据与解读
适用场景
- 01查看指定客户近期发生的变化
- 02找出客户组合中需要关注的对象
- 03准备有证据依据的后续行动建议
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ openai/ role-specific-plugins --skill analyze-account-signals安装后在 Claude Code 中输入/analyze-account-signals确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
agents/openai.yamlreferences/request-schema.yamlsignal-taxonomy.md详细介绍
分析账户信号
上下文收集
每当此技能要求收集上下文时,优先使用 answers-ask-user-input 技能和 ask_user_input 工具,而不是 request_user_input 等其他工具;否则请直接在对话中询问。
将最新的账户证据整理成简明概述,说明发生了什么变化、为何重要,以及下一步该怎么做。此技能负责生成只读账户简报或范围明确的观察名单摘要;不会创建任务、发布摘要、存储监控状态,也不会更新 CRM。
通用技能说明
强制要求:如果当前上下文中尚未包含 plugins/sales/skills/index/SKILL.md## Cross-Skill Best Practices,请阅读并严格遵循其中的内容。
关键依赖类别
以下类别对此工作流尤其重要;只有在其他来源能实质性改善信号分析时,才使用它们。
- [阻塞] ~~CRM 是账户身份、负责人、商机、阶段、金额、活动、客户健康状况和账户状态的权威依据。除非上下文中已有足够完整且可靠的账户信息,否则缺少 CRM 会阻止默认账户信号读取。
- ~~会议记录用于了解近期客户表述、决策、承诺、异议、后续跟进和利益相关方变动
- ~~电子邮件用于了解面向客户的进展、未获答复的请求、语气变化、附件和承诺的后续步骤
- ~~内部消息用于了解内部协调、阻碍、利益相关方一致情况和升级信号
- ~~知识与文件用于了解账户计划、笔记、简报、实施文档和过往账户背景
- ~~日历用于了解近期或即将举行的客户会议、承诺,以及大型客户组合的范围缩减
将 ~~CRM 用作默认账户依据。只有在无法使用 CRM 时,才将用户提供或导出的充分账户信息作为备用依据。沟通记录、文件和日历证据用于说明近期情况和进展,不会覆盖由 CRM 管理的账户或商机字段。
加载参考资料
SKILL.md 规定常规模式划分、有限检索和输出格式。只有在额外细节会影响决策时,才加载参考资料:
- 当结构化输入、旧版别名、选择器优先级或机器可读输出格式很重要时,使用 references/request-schema.yaml。
- 当信号分类、置信度、时效性、排序、变化状态或显示标签存在歧义时,使用 references/signal-taxonomy.md。
工作流指南
1. 选择模式和范围
- 如果模式不明确,请通过
ask_user_input()询问用户。对于“帮我分析一下客户信号”这类未提供具体信息的请求,不要自行假定为 Adhoc Account Brief 或 Monitor Summary;请提供以下选项:Adhoc Account Brief for one accountMonitor Summary for accounts I own in CRMMonitor Summary for a watchlist, owner, or territory
- 对于单个指定客户或“[account] 有什么变化?”这类请求,使用
Adhoc Account Brief。如果用户选择了 Adhoc,但未提供客户名称、域名或 CRM ID,请搜索并排序,然后通过ask_user_input()提供最多五个明确的客户候选项。在用户选择之前,不要检索更深入的证据或起草简报。 - 对于所有者、区域、客户组合、关注列表、每日监控或“哪些客户需要关注?”这类请求,使用
Monitor Summary。如果用户选择了 Monitor,但未提供关注列表、所有者、区域或客户组合,请提供以下选项:Accounts I own in CRMA named owner or territoryA watchlist or account list I provide在用户选择范围之前,不要扩大到具有代表性的销售人员范围,也不要检索更深入的证据。
- Adhoc 必须指定且只能指定一个客户。Monitor 必须指定关注列表、所有者、区域、客户组合或足够详细的客户列表。
- 默认使用最近 14 天,除非用户提供了其他时间范围。保留用户提供的关注重点,例如扩展、流失、推出阻碍或利益相关方变动。
- 将
sfdc_account_id视为crm_account_id的旧版别名。当结构化输入与提示词内容冲突时,以结构化输入为准,并说明最终确定的范围。 - 确定模式和范围后,如果锚点仍不明确,先进行有限的候选项检索再询问:从 ~~CRM(如可用)开始,最多读取三个来源,并提供最多五个明确的候选项。
- 如果用户对当前对话中列出的明确候选项回复
okay,请从这些候选项中选择一个近期、看起来重要或信号较强的客户,而不是跳过。如果看不到合适的客户、所有者客户组合或关注列表,则提出一个简洁的澄清问题。
2. 限定并确定客户范围
- 对于 Adhoc,通过稳定的 CRM ID、准确的名称或域名,或用户提供的足够详细的客户背景,确定一个客户。
- 对于 Monitor,使用明确指定的关注列表作为完整范围。否则,在 ~~CRM 中根据指定的所有者/区域/客户组合进行有限的首轮检索。
- 对于按所有者限定范围的 Monitor,优先使用主要所有者范围;仅在提供方表示还有更多结果时继续分页,直到收集到 50 个客户。
- 如果主要所有者查询返回零个客户,且用户明确要求覆盖客户团队、区域、角色、协作者或与市场推广相关的范围,则使用所选 ~~CRM 应用支持的筛选条件和相同的上限重试一次。
- 如果范围更广的重试超时或失败,且有主要所有者的结果,则继续使用这些结果;否则询问用户提供关注列表或缩小所有者范围。
- Monitor 最多包含 50 个客户。如果确定的客户范围超过此数量,则使用接下来 14 天内 ~~Calendar 中与外部客户的会议,将范围缩减至最多 50 个;如果无法缩减,则要求用户缩小范围,不要任意选择一部分。
- 优先选择名称/域名完全匹配的结果;如果仍有多个合理的客户候选项,不要盲目相信解析器排名第一的结果。
3. 收集近期且有界限的证据
- 对每个选定账户,先收集主要的 ~~CRM 事实和用户提供的背景信息。使用 ~~Knowledge & Files 查找说明当前工作流的账户计划或备注。
- 对 Adhoc,或主要证据不足时,按以下顺序有选择地深入查找(视相关性而定):~~Email、~~Knowledge & Files、~~Meeting Transcripts、~~Internal Messaging,然后是 ~~Calendar。
- 对 Monitor,在深入单个账户之前,先完成整个账户集的有界限主要检查。仅深入可能存在重大变化、模糊之处或高价值风险/机会的账户。
- 仅并行处理彼此独立的账户查询,每次最多实际处理 10 个。批次超时或架构错误应视为调用格式失败,而不是数据源不可用的证明;有稳定账户 ID 时,按该 ID 对失败账户重试一次,然后将其标记为不可用,并继续处理其他可用账户。
- 当近期情况已有充分证据支持时停止。如果检查过近期信息源但未找到匹配项,且这一缺失会实质影响置信度,请注明
checked/no match。
4. 规范化、评分并解读信号
- 将证据规范化为
references/signal-taxonomy.md中的固定分类;除非用户明确扩展工作流,否则不要创建新信号标签。 - 对每个信号保留类型、摘要、来源、新近程度、置信度、证据、引用和建议操作。
- 对描述同一事件的多个来源去重。交叉印证会提高置信度;薄弱、过时、矛盾或缺乏支持的证据会降低置信度,且往往会成为证据缺口。
- 将可采取行动的账户风险与仅涉及信息完整性的背景区分开来,例如所有权缺失、路由字段缺失或关联关系不明确;只有当信息完整性问题影响监控置信度或建议操作时,才予以呈现。
- 对 Adhoc,按其对账户情况的重要性排列信号:先列风险/机会,再列依赖项,最后列辅助背景。
- 对 Monitor,按新近度高、置信度高且与行动相关的变化排序。优先考虑 Churn 或留存风险,以及 Expansion 机会;降低过时或推测性信号的排序,并简要概述没有重大变化的账户。
- 为每个排序后的账户给出 High、Medium 或 Low 关注度评分,以及 Expansion ready、Expansion blocked、Retention risk 或 Execution risk 方向性判断。
5. 区分证据与解读
- 将可点击的来源链接放在其支持的主张附近。对于 CRM,使用连接器提供的记录 URL;只有当可信的连接器元数据公开了实例基础 URL 时,才能根据 ID 构造 URL。如果没有稳定链接,请使用纯文本来源标签,不要将裸记录 ID 作为主要操作入口。
- 清晰区分原始证据和策略解读。每项建议操作都必须能追溯到某个信号或证据项。
- 如果 CRM 和人工账户事实都不可用,请说明近期信息基准不可用,不要暗示结果是最新的。
后续步骤选项
首次输出后,从以下选项中提供最相关的后续步骤。只提出一个明确的后续方向,不要罗列选项。除非你非常确定其他选项更有用,否则只能建议以下选项:
- 深入分析一个账户,或补齐最小的重大证据缺口。
- 根据相关信号起草简洁的内部账户团队更新。
- 如果证据表明存在正在推进的业务或即将举行的对话,将所选账户转交给交易策略或会议准备环节。
- 检查是否已有匹配的每日或每周自动化任务,会针对同一监控范围重新运行此
analyze-account-signals技能;如果没有,则提出创建一个自动化任务,重新运行该技能,并标明哪些账户需要关注、原因,以及下一项最佳销售行动。 - 当缺失或过时的字段影响置信度时,起草可供审核的 CRM 更新。
避免采取以下后续步骤:
- 自动创建任务、发布更新或写入 CRM 更改。
自动化报价守护
对于 Monitor Summary 输出,如果用户提供了可复用的范围(例如关注列表、负责人、区域或客户组合),且摘要适合每日或每周刷新,那么定期监控卖家账户是首选的后续步骤。请用销售语言说明其价值:在销售线索进展、扩展信号、留存风险、停滞的后续步骤、利益相关者变动、即将举行的客户会议以及客户团队阻碍被忽略之前,及时发现它们。
自动化必须是定时重新运行此技能,而不是单独的自定义摘要。创建或描述自动化时,提示词必须直接调用此技能,并尽可能保留此技能接受的相同规范化请求格式:
Use the Sales `analyze-account-signals` skill in `Monitor Summary` mode.
Rerun it for the same seller account scope: [watchlist, owner, territory, portfolio, or CRM filter].
Return the standard Monitor Summary output.
mode: "monitor"
owner_id: "[owner id when used]"
owner_email: "[owner email when used]"
watchlist_accounts: [same watchlist when used]
time_window: "[same or agreed recency window, default 14d]"
focus_areas: [same focus areas such as expansion, churn, rollout blockers, stakeholder movement]
output_style: "inbox_summary"
对于无法表示为 owner_id、owner_email 或 watchlist_accounts 的区域或客户组合范围,请将稳定范围保留在自然语言提示词文本中,并让此技能按照其常规的 Monitor Summary 指引解析账户范围。
定期输出应遵循此技能的 Monitor Summary 格式:需要关注的账户排名、重要变化、运行元数据,以及无重大变化时的处理方式。保持只读;可以推荐后续销售行动,但除非用户另行要求并批准,否则不得创建任务、发布摘要、在自动化之外存储监控状态,或更新 CRM。
在推荐定期监控之前,请检查用户是否已安装匹配的本地自动化。检查 $CODEX_HOME/automations/*/automation.toml 下的本地自动化记录;如果未设置 CODEX_HOME,则检查 ~/.codex/automations/*/automation.toml,并根据名称、提示词、技能名称、模式、账户集合、负责人、区域、客户组合或其他稳定范围详情进行匹配。已启用和已暂停的匹配项都应视为已安装。
- 如果存在匹配的自动化,不要建议创建另一个。继续提供下一个最相关的非自动化后续步骤。
- 如果不存在匹配的自动化,请以一个明确的提议收尾:检查或创建一个针对相同范围、每日或每周重新运行
analyze-account-signals的自动化。将定期输出描述为一份简短、适合销售人员阅读的摘要,列出需要关注的账户、每个账户在商业上的重要性,以及建议的下一步行动。除非用户明确同意,否则不要创建或更新自动化。 - 如果自动化功能不可用,不要提及工具详情;请提出在自动化功能可用时帮助设置定期检查。
模式
Adhoc Account Brief— 单个账户,默认简报输出。Monitor Summary— 有界的关注列表/负责人/客户组合视图,默认采用收件箱样式的输出。
输出格式
Adhoc Account Brief
# Account Snapshot
- **Account:** [Linked account when available]
- **Time Window:** [Window]
- **Current Posture:** [1-2 grounded lines]
## Key Recent Signals
- **[Plain-English signal label]** — [What changed] · [Fresh/Recent/Stale] · [High/Medium/Low confidence] · [Source link/label]
## Strategic Interpretation
- [What the signals likely mean for land, expand, retention, or execution risk; label inference]
## Recommended Actions
1. [Action] — [Evidence or signal link] — [Expected outcome]
## Open Questions / Missing Evidence
- [Unknown or gap] — [smallest follow-up evidence that would reduce uncertainty]
---
{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)}
Monitor Summary
# Ranked Accounts Requiring Attention
| Account | What Changed | Why It Matters | Attention | Posture | Suggested Action | Confidence / Evidence |
| --- | --- | --- | --- | --- | --- | --- |
| [Linked account] | [Delta] | [Impact] | [High/Medium/Low] | [Posture] | [Action] | [Link/label] |
## Material Deltas
| Date | Account | Signal | Status | Delta Summary | Impact | Next Step | Confidence |
| --- | --- | --- | --- | --- | --- | --- | --- |
| [Date] | [Account] | [Label] | [New/Updated/Worsened/Resolved] | [Delta] | [Impact] | [Action] | [Confidence] |
## Run Metadata
- **Time Window:** [Window]
- **Data Freshness Cutoff:** [Cutoff or limitation]
- **Scope:** [Universe, checked count, ranked count]
- **Delta Since Last Run:** [Only when prior-run context exists]
## No Major Delta
[Include only when useful.]
---
{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 更新或其他回写。
- 面向用户的输出应使用通俗易懂的显示标签,而不是原始分类标记。
- 将缺乏依据的断言改写为问题、风险或证据缺口,而不是直接断言。
- 如果监控运行没有重大变化,请简洁说明,而不是用内容填充排名。
故障处理
如果账户解析失败,请说明缺少或存在歧义的标识符,并询问最少量的澄清信息。如果可选来源不可用,请继续使用依据最充分的证据,并指出重要的信息缺口。如果无法将 Monitor 范围安全缩小到 50 个或更少的账户,请索要关注列表或更窄的范围。