Lark Crm Feishu Cli

lark-crm: 飞书轻型 CRM 系统 Skill

通过自然语言对话，直接管理飞书多维表格中的 CRM 系统。

是什么

`lark-crm` 是一个 基于飞书CLI 的 Agent Skill，它将你的「轻型 CRM 系统」多维表格封装成对话式管理工具。你不需要记住任何表名、字段名或命令参数，只需用自然语言描述你的意图，skill 就会自动：

1. 理解意图 — 判断你是要查客户、建商机、记跟进还是看报表
2. 翻译命令 — 自动映射到正确的多维表格和字段
3. 执行操作 — 调用 lark-cli base 命令完成操作
4. 格式化输出 — 以友好的表格或摘要展示结果

工作原理

用户自然语言输入
      │
      ▼
┌─────────────────┐
│  意图路由决策树    │  SKILL.md 中定义
│  匹配关键词 →     │  "客户"→客户管理
│  选择 Shortcut    │  "商机"→商机管理
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  配置自动发现      │  首次使用时：
│  URL → base-token │  用户提供 URL
│  +table-list      │  自动发现表结构
│  → table_id 映射   │  缓存到会话中
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  lark-cli base   │  底层原子命令
│  +record-list    │  查询记录
│  +record-upsert  │  新增/更新记录
│  +data-query     │  聚合分析
└────────┬────────┘
         │
         ▼
   格式化输出给用户

零配置设计

本 skill **不硬编码任何 base-token 或 table_id**。不同用户使用时，只需提供飞书多维表格 URL，skill 会自动：

1. 从 URL 解析 base_token（/base/ 后的字符串）
2. 调用 +table-list 发现所有表及其 table_id
3. 按表名关键字匹配：客户管理、商机管理、合同管理、客户跟进记录、销售人员管理
4. 缓存到会话中，后续命令直接使用
5. 飞书crm模板地址：https://www.feishu.cn/base/bascndXmwM3qJOVZjUR6LS4uSng?table=tblVw8OKO1Yz2Lcl&view=vew4RfmKci
6. cli和skill安装办法： https://mp.weixin.qq.com/s/TGPCMtW92zTrt11ivm0pcA?scene=1&click_id=76

换人使用、换表格，只需提供一个新 URL 即可。

三层架构

层级	职责	文件
意图层	自然语言理解、关键词匹配、路由到对应 Shortcut	SKILL.md
业务层	CRM 表映射、字段校验、可写/只读判断、关联 ID 查找	SKILL.md + references/crm-commands.md
执行层	lark-cli base 原子命令执行	lark-base skill

为什么这样设计

**问题**：用户每次操作 CRM 需要记忆 6 张表的 table-id、几十个字段名和类型、关联关系、哪些字段可写哪些只读，还需要手动拼接 JSON。换人或换表格时，还得逐个修改配置。

**解决**：skill 把这些知识全部固化下来，并支持自动发现配置。用户只需要说"帮我查一下北京互联网行业的客户"，Claude 自动完成：

• 配置初始化 → 首次使用自动发现 base-token 和表结构
• 意图识别 → 客户查询
• 筛选构建 → +record-list 拉取后本地过滤
• 结果展示 → 格式化表格

CRM 系统结构

数据模型

销售人员管理（8人）
    │
    │ 负责跟进
    ▼
客户管理（20+客户）─── 客户跟进记录
    │                      │
    │ 产生                  │ 关联