feishu-bitable

SKILL.md

Feishu Bitable (多维表格) SKILL

🚨 执行前必读

✅ 创建数据表：支持两种模式 — ① 明确需求时，在 create 时通过 table.fields 一次性定义字段（减少 API 调用）；② 探索式场景时，使用默认表 + 逐步修改字段（更稳定，易调整）

⚠️ 默认表的空行坑：app.create 自带的默认表中会有空记录（空行）！插入数据前建议先调用 feishu_bitable_app_table_record.list + batch_delete 删除空行，避免数据污染

✅ 写记录前：先调用 feishu_bitable_app_table_field.list 获取字段 type/ui_type

✅ 人员字段：默认 open_id（ou_...），值必须是 [{id:"ou_xxx"}]（数组对象）

✅ 日期字段：毫秒时间戳（例如 1674206443000），不是秒

✅ 单选字段：字符串（例如 "选项1"），不是数组

✅ 多选字段：字符串数组（例如 ["选项1", "选项2"]）

✅ 附件字段：必须先上传到当前多维表格，使用返回的 file_token

✅ 批量上限：单次 ≤ 500 条，超过需分批（批量操作是原子性的）

✅ 并发限制：同一数据表不支持并发写，需串行调用 + 延迟 0.5-1 秒

📋 快速索引：意图 → 工具 → 必填参数