下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-r4wuabfo--crm-salechance-mgmt.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-r4wuabfo/crm-salechance-mgmt。35CRM 商机管理模块,涵盖销售商机、商机跟进、商机任务、报价管理四大功能。
阅读全文 (展开查看完整说明)
概述
CRM 商机管理
参考文档索引
| 分类 | 文件 | 说明 |
|---|---|---|
| 认证 | [authentication.md](references/authentication.md) | Token 认证流程、请求规范 |
| 基础 | [base.md](references/base.md) | 工具函数、编码规范 |
| 枚举 | [enums.md](references/enums.md) | 时间常量、dbType、searchCondition 通用结构 |
| 销售商机 | [sale_chance.md](references/sale_chance.md) | 查询销售商机列表、新增销售商机 |
| 商机跟进 | [sale_chance_follow.md](references/sale_chance_follow.md) | 查询商机跟进列表、新增商机跟进 |
| 商机任务 | [chance_task.md](references/chance_task.md) | 查询商机任务列表、新增商机任务 |
| 报价管理 | [quotation.md](references/quotation.md) | 查询报价管理列表、新增报价管理 |
第一步:收集凭据(每次对话开始时)
尚未获取凭据时,使用 AskUserQuestion 工具一次性收集 2 个参数:
AskUserQuestion({
questions: [
{ header: "平台地址", question: "CRM 平台的 base_url 是什么?",
options: [{ label: "在下方输入平台地址", description: "例如 https://crm.example.com" }] },
{ header: "Token", question: "API Token (PAT) 是什么?",
options: [{ label: "在下方输入 Token", description: "在下方粘贴 Token 字符串" }] },
]
})收集到凭据后,调用 scripts/crm_login.py 验证 Token 有效性:
python scripts/crm_login.py n --base-url <base_url> n --token <token>验证成功输出 JSON:{"success": true, "token": "...", "base_url": "..."}
凭据在当前会话中复用,不要重复询问。
常见操作速查
| 操作 | 接口 | 参考文档 |
|---|---|---|
| 查询销售商机列表 | POST /saleChance/list | sale_chance.md |
| 新增销售商机 | viewId=SaleChanceAdd → POST /saleChance/insert | sale_chance.md |
| 查询商机跟进列表 | POST /saleChanceFollow/list | sale_chance_follow.md |
| 新增商机跟进 | viewId=SaleChanceFollowAdd → POST /saleChanceFollow/insert | sale_chance_follow.md |
| 查询商机任务列表 | POST /chanceTask/list | chance_task.md |
| 新增商机任务 | viewId=ChanceTaskAdd → POST /chanceTask/insert | chance_task.md |
| 查询报价管理列表 | POST /quotation/list | quotation.md |
| 新增报价管理 | viewId=QuotationAdd → POST /quotation/insert | quotation.md |
脚本工具
crm_login.py — 验证 Token
python scripts/crm_login.py n --base-url https://xxx n --token xxx输出:{"success": true, "token": "...", "base_url": "..."}
crm_query.py — 通用查询(使用 Token)
python scripts/crm_query.py
--base-url https://xxx
--token xxx
--module-id sale_chance
--limit 25crm_form_submit.py — 通用表单提交(使用 Token)
# 仅查看模板
python scripts/crm_form_submit.py
--base-url https://xxx
--token xxx
--view-id SaleChanceAdd
--template-only
# 提交新增
python scripts/crm_form_submit.py
--base-url https://xxx
--token xxx
--view-id SaleChanceAdd
--data '{"name":"测试商机"}'关键注意事项
- 中文编码:所有含中文的请求必须通过 Python 脚本执行,不能用 Bash 直接 curl(详见 base.md)
- multipart 请求:使用
curl --data-binary @-通过 subprocess 发送 - 日期格式:提交格式必须为
Y-m-d H:i:s(含时间部分),如2026-06-05 00:00:00 - 响应数据位置:解析时用
resp.get('rows') or resp.get('data') or [] - 新增操作:使用通用表单流程(
scripts/crm_form_submit.py):view/form → 解析字段 → insert