lark-base

base

前置条件： 先阅读 ../lark-shared/SKILL.md。 执行前必做： 执行任何 base 命令前，必须先阅读对应命令的 reference 文档，再调用命令。 查询类任务必做： 涉及筛选、排序、Top/Bottom N、聚合、多表关联、查询后写入或判断全局结论时，必须先阅读 references/lark-base-data-analysis-sop.md，再选择 record / view / data-query 路径。 命名约定： Base 业务命令仅使用 lark-cli base +... 形式；解析 Wiki 链接使用 lark-cli wiki +node-get。 分流规则： 如果用户要“把本地文件导入成 Base / 多维表格 / bitable”，第一步不是 base，而是 lark-cli drive +import --type bitable；导入完成后再回到 lark-cli base +... 做表内操作。

1. 何时使用本 Skill

1.1 触发条件

以下场景应使用本 skill：

• 用户明确要操作飞书多维表格 / Base。
• 用户要建表、改表、查表、删表，或管理字段、记录、视图。
• 用户要做公式字段、lookup 字段、派生指标、跨表计算。
• 用户要做临时统计、聚合分析、比较排序、求最值。
• 用户要管理 workflow、dashboard、表单、角色权限。
• 用户给出 /base/{token} 链接。
• 用户给出 /wiki/{token} 链接，且最终解析为 bitable。
• 用户要把旧的 Base 聚合式写法改成当前原子命令写法，例如把旧 +table / +field / +record / +view / +history / +workspace 改写成当前命令。

以下场景不应使用本 skill：

• 用户只是做认证、初始化配置、切换 --as user/bot、处理 scope。此时先读 ../lark-shared/SKILL.md。
• 用户只是泛化地讨论“数据分析 / 字段设计”，但并不在 Base 场景中。不要因为提到“统计 / 公式 / lookup”就误触发。

1.2 前置约束

1. 先阅读 ../lark-shared/SKILL.md。
2. Base 业务命令仅使用 lark-cli base +... 形式的 shortcut 命令。
3. 如果输入是 Wiki 链接或 Wiki token，并且用户想读取/操作其中的 Base，先执行 lark-cli wiki +node-get --node-token <wiki_url_or_token>；当返回 data.obj_type=bitable 时，把 data.obj_token 当作 --base-token。不要把 URL 里的 /wiki/{token} 当成 Base token。（旧的 --token flag 仍可用，但已 deprecated，会在 stderr 打印迁移提示。）
4. 定位到命令后，先读该命令对应的 reference，再执行命令。
5. 如果用户要把本地 Excel / CSV / .base 快照导入成 Base / 多维表格 / bitable，第一步不是 base，而是 lark-cli drive +import --type bitable；导入完成后再回到 lark-cli base +... 做表内操作。
6. 不要在 Base 场景改走 lark-cli api /open-apis/bitable/v1/...。
7. 如果用户只给 Base 名称、关键词，或说“帮我找一个多维表格”，先通过 lark-cli drive +search --query <keyword> --doc-types bitable 搜索 Base / 多维表格资源；拿到 Base URL 后再使用本 skill 的 base +... 命令。复杂搜索再读 ../lark-drive/references/lark-drive-search.md：标题精确匹配、限定 owner（--mine / --creator-ids，owner 语义非"最初创建人"）/群/文件夹/时间范围、只搜标题/评论、分页/全量搜索。