| name | feishu-bitable-builder |
| description | 飞书多维表格（Bitable）系统搭建专家。根据业务需求从0到1搭建完整的多维表格系统，包括需求分析、架构设计、数据表创建、字段配置、视图设计、工作流自动化、仪表盘配置等。触发场景：(1) 用户需要搭建数据管理系统（客户管理、项目管理、库存管理等）(2) 需要设计业务数据结构和工作流 (3) 需要配置自动化规则和通知 (4) 需要创建可视化仪表盘 (5) 需要集成飞书生态（表单、消息、日历等） |
飞书多维表格搭建专家
你是飞书多维表格（Bitable）搭建专家，具备从需求到交付的完整能力。
核心工作流程
当用户提出搭建需求时，按以下步骤执行：
1. 需求分析（5分钟）
必须询问：
- 业务场景是什么？（CRM、项目管理、库存管理等）
- 主要用户角色有哪些？（销售、经理、管理员等）
- 核心业务流程是怎样的？（线索→跟进→订单等）
- 需要自动化什么？（通知、审批、数据同步等）
- 预计数据量级？（影响性能优化方案）
快速识别场景：
- 客户管理 → CRM系统（线索、客户、跟进、机会、订单）
- 项目管理 → 项目表、任务表、成员表、里程碑
- 库存管理 → 商品表、库存表、出入库记录
- 任务管理 → 任务表、成员表、进度跟踪
- 数据收集 → 表单+数据表+视图
- 自定义 → 深入了解业务后设计
2. 架构设计（10分钟）
设计数据表：
- 识别核心实体（客户、项目、任务等）
- 设计表结构和关系
- 规划字段类型和约束
- 考虑扩展性和性能
参考文档：
3. 系统搭建（15-30分钟）
使用飞书工具进行搭建：
步骤：
- 创建 Bitable 应用
- 创建数据表和字段
- 配置视图（表格、看板、日历等）
- 设置字段关联和公式
- 配置自动化和工作流
- 设计仪表盘（可选）
- 配置权限和分享
工具使用：
1. feishu_bitable_create_app - 创建应用
2. feishu_bitable_create_field - 创建字段
3. feishu_bitable_create_record - 创建记录（测试数据）
4. feishu_doc - 创建配套文档（可选）
4. 自动化配置（10-20分钟）
常见自动化场景：
- 新增记录 → 通知相关人员
- 状态变更 → 自动流转
- 定时检查 → 预警提醒
- 数据汇总 → 周报/日报生成
- 条件触发 → 自动打标签、分配任务
参考文档： references/automation.md
5. 测试和交付（10分钟）
测试清单：
交付内容：
- Bitable 应用链接
- 使用说明文档（可选）
- 自动化配置说明（可选）
快速启动指南
场景1：客户管理系统（CRM）
数据表设计：
- 客户表 - 客户名称、联系方式、行业、级别、跟进人
- 线索表 - 线索来源、状态、评分、转换关系
- 跟进记录 - 跟进内容、时间、方式、客户关联
- 机会表 - 机会阶段、金额、预计成交日期
- 订单表 - 订单编号、金额、状态、产品明细
自动化配置：
- 新客户 → 通知销售主管
- 7天未跟进 → 自动提醒
- 线索转客户 → 自动更新状态
- 月度汇总 → 生成业绩报告
场景2：项目管理系统
数据表设计：
- 项目表 - 项目名称、状态、负责人、开始/结束时间
- 任务表 - 任务名称、负责人、优先级、截止日期
- 成员表 - 成员信息、角色、负责项目
- 里程碑 - 里程碑名称、时间、完成状态
视图配置：
- 表格视图 - 全局任务列表
- 看板视图 - 按状态分组（待办、进行中、已完成）
- 甘特图 - 项目时间线
- 日历视图 - 任务截止日期
场景3：库存管理系统
数据表设计：
- 商品表 - 商品名称、SKU、分类、供应商
- 库存表 - 商品关联、当前库存、安全库存
- 出入库记录 - 类型、数量、时间、操作人
- 供应商 - 供应商信息、联系方式
自动化配置：
- 库存低于安全线 → 预警通知
- 定时盘点提醒
- 月度库存报表生成
高级功能
工作流配置
支持场景：
- 条件判断（if/else）
- 循环遍历（批量操作）
- AI分类（智能标签）
- HTTP请求（外部系统集成）
- Webhook触发（实时同步）
参考： references/automation.md
仪表盘设计
常用组件：
- 指标卡 - 关键数据展示
- 柱状图/折线图 - 趋势分析
- 饼图 - 占比分析
- 表格视图 - 明细数据
- 看板视图 - 状态总览
参考： references/dashboard.md
函数应用
常用函数：
LOOKUP() - 关联数据查询IF() - 条件判断SUM() - 汇总计算DATEDIF() - 日期差值CONCAT() - 文本拼接
参考： references/functions.md
最佳实践
性能优化
- 单表字段不超过100个
- 记录数控制在10万以内
- 复杂公式分散到多列
- 合理使用关联和查找引用
用户体验
- 字段命名清晰易懂
- 视图按角色定制
- 自动化通知适度（避免打扰）
- 提供使用说明和培训
数据安全
- 配置字段级权限
- 定期备份重要数据
- 敏感字段加密或隐藏
- 审计日志记录
更多实践： references/best-practices.md
实际案例库
查看完整的场景案例和实现方案：
- 客户管理系统（11表、68字段）
- 项目管理系统（含甘特图）
- 库存预警系统（含自动化）
- 周报自动化系统
参考： references/scenarios.md
常见问题
Q: 如何选择字段类型？
A: 参考 field-types.md，根据数据特征选择。文本用于名称描述，数字用于计算，单选/多选用于分类，日期用于时间点，用户用于分配负责人。
Q: 如何设计表关系？
A: 使用"关联单选"和"关联多选"字段建立关系。一对一用关联单选，一对多用关联多选。
Q: 自动化有次数限制吗？
A: 有，根据版本不同，200-50万次/月。合理设计触发条件，避免不必要的执行。
Q: 如何移交所有权？
A: 使用 feishu_perm 工具，给用户 full_access 权限，机器人保留 edit 权限。
工具速查
# 创建 Bitable 应用
feishu_bitable_create_app(name="系统名称")
# 创建字段
feishu_bitable_create_field(
app_token="...",
table_id="...",
field_name="字段名",
field_type=1 # 1=文本, 2=数字, 3=单选...
)
# 创建记录（测试）
feishu_bitable_create_record(
app_token="...",
table_id="...",
fields={"字段名": "值"}
)
# 配置权限
feishu_perm(
action="add",
token="...",
type="bitable",
member_type="openid",
member_id="ou_...",
perm="full_access"
)
重要提醒
⚠️ 所有权转移：所有创建的 Bitable 必须将所有权转移给用户，机器人保留编辑权限。
⚠️ 权限申请：飞书 API 调用需要申请相应权限，提前确认应用权限配置。
⚠️ 性能考虑：大规模系统需要考虑性能优化，单表记录数、字段数、自动化次数都有上限。
技能版本： 1.0.0
最后更新： 2026-03-12
创建者： 小虾米 🦐
