Ec Customer Mgmt

---
name: ec-customer-mgmt
description: 客户搜索筛选（含按标签/分组/来源/进展等任意条件）、详情查看、创建编辑、可创建客户类型设置、转让/放弃/共享、客户查重、合并重复客户。用于：找客户、按条件筛选客户、看资料、改信息、设置允许创建的个人或企业客户、转交/放公海/共享、查重避免重复录入、合并重复客户。不用于：管理标签/打标签（→ec-customer-insights）、创建跟进/设待办（→ec-customer-sales）。
user-invocable: false
metadata:
   builtin_skill_version: "1.7"
description_zh: "客户搜索筛选（含按标签/分组/来源/进展等任意条件）、详情查看、创建编辑、可创建客户类型设置、转让/放弃/共享、客户查重、合并重复客户。用于：找客户、按条件筛选客户、看资料、改信息、设置允许创建的个人或企业客户、转交/放公海/共享、查重避免重复录入、合并重复客户。不用于：管理标签/打标签（→ec-customer-insights）、创建跟进/设待办（→ec-customer-sales）。"
description_en: "Search and view CRM customers; create, edit, transfer, discard, share, receive and merge customers; configure allowed customer types."
version: "1.7.0"
author: EC
---

# EC 客户核心管理 (Customer Management)

客户全生命周期的静态数据和状态流转。负责客户的创建、查询、基本信息修改、可创建客户类型设置以及权属变更（公海流转）。

## Use When
- 用户请求涉及客户搜索/筛选、客户详情、创建/修改客户、转让/放弃/共享客户。
- 用户请求查询或设置可创建的客户类型：个人客户、企业客户或都可以。
- 用户请求跨域时，本域部分由此 skill 处理。

## Avoid When
- 管理标签配置/给客户打标签/查画像 → `ec-customer-insights`
- 创建跟进/待办/工作报告 → `ec-customer-sales`
- 电话/联系记录/质检/话术复盘 → `ec-customer-contact`
- 查询工商数据 → `ec-customer-business`
- 订单搜索/回款/编辑订单 → `ec-order-mgmt`

## 功能索引

| 意图关键词 | 执行功能 | 调用命令获取流程，严格执行 |
|---------|--------|---------|
| 找/搜/查/筛选/有没有 + 客户 | 筛选/搜索 | `ec-crm flow customer-search --help` |
| 看详情/查资料/进展/是谁 | 查询详情 | `ec-crm flow customer-detail --help` |
| 新建/创建/修改/更新 + 客户/信息 | 创建/修改 | `ec-crm flow customer-create-update --help` |
| 转让/转给 + 客户 | 转让 | `ec-crm flow customer-move --help` |
| 放弃/放公海/退回 + 客户 | 放弃 | `ec-crm flow customer-discard --help` |
| 共享/分享给 + 客户 | 共享 | `ec-crm flow customer-share --help` |
| 领取+客户 | 领取 | `ec-crm flow customer-receive --help` |
| 查重/重复/重名/是否已有 + 客户 | 查重 | `ec-crm flow customer-repeat --help` |
| 合并/去重合并/合并重复 + 客户 | 合并重复客户 | `ec-crm flow customer-merge --help` |
| 设置/切换/查看 + 可创建客户类型 | 查询或设置可创建客户类型 | `ec-crm flow customer-create-type --help` |

## 意图拆分

当用户意图跨多个域时：
- "找到XX并打标签" → 本 skill 执行「筛选/搜索」获取 crmId，再转 `ec-customer-insights` 执行「修改标签」。
- "修改XX信息并记跟进" → 本 skill 执行「创建/修改」，再转 `ec-customer-sales` 执行「创建跟进」。
- "找到XX并打电话" → 本 skill 执行「筛选/搜索」获取 crmId，再转 `ec-customer-contact` 执行相应功能。
- 设置可创建客户类型时，先确认用户明确选择了个人客户、企业客户或都可以；未明确时必须询问，不得猜测默认值。
- 将客户类型映射为：个人客户 `0`、企业客户 `1`、都可以 `2`。按 `ec-crm flow customer-create-type --help` 获取流程并严格执行。
- 多步骤任一失败 → 停止后续步骤，告知用户已完成与未完成的内容。

## 硬约束

### ⛔ 铁律：ec-crm 报错即停。以下规则不可协商，不可绕过。

| 错误类型 | 识别 | 行动 | 严禁 |
|--------|------|------|------|
| **命令不存在** | `command not found` 或找不到这个命令 | 停止调用，引导用户在 WorkBuddy 中安装或重新连接 EC CRM 连接器；由宿主管理安装环境，不自行全局安装 | — |
| **入参错误** | 参数格式/值不合法 | 读错误 → 修正 → 重试（≤2次）；超限后停并告知正确格式 | 猜参/删参/填默认值 |
| **业务错误** | 权限不足/客户不存在/状态不允许 | 立即停，原样展示错误 | 重试/换命令/绕路 |
| **结果为空** | 命令正常退出但数据为空 | 告知「查询无结果」，结束 | 换条件重查/扩大范围 |
| **数据错误** | 字段缺失/格式异常/空数据 | 立即停，告知数据异常 | 跳过/补全字段 |
| **flow 命令限制** | 调用 `ec-crm flow` 相关命令 | 只能携带 `--help` 参数 | 传入任何其他参数或选项 |

> **任何未列出的错误 → 一律视为"停"。**

### 注意
- 当执行命令的返回结果过长，被系统截断时，主动去读取完整数据文件内容，确保后续步骤使用完整数据。

## 跨会话恢复
- 继续上次任务时，先使用当前对话中可核对的条件和对象标识；仅在宿主实际提供历史检索能力时使用该能力。标识缺失或无法确认时按本域查询流程重新定位；客户标识通过 `ec-customer-mgmt` 查询，多候选时请用户选择，不猜测或复用未核实的 ID。

## 连接与授权

- 在 WorkBuddy 的 EC CRM 连接器已连接后调用；未登录、登录过期或认证失败时停止业务操作，引导用户重新连接。权限不足按业务错误处理，不反复登录或绕过权限。
- 业务写入只执行用户已明确要求或确认的动作、对象及范围；信息不明确时先询问。已有明确授权无需重复确认，后续步骤不得扩大授权范围。
- 合并客户前核对保留客户与被合并客户；转让、共享或放弃客户前核对对象、接收人及范围。只有用户已明确授权相应动作和目标时才执行，否则先询问。
- 按实际返回结果说明已完成内容；写入结果不明或超时先核实状态，不盲目重复写入。错误信息保留错误码和业务原因，隐藏 Token、密钥等凭证。
- `ec-crm flow <功能名> --help` 用于取得流程说明，只携带 `--help`；实际业务命令、参数、必填项和返回结构按取得的说明执行，不猜写命令。