下载地址
https://www.zhengdianxue.com/wp-content/uploads/skills/org-r4wuabfo--crm-work-mgmt.zip将提示词发送给你的 AI 安装该 skills
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-r4wuabfo/crm-work-mgmt。35CRM 工作管理模块,涵盖日程管理和日报/周报/月报生成。
阅读全文 (展开查看完整说明)
概述
CRM 工作管理
本技能完全独立,内置登录认证流程,无需加载其他技能。
参考文档索引
| 分类 | 文件 | 说明 |
|---|---|---|
| 认证 | [authentication.md](references/authentication.md) | Token 认证流程、请求规范 |
| 基础 | [base.md](references/base.md) | 工具函数、编码规范 |
| 枚举 | [enums.md](references/enums.md) | 时间常量、dbType、searchCondition 通用结构 |
| 日程管理 | [schedule.md](references/schedule.md) | 查询/创建日程、日程枚举值 |
| 日报/周报/月报 | [report-workflow.md](references/report-workflow.md) | 报告自动生成工作流(直接走此流程,无需查 view/form) |
第一步:收集凭据(每次对话开始时)
尚未获取凭据时,使用 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 /schedule/list | schedule.md |
| 新增日程 | POST /schedule/insert(通用表单流程) | schedule.md |
| 生成日报 | POST /planSummary/insert | report-workflow.md |
| 生成周报 | POST /planSummary/insert | report-workflow.md |
| 生成月报 | POST /planSummary/insert | report-workflow.md |
报告生成规则(重要)
⚠️ 日报/周报/月报不需要先查 view/form 获取字段。
planSummary/insert的参数已在 report-workflow.md 中完整列出,直接按步骤执行即可。通用表单流程(view/form → template → insert)仅适用于日程新增等其他业务模块。
报告类型速查
| 用户说 | 数据汇总范围 | type | operationId |
|---|---|---|---|
| 生成日报 | 当天数据 | 1 | plan_summary_day_add |
| 生成周报 | 本周数据 | 2 | plan_summary_week_add |
| 生成月报 | 本月数据 | 3 | plan_summary_month_add |
脚本工具
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 schedule
--limit 25crm_form_submit.py — 通用表单提交(使用 Token)
# 仅查看模板
python scripts/crm_form_submit.py
--base-url https://xxx
--token xxx
--view-id ScheduleAdd
--template-only
# 提交新增
python scripts/crm_form_submit.py
--base-url https://xxx
--token xxx
--view-id ScheduleAdd
--data '{"name":"测试日程"}'generate_reports.py — 报告一键生成
python scripts/generate_reports.py day week month
--base-url <base_url>
--token xxx
--emp-id <emp_id>
--dry-run # 仅预览,不提交关键注意事项
- 中文编码:所有含中文的请求必须通过 Python 脚本执行,不能用 Bash 直接 curl(详见 base.md)
- multipart 请求:使用
curl --data-binary @-通过 subprocess 发送 - 日程时间格式:查询参数使用 ISO 8601(
2026-06-01T00:00:00.000Z),与其他模块的Y-m-d H:i:s不同 - 查询本人日程:需附加
owner=emp_id(登录返回的data.id) - 新增日程日期:提交格式必须为
Y-m-d H:i:s(含时间部分) - 响应数据位置:解析时用
resp.get('rows') or resp.get('data') or []