CGL SCRM  /  skill

技能包

WorkBuddy / 豆包 直连通道

这是什么

一句话：一个压缩包，装到 AI 助手里面，那位同事的 AI 就会用这套系统了。

市场部同事不需要懂技术。拿到这个包、按手册装一次，之后他就可以直接对自己的 AI 助手说： 「帮我查一下这个月北京的 A 级线索」「把上周活动的报名名单导出来」—— AI 自己会去系统里取，把结果讲给他听。

4
包里的文件
1153 行 / 50,200 字节
7
命令组
见下方清单
21
AI 能调的动作
另一条通道
11
权限档位
按业务动作切

包里有什么

文件行数体积干什么的
SKILL.md 227 9,085 B 说明书本体：AI 打开这个包先读它，照着做
references/api.md 111 6,465 B 接口速查表
scripts/cgl_scrm.py 651 28,918 B 命令行工具本体（只用 Python 自带的东西，不用装任何依赖）
scripts/cgl_scrm_mcp.py 164 5,732 B MCP 通道的转接脚本
刻意做得很小、很自足。整个包只有 4 个文件、1153 行， 而且不依赖任何第三方库——只要能跑 Python 的电脑就能用。 这样市场部同事装的时候，不会卡在「装依赖」这一步上。

两条通道，用哪条都行

装一次就同时具备。AI 助手支持哪个就用哪个，底层是同一套接口、同一套权限。

① 命令行
AI 在同事电脑上跑几条命令。
优点：哪儿都能用，只要能跑 Python。
适合：需要把结果存成文件、或者跟别的脚本配合。
② 远程连接（MCP）
填一个网址 + 一把钥匙，21 个动作自动出现在对话里。
优点：同事完全无感，AI 自己就用上了。
适合：WorkBuddy、豆包这类支持 MCP 的助手。 
# 通道二的配置（就这三行，贴到 AI 助手的 MCP 配置里）
{
  "mcpServers": {
    "cgl-scrm": {
      "url": "https://scrm.jxccwx.com/mcp",
      "headers": { "X-API-Key": "cgl_发给你的钥匙" }
    }
  }
}

命令行能做什么

下面是这套工具真正支持的命令——不是手册里抄的，是从程序里读出来的。 （这件事专门试过两种办法：按代码文本去搜，一条都搜不到； 改成直接问程序自己，才拿到这 7 组。教训是「搜到 0 条」和「本来就没有」要分清楚。）

命令组可以做的动作可选项
whoami 直接运行，没有子动作 1
leads list show duplicates remark status tags behavior export 24
events list show signups signup 11
surveys list schema answers 4
stats 直接运行，没有子动作 3
qrcodes 直接运行，没有子动作 3
raw 直接运行，没有子动作 4

最常见的几条

# 先自检：钥匙通不通、有什么权限（每次都建议先跑这条）
python3 "$S" whoami

# 查线索
python3 "$S" leads list --grade A --city 北京 --size 50

# 看某个活动的报名名单
python3 "$S" events signups 1943

# 看整体数据概况
python3 "$S" stats overview --days 30

# 任何命令加 --json，就输出原始数据，方便 AI 精确解析
python3 "$S" leads list --grade A --json

发钥匙这件事

同事要能用起来，需要拿到一把属于他自己的钥匙。原则是「一人一把」。

做法为什么
一人一把出事时能查到是谁的；某个人离职只吊销他自己那把，不影响别人。
只给需要的权限市场部同事默认给 manager；只做只读分析就给 viewer。
设上有效期到期自动失效，不用记得去回收。
明文只出现一次系统只存不可逆的摘要值。签发那一刻打印一次，之后谁也取不回来——丢了就重签。
不明文贴进文档手册、邮件正文里都不放钥匙。手册是可以随手转发的，钥匙不能。
一个已经暴露过的教训：之前手册草稿里一度直接写着一位同事的钥匙明文。 现在改成用占位符，交付时单独给。 同一个原因，仓库里那把钥匙的副本也已经删掉了——一封能随便转发的文档，不该带着别人的钥匙。

同事拿到手大概长这样

同事：帮我看看这个月北京的 A 级线索有多少

AI：（调用 cgl_leads_search）
      这个月北京地区 A 级线索共 23 条，其中 18 条还在跟进中。
      要我把名单列出来吗？

同事：列出来，顺便看一下谁负责的

AI：（调用 cgl_leads_search + cgl_lead_get）
      已列出 23 条。负责人分布：王顾问 9 条、李顾问 7 条、其余 7 条暂未分配。
      ⚠️ 手机号我这边看到的是打码的（138****9999）——
      需要完整号码的话，得让管理员给你的钥匙加上「看真实号码」这一档权限。

最后那句提示是系统层面加的限制，不是 AI 自己客气—— 钥匙没有那一档权限，接口就不会把真实号码发出来。