customer-research - 客户调研技能#

安全声明： 本技能已移除所有 subprocess 和危险系统调用，完全通过 agent framework 的工具系统执行操作。 兼容 Hermes Agent、OpenClaw 及其他支持技能框架的 agent。

触发条件#

当用户需要调研客户背景或竞品情报时触发，关键词包括：

• "调研客户"、"客户背景"、"客户分析"
• "帮我查一下 XX 客户"、"XX 客户的情况"
• "准备拜访 XX 客户"、"要去见 XX 客户"
• 竞品情报："竞品分析"、"竞品情报"、"竞品格局"、"XX行业有哪些竞品"
• 采购记录："采购记录"、"招标记录"、"中标"、"XX公司有没有买过"
• 市场调研："市场调研"、"客户采购动向"

路由分发（重要：避免模块混淆）#

根据用户意图自动路由到正确模块：

用户意图执行模块搜索轮数只查竞品/采购记录仅竞品情报模块（跳过常规4维度）3轮9次客户调研 + 竞品全部5维度（常规4维度 + 竞品情报）5轮15次只做客户调研仅常规4维度（不激活竞品模块）4轮12次

竞品情报模块详情见 references/competitor-intel.md。

核心原则#

❌ 禁止务虚空话 - 不说"数字化转型""赋能""提质增效"等空泛词汇

✅ 必须场景化 - 用 before/after 对比，描述具体业务场景细节

✅ 必须量化 - 每个场景都要有可量化的指标（时间、金额、百分比）

✅ 对号入座 - 让客户看到 PPT 时能说"这就是我们现在的痛点"

---

执行流程#

⚠️ 强制要求：必须执行搜索并返回结果#

本技能 禁止只生成搜索计划而不执行。必须完成以下全部步骤：

1. 获取客户名称 - 从用户输入中提取客户全称（输入验证：禁止路径字符，最大 100 字符）

2. 执行搜索 - 使用 agent framework 的 web_search / web_fetch 工具， 必须实际执行：

   常规模式（4维度，12次搜索）：

   • 第 1 轮：AI 相关领导发言（3 个关键词）
   • 第 2 轮：AI 相关招标记录（3 个关键词）
   • 第 3 轮：数据相关内容（3 个关键词）
   • 第 4 轮：基本情况与最新动态（3 个关键词）
   • 共计 12 个搜索关键词，必须全部执行

竞品情报模式（激活时追加）：

• 第 5 轮：竞品/采购情报（3 × 3 = 9 个关键词）
• 详情见 references/competitor-intel.md
• 当用户只查竞品时，跳过1-4轮仅执行第5轮

1. 整理搜索结果 - 将搜索结果按维度整理，标注信息来源链接

2. 生成报告 - 基于 实际搜索结果 生成调研报告（Markdown 或 Word 格式）

   • 禁止编造信息，无结果时明确告知"公开渠道未检索到"
   • 禁止输出"待搜索"占位符，必须填充实际内容

3. 生成 PPT - 基于 实际调研结果 生成场景破冰 PPT

   • ⚠️ ASI09 合规要求：PPT 场景必须基于实际搜索结果选择和定制
   • 禁止跳过调研直接生成通用模板
   • 先生成 research_results.json（调研结果），再传给 PPT 生成脚本
   • 场景选择要贴合客户行业和调研发现
   • 每个场景必须有 before/after 对比和量化指标

4. 记录到客户记忆 - memory/customers/[客户名称].md（可选）

5. 发送交付物 - 通过 messaging 工具发送调研报告 + PPT 脚本

✅ 完成标准#

调研任务完成的 必要条件：

• 4 轮搜索全部执行（12 个关键词）
• 调研报告包含实际搜索内容（非占位符）
• PPT 脚本包含 before/after 对比和量化指标
• PPT 场景基于 research_results.json 生成（非通用模板）
• 所有信息来源标注链接或来源说明

---

调研优先级（严格按顺序）#

1. AI 相关领导发言（最高优先级）#

搜索目标：该组织高层领导关于 AI、数字化、智能化的公开讲话、指示、文章

2. AI 相关招标记录和中标公示#

搜索目标：该组织发布的 AI 相关招标公告、中标公示信息、采购意向公开

3. 数据相关内容#

搜索目标：数据治理、数据中台、数据分析、数据智能、数字化转型

4. 单位基本情况和最新动态#

搜索目标：组织架构、主营业务、最新发展动态、战略方向

---

输出交付物#

1. 调研报告（Markdown/Word 格式）#

文件命名： [客户名称]_调研报告.md 或 .docx

2. 场景破冰 PPT（before/after 对比，6-8 页）#

文件命名： [客户名称]_场景破冰 PPT.md

⚠️ ASI09 合规要求：

• PPT 内容 必须基于 research_results.json（调研结果）生成
• 禁止跳过调研直接生成通用模板内容
• 调用流程：完成 4 轮搜索 → 生成 research_results.json → 传给 PPT 脚本

Before 写法（痛点细节）：

• ❌ 错误："数据不准确"
• ✅ 正确："每月 5 号等财务报表，各院区 Excel 汇总要 3 天"

After 写法（价值细节）：

• ❌ 错误："提升效率"
• ✅ 正确："每天早上 8 点自动推送昨日经营日报"

量化指标要求：

• 时间类：3 天 → 实时、4 小时 → 30 分钟
• 百分比类：70% → 85%、65% → 85%
• 金额类：10 万/年 → 1 万/年

---

场景库模板（按行业选择）#

医疗行业（医院/诊所）#

场景Before 痛点After 价值院长经营看板等报表 3 天、数据不准、异常发现晚实时日报、随时调取、自动预警护士排班4 小时排班、忙闲不均、护士抱怨30 分钟完成、智能预测、公平轮转患者随访打电话半天、30% 失访、无画像自动提醒、随访率 85%+、二次转化库存耗材缺货影响手术、过期报废 10 万/年自动预警、近效期提醒、账实一致

制造业#

场景Before 痛点After 价值生产计划Excel 排产、插单频繁、交付延期APS 自动排产、插单影响秒级评估质量追溯出问题查 3 天、找不到责任工序扫码追溯、30 分钟定位根因设备管理故障停机才维修、备件库存高预测性维护、停机减少 50%成本核算月底结账、成本分摊不准实时成本、按订单精准核算

零售业#

场景Before 痛点After 价值库存管理缺货/积压并存、盘点要 3 天安全库存预警、盘点 1 小时完成会员运营沉睡会员多、促销靠群发精准画像、复购率提升 30%门店督导巡店靠拍照、整改无追踪远程巡店、问题闭环管理

---

安全说明#

输入验证#

• 客户名称禁止包含路径分隔符（ /、 \）
• 客户名称最大长度 100 字符
• 输出目录限制在 agent workspace 内

无系统调用#

• ✅ 不使用 subprocess 执行系统命令
• ✅ 不使用 rm -rf 等危险操作
• ✅ 所有文件操作使用 Python 标准库

跨框架兼容#

• 自动检测 Hermes / OpenClaw 环境
• 使用各框架的标准工具集
• 路径使用环境变量或框架 API

---

质量检查清单#

生成 PPT 前自检：

• 每个场景都有具体的 before 痛点描述（不是空话）
• 每个场景都有具体的 after 价值描述（不是空话）
• 每个场景都有量化指标（时间/金额/百分比）
• 场景数量 4 个以上（覆盖客户主要业务）
• 语言是客户业务语言，不是厂商技术术语

---

重要声明#

关于用户确认#

执行调研前，如用户未明确要求立即执行， 应询问用户确认：

• "好的，开始调研 [客户名称]。是否需要我立即生成调研报告和 PPT？"
• 得到肯定回复后再执行搜索和生成

关于发送文件#

发送文件前必须：

• 确认用户已审查报告内容
• 明确告知接收人和发送渠道
• 不自动发送至第三方渠道

关于客户记忆#

客户记忆记录功能：

• 仅在用户明确要求时创建/更新记忆
• 记忆文件保存在用户可查看/删除的位置
• 不使用持久化记忆来影响其他任务