用途:通过 lark-cli 的 base 原子命令操作飞书多维表格,包括数据表、字段、记录、视图、历史、聚合分析、角色权限、表单、仪表盘与工作流。执行前需先阅读 ../lark-shared/SKILL.md,并在调用任何命令前阅读对应 reference 文档。
主要能力:表命令 +table-list/+table-get/+table-create/+table-update/+table-delete;字段命令 +field-list/+field-get/+field-create/+field-update/+field-delete/+field-search-options;记录命令 +record-list/+record-get/+record-upsert/+record-upload-attachment/+record-delete;视图命令 +view-;聚合分析 +data-query;历史 +record-history-list;Base 级 +base-create/+base-get/+base-copy;高级权限 +advperm-enable/+advperm-disable;角色 +role-;表单 +form-* 与 +form-questions-;工作流 +workflow-;仪表盘 +dashboard-* 与 +dashboard-block-*。
使用方式:统一使用 --base-token;写记录前先用 +field-list 获取字段结构,并读 lark-base-shortcut-record-value.md;写字段前读 lark-base-shortcut-field-properties.md;创建 formula/lookup 字段前先读对应 guide;workflow 命令前须读命令文档与 lark-base-workflow-schema.md;data-query 前读 lark-base-data-query.md。
限制与规则:只使用原子命令,不用旧聚合式写法;+xxx-list 禁止并发,需串行;+record-list 的 --limit 最大 200,超出需分页;批量上限 500 条/次,同表建议串行并延迟 0.5–1 秒;公式、lookup、系统字段默认只读,不能作为 +record-upsert 写入目标;聚合统计必须走 +data-query,不能用 +record-list 拉全量手算;表名/字段名必须来自真实返回,禁止猜测;Wiki 链接需先用 lark-cli wiki spaces get_node 解析,obj_type=bitable 时用 node.obj_token 作为 --base-token,不要改走 bitable/v1 API。删除类命令在目标明确时可直接执行并带 --yes。