lark-workflow-crm

name lark-workflow-crm version 1.1.0 description 微型团队CRM：基于飞书多维表格的客户管理、商机漏斗、跟进记录、看板视图、仪表盘和自动化提醒。当用户需要以下操作时触发：系统搭建（'创建CRM'、'搭建销售管理系统'、'新建CRM系统'）；客户管理（'新增客户'、'客户建档'、'客户列表'、'修改客户'、'删除客户'）；商机管理（'创建商机'、'商机列表'、'商机跟进'、'推进商机'、'赢单'、'丢单'）；跟进记录（'记录跟进'、'跟进记录'、'销售日报'、'沟通记录'）；漏斗查询（'销售漏斗'、'商机阶段'、'本月赢单'、'业绩统计'）；自动化提醒（'跟进提醒'、'超时预警'、'赢单报喜'、'周报'）；表单收集（'创建客户登记表'、'咨询表单'）；仪表盘（'销售看板'、'创建仪表盘'）。 metadata {"requires":{"bins":["lark-cli"]}} 微型团队 CRM 工作流 CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md ，其中包含认证、权限处理 适用场景 "帮我创建一个CRM系统" / "搭建销售管理" / "新建CRM" "新增客户：北京星辰科技，对接人王总" / "客户建档" "给北京星辰创建商机：ERP采购，50万" / "商机跟进" "跟进记录：今天电话联系了王总，约下周三面访" "看看销售漏斗" / "本月赢单了多少" / "业绩排行" "生成今天的销售日报" / "本周跟进汇总" "创建客户登记表单" / "咨询表单" "创建销售看板" / "销售仪表盘" "跟进提醒" / "超时预警" / "赢单报喜" / "每周销售简报" 前置条件 仅支持 user 身份 。执行前确保已授权： lark-cli auth login --domain base,im,contact 系统架构 微型团队 CRM (lark-workflow-crm) │ ├── 数据层：飞书多维表格 (Bitable) │ ├── 客户信息主表 (customers) — 客户档案 │ ├── 商机管理表 (opportunities) — 销售漏斗 │ └── 跟进记录表 (follow_ups) — 沟通记录 │ ├── 计算层 │ ├── 赢单概率建议 (formula) — 根据商机阶段自动建议概率 │ ├── 商机天数 (formula) — 距商机创建的天数 │ ├── 客户商机数量 (formula) — 关联商机计数 │ ├── 客户累计赢单金额 (formula) — 关联赢单金额汇总 │ └── 商机跟进次数 (formula) — 关联跟进计数 │ ├── 关联关系（双向） │ ├── customers ↔ opportunities — 一个客户多个商机 │ ├── customers ↔ follow_ups — 跟进记录关联客户 │ └── opportunities ↔ follow_ups — 跟进记录关联商机 │ ├── 视图层 │ ├── 商机阶段看板 (Kanban) — 按阶段分列拖拽 │ ├── 我的商机 — 当前用户负责的商机 │ ├── 跟进时间线 — 按时间倒序的跟进记录 │ └── 本月赢单 — 当月赢单列表 │ ├── 仪表盘 │ ├── 销售漏斗 (funnel) — 各阶段商机数量 │ ├── 本月赢单金额 (statistics) — SUM WHERE 阶段=赢单 │ ├── 商机总金额 (statistics) — 在途商机金额 │ ├── 客户数量 (statistics) — 总客户数 │ ├── 阶段分布 (pie) — 各阶段占比 │ ├── 负责人业绩排行 (column) — 赢单金额排行 │ └── 本周跟进 (table) — 本周跟进记录 │ ├── 表单 │ └── 客户咨询登记表 — 客户自助提交咨询 │ ├── 交互层：用户自然语言指令 │ ├── 系统初始化 → 创建 Base + 表 + 字段 + 关联 + 视图 + 仪表盘 + 表单 │ ├── 日常操作 → 客户建档 / 商机管理 / 跟进记录 │ └── 数据分析 → 漏斗查询 / 业绩统计 / 销售日报 │ └── 通知层：飞书消息 ├── 每日跟进提醒 ├── 超时未跟进预警 ├── 赢单报喜通知 └── 每周销售简报 Agent 核心规则 只使用 lark-cli base +... 原子命令 — 不走 lark-cli api 直接调用 建表必须先建空表再逐个加字段 — +table-create 不带 --fields 参数，先建空表再用 +field-create 逐个加字段，每次间隔 1.5 秒 关联字段必须使用双向关联 — bidirectional: true ，否则无法在公式中做跨表聚合 跨表计算优先使用 formula 字段 — 公式字段是 lookup 的超集，能用 formula 就不用 lookup 公式字段创建前先读 guide — 读取 ../lark-base/references/formula-field-guide.md +data-query 的 table-id 放在 DSL 中 — 不支持 --table-id 参数，需放在 --dsl 的 datasource.table.tableId 中 +data-query 只支持存储字段 — 不支持公式字段、lookup 字段、关联字段做聚合 写记录前先拿字段结构 — +field-list 确认字段名和类型 表名/字段名精确匹配 — 禁止凭自然语言猜测，必须来自 +table-list / +field-list 返回值 +xxx-list 禁止并发 — 所有 list 命令串行执行 写入串行 + 间隔 — +record-upsert 串行，间隔 0.5-1 秒 分页拉取 — +record-list --limit 200 ，用 offset 分页 跟进记录中提及阶段变更时同步更新商机 — 用户说"推进到方案报价"时，更新对应商机的商机阶段字段 创建仪表盘前先读 guide — 读取 ../lark-base/references/dashboard-block-data-config.md 创建表单前先读 guide — 读取 ../lark-base/references/lark-base-form-create.md Phase 1：系统初始化 Step 1.1: 创建 Base lark-cli base +base-create --name "微型团队CRM" --as user 记录返回的 base_token （后续所有命令需要）。 Step 1.2: 创建数据表（先建空表，间隔 2 秒） IMPORTANT ：不要使用 --fields 参数一次性创建多字段，容易触发限流。 # 表 1：客户信息主表 lark-cli base +table-create --base-token "<base_token>" --name "客户信息" --as user sleep 2 # 表 2：商机管理表 lark-cli base +table-create --base-token "<base_token>" --name "商机管理" --as user sleep 2 # 表 3：跟进记录表 lark-cli base +table-create --base-token "<base_token>" --name "跟进记录" --as user Step 1.3: 获取各表 table_id lark-cli base +table-list --base-token "<base_token>" --as user 记录各表的 table_id 。 Step 1.4: 逐个添加存储字段（每创建一个间隔 1.5 秒） 客户信息表字段 lark-cli base +field-create --base-token "<base_token>" --table-id "<customers_table_id>" --json '{"type":"text","name":"客户名称"}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<customers_table_id>" --json '{"type":"select","name":"客户类型","multiple":false,"options":[{"name":"个人客户"},{"name":"企业客户"}]}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<customers_table_id>" --json '{"type":"text","name":"联系人"}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<customers_table_id>" --json '{"type":"text","name":"手机号","style":{"type":"phone"}}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<customers_table_id>" --json '{"type":"text","name":"邮箱","style":{"type":"email"}}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<customers_table_id>" --json '{"type":"select","name":"行业","multiple":false,"options":[{"name":"互联网"},{"name":"金融"},{"name":"教育"},{"name":"制造业"},{"name":"零售"},{"name":"其他"}]}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<customers_table_id>" --json '{"type":"select","name":"公司规模","multiple":false,"options":[{"name":"1-10人"},{"name":"11-50人"},{"name":"51-200人"},{"name":"200人以上"}]}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<customers_table_id>" --json '{"type":"select","name":"来源渠道","multiple":false,"options":[{"name":"主动咨询"},{"name":"转介绍"},{"name":"展会"},{"name":"线上广告"},{"name":"社群"},{"name":"其他"}]}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<customers_table_id>" --json '{"type":"text","name":"地址"}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<customers_table_id>" --json '{"type":"user","name":"负责人","multiple":false}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<customers_table_id>" --json '{"type":"select","name":"重要程度","multiple":false,"options":[{"name":"高"},{"name":"中"},{"name":"低"}]}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<customers_table_id>" --json '{"type":"select","name":"客户状态","multiple":false,"options":[{"name":"活跃"},{"name":"沉睡"},{"name":"流失"}]}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<customers_table_id>" --json '{"type":"text","name":"备注"}' --as user sleep 2 商机管理表字段 lark-cli base +field-create --base-token "<base_token>" --table-id "<opportunities_table_id>" --json '{"type":"text","name":"商机名称"}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<opportunities_table_id>" --json '{"type":"number","name":"商机金额","style":{"type":"currency","precision":2,"currency_code":"CNY"}}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<opportunities_table_id>" --json '{"type":"select","name":"商机阶段","multiple":false,"options":[{"name":"待接触"},{"name":"需求确认"},{"name":"方案报价"},{"name":"商务谈判"},{"name":"赢单"},{"name":"丢单"}]}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<opportunities_table_id>" --json '{"type":"user","name":"负责人","multiple":false}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<opportunities_table_id>" --json '{"type":"datetime","name":"预计成交日期","style":{"format":"yyyy-MM-dd"}}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<opportunities_table_id>" --json '{"type":"text","name":"竞争对手"}' --as user sleep 1.5 lark-cli base +field-create --base-token "<base_token>" --table-id "<opportunities_table_id>" --json '{"type":"select","name":"丢单原因","multiple":false,"options":[{"name":"价格"},{"name":"功能"},{"name":"竞品"},{"name":"无预算"},{"name":"项目取消"},{"name":"其他"}]}' --as user sleep 1.5