技能介绍

从自然语言到数据操作

当你需要把「加个客户」「出本周报告」这样的日常指令变成可执行的 CRM 操作时，这个 skill 帮你跨过三个坎：理解中文意图、映射 CRM 枚举 ID、生成可读的分析结果。它不直接改数据库，而是通过自研 MCP-server 中转，让 agent 用统一接口操作询盘云的五个核心对象。

写入与修改：五种对象的统一入口

支持 lead、customer、opportunity、contact、followUpRecord 的新增和更新。中文字段会自动转换：owner_username="梁剑" → ownerId=304737，country="美国" → country=183430，转换规则基于本地缓存表，避免硬编码。跟进记录支持通过 --customer 或 --lead 关联对象，--type 参数默认「电话沟通」。

分析报告：三步前置的统计 SOP

做数据分析前必须按顺序完成：增量更新同步、查看字段定义、对照中文↔ID 映射。这三步不能跳过，因为 MySQL 落的是物理字段 + 枚举 ID，且同步存在 10 分钟延迟窗口。所有 --since/--until 时间窗口统计一律以 createdTime（询盘云真实创建时间）为准，绝不能用 created_at 或 synced_at。最终报告会生成暗色商务风 HTML，包含转化漏斗、TOP 销售、Pipeline 等模块，自包含可离线打开。

适用边界与安全分层

凭证分级是关键：API URL、企业 ID、client_secret 等核心凭据藏在云 MCP-server，skill 只持有 demo 账密和只读 MySQL 权限。配置文件按用户工作目录隔离（./.crm/config.json），skill 包只含模板不存真实配置。环境要求 Python 3.11+ 和 pymysql，网络需可达 MCP-server 和云 MySQL。