feishu-bitable

npx skills add nexu-io/nexu --skill feishu-bitable --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

# 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 秒 --- ## 📋 快速索引：意图 → 工具 → 必填参数 | 用户意图 | 工具 | action | 必填参数 | 常用可选 | |---------|------|--------|---------|---------| | 查表有哪些字段 | feishu_bitable_app_table_field | list | app_token, table_id | - | | 查记录 | feishu_bitable_app_table_record | list | app_token, table_id | filter, sort, field_names | | 新增一行 | feishu_bitable_app_table_record | create | app_token, table_id, fields | - | | 批量导入 | feishu_bitable_app_table_record | batch_create | app_token, table_id, records (≤500) | - | | 更新一行 | feishu_bitable_app_table_record | update | app_token,