Customer Research

客户调研与竞品情报技能 - 自动生成 Word 调研报告和场景破冰 PPT（before/after 对比）。支持客户背景调研（4维度）和竞品情报/采购记录查询（可选第5维度）。

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轮

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

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

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

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

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

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

7. 发送交付物 - 通过 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？"
• 得到肯定回复后再执行搜索和生成

关于发送文件

发送文件前必须：

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

关于客户记忆

客户记忆记录功能：

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