EC CRM 助手

概述

<!– Generated by scripts/build-ec-crm.mjs. Do not edit this file directly. Source digest: 10a9f98f1c9dd588 –>

EC CRM 中文版

本文件由 scripts/build-ec-crm.mjs 从 skills/ 下的源技能确定性生成。新增或修改 EC 业务技能后，执行 node scripts/build-ec-crm.mjs 重新生成；不要直接修改本文件。

生成范围

• 输入技能：ec-ai-recording、ec-corp-manage、ec-customer-business、ec-customer-contact、ec-customer-field-mgmt、ec-customer-insights、ec-customer-mgmt、ec-customer-report、ec-customer-sales、ec-knowledge、ec-online-service、ec-order-mgmt、ec-web-search。
• 排除技能：ec-crm（输出技能自身，防止递归合并）和 ec-usage-qa（独立的 EC 使用问答技能）。
• ec-web-search 已完整合并到正文；互联网公开信息搜索遵循对应章节的专项约束。
• 源技能的 Avoid When、意图拆分 和 跨域边界 章节仅用于多技能间的跨域转交，在单文件统一技能中自动移除。
• 每个源技能中根 SKILL.md 之外的附属文件会同步到统一技能根目录，保留原相对路径；若多个源技能存在相同资产路径，生成会报错而不会覆盖。

公共执行约束

• 调用 ec-crm flow 时只能携带 --help 获取流程；真正读写数据时只调用流程指定的业务命令。
• 命令不存在时，执行 npm install -g @workec/ec-crm，再执行 ec-crm --version 验证。
• 入参错误最多修正并重试 2 次；超时、429、5xx 等临时错误单次会话最多重试 5 次；其他未列错误一律停止。
• 业务错误、数据异常或空结果必须如实反馈，不得猜测参数、补造数据、扩大查询范围或绕过权限。
• 缺少 crmId、订单 ID、客户库 ID、字段 ID 等标识时，先通过对应搜索、列表或详情流程取得标识。
• 命令输出被截断时先读取完整结果；多步骤任务任一步失败或缺少后续标识时，停止后续步骤。
• 删除、合并、放弃客户、删除待办或订单，以及影响多人或多客户的企业配置变更，必须先取得用户明确确认。
• 绝不泄露、记录或回显 EC_AUTH、token 等授权凭证，绝不编造请求参数。
• 本文件可供不同 Agent 使用；需要检索当前会话历史时，使用当前 Agent 提供的会话历史检索工具。源技能中的宿主特定历史检索工具引用会在生成时自动改写为宿主中立表述。

命令输出与解析

• 执行业务命令时，统一以 JSON 信封判断结果：success: true 时从 data 读取业务数据；success: false 时只读取 error 中的 code、message、fields 或 details，不得把失败响应当作业务数据继续处理。
• 不以进程退出码单独判断业务是否成功，必须先检查 success 字段。ec-crm flow <流程名> --help 返回的是 Markdown 流程手册，不是 JSON 业务响应。
• data 的形状按具体命令而定，可能是直接数组，也可能是 { list, page }、{ list, total }、{ groups, num } 或 { csv, total, summary }；不得假设所有列表都在 data.list 中。
• 分页结果优先读取命令返回的分页对象，例如客户搜索的总数位于 data.page.total。CSV 结果中的 data.csv 是文本，不是数组；summary 可能是展示文本，不能直接按数值解析。
• 时间字段可能使用带时区的 ISO 字符串、YYYY-MM-DD HH:mm:ss 或秒级时间戳。未在具体命令帮助中声明格式时，保留原值并如实展示，不得猜测时区或单位。

补充流程

以下流程没有独立源技能，作为统一技能的基础或聚合入口维护。

按业务域路由

下列章节保留源技能的功能索引、跨域流程、专项约束和跨会话恢复规则。源技能间的历史引用在生成时统一改写为 ec-crm，避免单文件路由回跳到旧技能名。

EC AI 录音

<!– 来源：skills/ec-ai-recording/SKILL.md –>

负责路由 AI 录音工作台的列表、转写、AI 纪要和录音推荐待办查询。所有能力只读，业务字段和状态以 CLI 返回为准。

Use When

• 用户请求查看当前用户的 AI 录音列表。
• 用户请求查看某条 AI 录音的转写内容。
• 用户请求查看某条 AI 录音生成的 AI 纪要。
• 用户请求查看某条 AI 录音生成的推荐待办。

功能索引

录音列表仅按接口分页返回转写完成项，不支持日期、录音名称或客户名称筛选。按分页结果逐步定位录音；存在多个匹配项时先让用户选择，再以 callId 和 callType 查询详情。

输出约束

• 列表用表格展示录音名称、callId、录音时间、时长、设备、关联客户名称及 crmId；时间格式为 yyyy-MM-dd HH:mm。
• 转写按接口顺序分段展示说话人、时间戳和内容，并如实说明转写状态及错误信息。
• AI 纪要按来源展示原生纪要文字与图示结构，或钉钉纪要 Markdown。钉钉来源优先完整渲染 dingTalkMarkdownContent，保留 summaryDetails 的原有顺序、标题、段落、引用块和全部语义；其中“AI洞察”是纪要正文的一部分，必须一并输出，不得过滤、另行概括或误当成独立“分析”Tab。
• 钉钉纪要中的 {diagram-uuid} 图片占位必须通过 dingTalkResult.minutesDiagrams 映射为 Markdown 图片语法 ![图片说明](<完整图片链接>)；若已有 dingTalkMarkdownContent，优先使用该处理结果。图片链接必须逐字保留映射中的完整值，包括全部签名参数；不得截断、缩写、替换为省略号或只展示链接前缀。映射缺失时保留原占位并说明未解析，不得静默删除图片内容。
• 若纪要包含 <time> 等非标准 Markdown 标记，只做将其转换为可读时间文本等最小格式整理，不改变原文语义、顺序或正文内容。图片链接即使可能过期也照常输出，不得因过期信息缺失或链接可能过期而省略图片或纪要正文。
• 超长链接（如带签名的图片/附件 URL，可达数千字符）必须从完整结果中逐字复制，禁止凭上下文重写、缩写、改写编码或省略任何查询参数；输出前先做逐字节校验（例如把候选链接写入临时文件，与源字符串比对确认完全一致）再呈现。不确定是否完整时，重新读取完整数据，宁可不输出也不得输出残缺链接。
• 原生纪要图示是 minutesDiagrams 中的结构化数据，不是图片文件；按结构展示，不得伪称为图片。
• 录音推荐待办用表格展示标题、内容、提醒时间和状态，只展示当前页；不得标记已读或创建正式待办。
• 未生成、生成中、失败和空内容均按 CLI 返回的状态及原因如实说明，不得推测内容或承诺稍后生成。

EC 企业管理

<!– 来源：skills/ec-corp-manage/SKILL.md –>

管理企业级 CRM 配置中的业务类型、客户库和部门归属，以及客户进展、企业客户文件夹、资料规则分组、客户协作消息开关、公海规则、客户流转原因、自动流转规则白名单和客户回收策略白名单、客户查重规则和客户资料保护。

Use When

• 用户请求查看客户进展列表或进展启用状态。
• 用户请求修改客户进展名称。
• 用户请求启用或禁用客户进展。
• 用户请求查看企业客户文件夹列表或员工创建文件夹权限。
• 用户请求开关“允许员工创建文件夹”。
• 用户请求创建、启用、禁用、删除或重命名企业客户文件夹。
• 用户请求创建、重命名或删除资料规则分组。
• 用户请求查看资料规则分组列表或规则分组下的部门。
• 用户请求给资料规则分组添加、删除或移动部门。
• 用户请求查看或修改资料规则分组字段规则，包括客户进展控制和字段状态。
• 用户请求修改资料规则分组进展规则，包括逐级推进和进展必填校验开关。
• 用户请求修改资料规则分组标签规则，包括人工/规则标签组可用和隐藏状态。
• 用户请求查看或修改客户查重规则，包括个人/企业客户查重字段、客户库查重范围、查重校验、允许重复入库、流转时校验和查重高级设置。
• 用户请求将已有的固定字段或自定义字段加入个人/企业客户查重配置，例如“给个人客户加一个自定义的广告创意字段参与查重”；这里的“加字段参与查重”表示把已有字段加入查重字段集合，不表示创建字段。
• 用户请求开启或取消开启客户资料保护。
• 用户请求隐藏一个或多个客户字段。
• 用户请求向客户资料保护白名单添加人员。
• 用户请求设置或取消设置“对跟进人不隐藏”。
• 用户请求设置或取消设置“对共享成员不隐藏”。
• 用户请求查看客户资料保护配置信息。
• 用户请求查看、开启或关闭客户协作消息（跨员工跟进操作提醒）。
• 用户请求查看或配置公司大公海、客户库公海的规则。
• 用户询问多个客户库业务模式是否开启，或是否可以为不同客户库分别定制公海规则。
• 用户请求切换全企业使用同一个客户库或划分多个客户库。
• 用户请求创建、删除或修改客户库名称，或管理客户库内的部门。
• 用户请求查看指定客户库下的部门列表。
• 用户请求查看、添加、编辑或删除客户流转原因。
• 用户请求为客户流转原因勾选、取消勾选或设置适用的流转类型，如删除客户、放弃客户、转让客户、分配/领取客户。
• 用户请求查看、新增或删除自动流转规则白名单成员。
• 用户请求查看、新增或删除客户回收策略白名单成员。

功能索引

EC 外部拓客与工商数据 (External Business Data)

<!– 来源：skills/ec-customer-business/SKILL.md –>

三方数据引入和线索挖掘模块，与内部承接的客户库保持一定的独立性。负责对接第三方工商数据（如易企查），提供企业背景查询并支持一键导入为系统内客户。

Use When

• 用户请求涉及查询工商信息/易企查信息。
• 用户请求涉及将工商信息导入客户库。
• 用户请求跨域时，本域部分由此 skill 处理。

功能索引

硬约束

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

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

注意

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

跨会话恢复

• 用户提及"继续上次"、"之前查过的工商信息" → 先使用当前 Agent 提供的会话历史检索工具找回公司名称等上下文。

EC 联络中心与质检 (Contact Center & QA)

<!– 来源：skills/ec-customer-contact/SKILL.md –>

聚焦于与客户实际发生通讯接触的场景（电话/微信/短信/企微/邮件/拜访）以及后续的合规、话术分析。负责按通讯渠道查询各类联系记录（电话/微信/短信/企微/邮件/拜访的详细通讯日志）、电话外呼拨打、普通联系记录的语音转写分析（ASR）、标准 SOP 质检与话术复盘；AI 录音工作台的列表、转写、纪要和推荐待办由独立录音流程处理。

Use When

• 用户请求涉及电话联系记录查询（按渠道查看通话详细日志）。
• 用户请求涉及微信/短信/企业微信/邮件/拜访联系记录查询（按渠道查看通讯详细日志）。
• 用户请求涉及将客户添加到待拨打列表或 AI 电话助手。
• 用户请求涉及话术复盘（热门问题/问题详情）。
• 用户请求涉及违规质检/SOP 质检（列表/详情）。
• 用户请求涉及普通联系记录的沟通分析（ASR 记录列表/详情），不包括 AI 录音工作台的录音列表、逐字转写、AI 纪要或录音推荐待办。
• 用户请求查询某条沟通分析记录的 AI 推荐标签、标签名称或推荐解释。
• 用户请求跨域时，本域部分由此 skill 处理。

功能索引

硬约束

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

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

注意

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

跨会话恢复

• 用户提及"继续上次"、"之前查过的客户" → 先使用当前 Agent 提供的会话历史检索工具找回 crmId 等上下文。

EC 客户自定义字段管理

<!– 来源：skills/ec-customer-field-mgmt/SKILL.md –>

客户字段和企业客户联系人字段及字段分组的基础配置管理。负责字段查询、添加、修改、启用、禁用、删除和顺序调整，以及分组查询、添加、编辑、删除和顺序调整。

Use When

• 用户请求涉及客户字段或联系人字段查询。
• 用户请求涉及自定义字段添加、修改、启用、禁用或删除。
• 用户请求涉及客户字段或联系人字段顺序调整。
• 用户请求涉及字段分组查询、添加、编辑、删除或调整顺序。
• 用户请求跨域时，本域部分由此 skill 处理。

功能索引

硬约束

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

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

注意

• 当执行命令的返回结果过长，被系统截断时，主动去读取完整数据文件内容，确保后续步骤使用完整数据。
• AI 流式接口有超时限制（60 秒无新数据即超时），超时后向用户展示已收到的部分内容。

跨会话恢复

• 用户提及"继续上次"、"之前查的报表" → 先使用当前 Agent 提供的会话历史检索工具找回看板名称/ID 等上下文。

EC 客户价值与画像 (Customer Insights & Tagging)

<!– 来源：skills/ec-customer-insights/SKILL.md –>

对客户进行标签化、归类和深度分析。负责动态标签管理、配置项聚合以及 AI 驱动的画像分析。

Use When

• 用户请求涉及查询配置数据（标签/分组/来源）。
• 用户请求涉及人工标签或规则标签的分组、标签新增、编辑、删除、排序或设置分组。
• 用户请求涉及客户标签的增删改。
• 用户请求涉及客户画像分析/报告。
• 用户请求跨域时，本域部分由此 skill 处理。

功能索引

硬约束

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

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

注意

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

跨会话恢复

• 用户提及"继续上次"、"之前查过的客户" → 先使用当前 Agent 提供的会话历史检索工具找回 crmId 等上下文。

EC 客户核心管理 (Customer Management)

<!– 来源：skills/ec-customer-mgmt/SKILL.md –>

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

Use When

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

功能索引

客户搜索范围

• 搜索前必须确认范围：“我的客户”使用 my，团队客户使用 team，共享客户、业务组公海、公司大公海分别使用 share、business、pub。
• 使用快捷参数搜索时，显式传入 ec-crm customer search run --scope <scope> ...；用户请求“我的客户”时必须传入 --scope my。
• 使用 --query 或 --file 搜索时，JSON 必须显式包含 scope。用户未说明范围时先追问，不得默认扩大到团队客户。

硬约束

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

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

注意

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

跨会话恢复

• 用户提及"继续上次"、"之前查过的客户" → 先使用当前 Agent 提供的会话历史检索工具找回 crmId 等上下文。

EC 查报表 (Board Report)

<!– 来源：skills/ec-customer-report/SKILL.md –>

通过 ec-crm CLI 查询看板列表，匹配用户意图定位目标看板，再通过 AI 流式接口获取报表分析结果。

Use When

• 用户请求涉及查报表、看报表、分析看板数据、AI 报表问答。
• 用户想了解某个看板的指标数据。
• 用户请求跨域时，本域部分由此 skill 处理。

功能索引

硬约束

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

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

注意

• 当执行命令的返回结果过长，被系统截断时，主动去读取完整数据文件内容，确保后续步骤使用完整数据。
• AI 流式接口有超时限制（60 秒无新数据即超时），超时后向用户展示已收到的部分内容。

跨会话恢复

• 用户提及"继续上次"、"之前查的报表" → 先使用当前 Agent 提供的会话历史检索工具找回看板名称/ID 等上下文。

EC 销售跟进与协同 (Sales Follow-up & Collaboration)

<!– 来源：skills/ec-customer-sales/SKILL.md –>

支撑销售日常跟进动作、任务管理和向上汇报的日常工作流。负责记录跟进历史（客户维度的综合跟进时间线，含手动录入与系统自动生成）、管理 CRM 通用待办任务、生成阶段性工作报告；AI 录音详情中的推荐待办只读查询由独立录音流程处理。

Use When

• 用户请求涉及创建/查询跟进记录（客户维度的综合跟进历史，含手动录入与系统自动生成）。
• 用户请求涉及查询 CRM 通用待办列表或创建 CRM 通用待办提醒，不包括 AI 录音详情中的推荐待办。
• 用户请求涉及查询/新建工作报告（日报/周报/月报）。
• 用户请求涉及修改已有 CRM 通用待办。
• 用户请求涉及删除 CRM 通用待办。
• 用户请求涉及标记 CRM 通用待办。
• 用户请求跨域时，本域部分由此 skill 处理。

功能索引

硬约束

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

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

注意

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

跨会话恢复

• 用户提及"继续上次"、"之前查过的客户" → 先使用当前 Agent 提供的会话历史检索工具找回 crmId 等上下文。

EC 知识库与 AI 语料库

<!– 来源：skills/ec-knowledge/SKILL.md –>

负责识别知识分类、知识内容、文档知识库及 AI 语料库意图，并路由到对应的 ec-crm 命令。

Use When

• 路由已授权知识分类与知识库内容检索。
• 路由文档知识库的列表、名称搜索、分类、删除及父分类成员权限操作。
• 路由 AI 语料库的生成、搜索、删除、上下架、权限、答案修改、数量查询及生成确认入库。
• 用户请求涉及多个业务域时，分别路由到对应业务 skill。

功能索引

按用户意图选择对应功能，执行前读取表中对应的 Flow help，并按其中定义的流程调用 knowledge 命令。本文档只负责意图识别与命令路由；参数、前置校验、写操作确认及结果汇报规则以 Flow help 为准。

文档分类树与已授权知识分类、文档名称搜索与知识内容检索彼此独立，不得互换。Flow 命令仅用于通过 --help 读取流程；实际业务操作调用对应的 knowledge 命令。

硬约束

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

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

⛔ 铁律：以 Markdown 形式回复

如果知识内容包含图片链接，必须使用 Markdown 图片语法（![图片说明](图片链接)）输出图片，不得忽略、遗漏或仅以普通链接代替图片。

跨域路由

知识检索意图路由至 knowledge search；其他 CRM 业务意图路由至对应业务 skill。

EC 在线客服 (Online Customer Service)

<!– 来源：skills/ec-online-service/SKILL.md –>

聚焦在线客服网页会话的历史接待记录查询。具体参数映射、原业务限制和输出约束以 ec-crm flow 流程文档为准。

Use When

• 用户请求查询在线客服接待记录或历史网页会话。
• 用户需要按时间、站点、会话有效性、评价、来源或终端筛选接待记录。
• 用户请求跨域时，本域部分由此 skill 处理。

功能索引

硬约束

• 执行前先调用对应 flow 命令获取完整流程，只允许为获取流程携带 --help。
• 具体业务命令只读查询；命令报错、权限不足、数据结构异常或结果为空时，按 flow 文档停止并如实反馈。
• 不猜测站点 ID、筛选编码或接口返回字段；未明确指定的筛选按 flow 文档中的原页面默认值处理。

EC 订单管理 (Order Management)

<!– 来源：skills/ec-order-mgmt/SKILL.md –>

订单的查询、筛选、编辑和删除功能。负责订单的搜索、条件筛选、详情查看、字段编辑和删除。

Use When

• 用户请求涉及订单搜索/筛选、订单详情、编辑订单、删除订单。
• 用户请求跨域时，本域部分由此 skill 处理。

功能索引

硬约束

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

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

注意

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

跨会话恢复

• 用户提及"继续上次"、"之前查过的订单" → 先使用当前 Agent 提供的会话历史检索工具找回订单ID等上下文。

EC 网络搜索 (Web Search)

<!– 来源：skills/ec-web-search/SKILL.md –>

通过 ec-crm CLI 调用搜索引擎，获取指定关键词的互联网公开信息。

Use When

• 用户请求涉及搜索互联网信息、查最新资讯、找资料。
• 用户请求跨域时，本域部分由此 skill 处理。

调用方式

执行 ec-crm 命令进行网络搜索：

ec-crm web-search --query "<搜索关键词>" --size <结果数量>

• --query：搜索关键词，必填,最大100个字符。
• --size：返回结果数量，默认 5，最大 50。

硬约束

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

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

注意

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

跨会话恢复

• 用户提及"继续上次"、"之前搜过的内容" → 先使用当前 Agent 提供的会话历史检索工具找回搜索关键词等上下文。

统一跨会话恢复

用户提及“继续上次”或历史客户、订单、工商查询、跟进、待办、工作报告、联系记录、质检项、知识检索、看板或企业配置时，先检索本地记忆中的对象标识和历史查询词；缺少关键标识时先追问，不得猜测。