Customer Research

SKILL.md

---
name: customer-research
description: 客户调研与竞品情报技能 - 自动生成 Word 调研报告和场景破冰 PPT（before/after 对比）。支持客户背景调研（4维度）和竞品情报/采购记录查询（可选第5维度）。
version: 1.3.2
author: Dick Dunkel
license: MIT-0
tags: [sales, meddic, research, ppt, word, secure, competitor-intel]
category: sales
created_by: agent
---

# 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？"
- 得到肯定回复后再执行搜索和生成

### 关于发送文件
发送文件前必须：
- 确认用户已审查报告内容
- 明确告知接收人和发送渠道
- 不自动发送至第三方渠道

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