微盛企微管家SCRM

解决的问题

在企业微信客户运营中，客户、标签、客户群、素材、活码、群发、跟进记录、会话存档和商机往往分散在不同页面与表格里。工程师或运营想快速回答“最近 7 天新增客户是谁”“某客户有哪些标签和跟进记录”“某个活码背后的群发范围是什么”时，需要反复切后台、拼条件。本技能把这些问题转成可执行的查询与受控操作。

工作方式

• 业务化提问：可以直接说“查最近新增客户”“看客户标签、跟进和聊天情况”“整理客户群与群发情况”。
• 固定执行手册：触发后先读取 references/agent-runbook.md，按 check-env → check-identity 的顺序执行，不自行改流程。
• 查询与写操作分层：查询类需求可直接返回结论；创建、编辑、删除、发送等写操作必须等待用户确认。
• 接口调用有文档绑定：调用前先用 fetch-raw-doc 读取接口文档，缓存有效期约 2 小时；call-api 以 --doc-url 作为文档绑定参数，service_name、uri、method 由脚本补齐。
• 脚本化执行：普通命令使用 python3 scripts/scrm.py；只有需要继续解析 JSON 输出时，再使用 scripts/scrm_sdk.py。
• 对外表达克制：面向普通用户时优先说业务结论，不主动暴露 service_name、api_path、doc_url 等内部字段。

适用边界

• 需要企微管家 APP KEY，资料说明其保存在本地设备，不上传服务器；可通过重置 APP KEY 撤销授权。
• 在企微机器人场景中，如果尚未配置，可用对话上下文中的 sender_id 与 bot_id 自动申请并持久化；普通 CLI / IDE 场景仍需手动配置。
• 如果当前环境不能执行命令或脚本，需要先切换到可执行模式。
• 涉及图片、文件上传下载时，需要参考 references/file-utils.md，把本地文件转成可调用 URL。