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 时能说"这就是我们现在的痛点"

执行流程

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

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

获取客户名称 - 从用户输入中提取客户全称（输入验证：禁止路径字符，最大 100 字符）
执行搜索 - 使用 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轮
整理搜索结果 - 将搜索结果按维度整理，标注信息来源链接
生成报告 - 基于实际搜索结果生成调研报告（Markdown 或 Word 格式）
- 禁止编造信息，无结果时明确告知"公开渠道未检索到"
- 禁止输出"待搜索"占位符，必须填充实际内容
生成 PPT - 基于实际调研结果生成场景破冰 PPT
- ⚠️ ASI09 合规要求：PPT 场景必须基于实际搜索结果选择和定制
- 禁止跳过调研直接生成通用模板
- 先生成 research_results.json（调研结果），再传给 PPT 生成脚本
- 场景选择要贴合客户行业和调研发现
- 每个场景必须有 before/after 对比和量化指标
记录到客户记忆 - memory/customers/[客户名称].md（可选）
发送交付物 - 通过 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？"
得到肯定回复后再执行搜索和生成

关于发送文件

发送文件前必须：

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

关于客户记忆

客户记忆记录功能：

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