Agent skill · software engineering · aiskillstore
lark-sheets
飞书电子表格:创建和操作电子表格。支持创建表格、管理工作表与行列结构(增删/合并/调整尺寸/隐藏/冻结)、读写单元格(值/公式/样式/批注/单元格图片)、查找替换、多操作原子批量更新,以及图表、透视表、条件格式、筛选器、迷你图、浮动图片等对象的创建与维护。当用户需要创建电子表格、管理工作表、批量读写或编辑数据、统计汇总与可视化、表格美化、公式计算(含 Excel 公式迁移)、金融/财务建模(DCF、三张表、预算、Sensitivity 等)等任务时使用。若用户是想按名称或关键词搜索云空间(云盘/云存储)里的表格文件,请改用 lark-drive 的 drive +search 先定位资源。当用户给出 doubao.com 的 /sheets/ URL/token 时,也应直接使用本 skill,不要因为域名不是飞书而回退到 WebFetch;路由依据是 URL 路径模式和 token,而不是域名。
Why this skill is useful
Provides niche commands and domain-specific knowledge for managing spreadsheets in Lark that the AI wouldn't reliably generate on its own.
What it needs
Requires lark-cli installed locally. About 6k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
sheets CRITICAL — 开始前 MUST 先用 Read 工具读取 ../lark-shared/SKILL.md,其中包含认证、权限处理。 术语约定 下列词在本 skill 各文档中可能交替出现,但指同一对象;解析用户口语时按此映射,不要当成不同概念: 标准用语 同义 / 口语(均指同一对象) 说明 --- --- --- 工作表(sheet) 子表、tab、标签页 spreadsheet 内的单张表;sheetid 是其稳定标识 电子表格(spreadsheet) 工作簿、表格 顶层容器;由 --url 或 --spreadsheet-token 定位 referenceid id 表内对象的稳定标识,即各对象主键 flag 接受的值(见下表)。⚠️ 与 lark-sheets-float-image 的 --image-uri(图片上传句柄)不是一回事,后者不属于 referenceid 每类对象用各自的主键 flag 定位(命名不统一,按此表对照,不要凭直觉拼): 对象 主键 flag 对象 主键 flag --- --- --- --- 工作表 sheet --sheet-id 条件格式规则 --rule-id 图表 chart --chart-id 筛选视图 --view-id 透视表 pivot --pivot-table-id 迷你图(按组) --group-id 浮动图片 --float-image-id 场景 → 命令速查(拿不准命令名先查这里,别按直觉拼) 把高频意图映射到真实存在的 shortcut / flag。agent 常从 Excel / Google Sheets / 飞书 OpenAPI 误迁移命令名或 flag,先对照本表,避免一次必然失败的试错。完整 shortcut 见各工具参考。 你要做的事 ✅ 正确写法 ❌ 不存在(会被 cobra 拒) --- --- --- 读数据(纯值 / CSV) +csv-get(范围用 --range) +get-range、+range-get、+cells-read 读值 + 公式 / 样式 / 批注 +cells-get --include value,formula,style,comment,datavalidation +get-cell、+cell-get、--with-styles、--with-merges、--include-merged-cells 写纯文本值(整块 CSV 平铺,列里没有需保留的数值 / 日期语义) +csv-put(定位用 --start-cell,单个左上角锚点格;也接受 --range 别名,区间自动取左上角) — 写带类型的数据到已有表(列里有数字 / 金额 / 百分比 / 日期 / 计数,要可排序 / 求和 / 入图表 / 透视) +table-put --sheets 完整 payload {"sheets":[{...}]}(列名走 columns、二维数据走 data、列 pandas dtype 走 dtypes、列展示格式走 formats;来源不限 DataFrame——Counter / dict / list 同理,详见 write-cells) 在本地把数字拼成 "$1,234" / "30.5%" 字符串再 +csv-put(会落成文本、丢失计算能力) 新建电子表格并写带类型的数据(类型保真需求同上,但目标表还不存在) +workbook-create --sheets(协议与 +table-put 同构、一步建表 + typed 写入,无需先建空表再 +table-put;date / number 不丢,详见 workbook) 用 --values 灌日期 / 数字(会落成文本、丢类型) 写值 / 公式 / 样式 +cells-set(定位用 --range) — 插图:图片绑定到某条记录、随行走(凭证 / 证件照 / 商品图 / 头像 / 二维码 / 每行配图) +cells-set-image(单格 --range,嵌入单元格内) — 插图:自由摆放、不绑数据的装饰 / 标识(logo / 水印 / 封面大图 / banner) +float-image-create(浮动图片,自由定位 + 尺寸 + 层级) — 查找单元格 +cells-search(关键字用 --find) +cells-find、+find、--query 查找并替换 +cells-replace — 看子表结构(合并 / 行高列宽 / 冻结 / 隐藏) +sheet-info +sheet-get、+structure-get、+sheet-structure-get 看工作簿 / 子表 …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/lark-sheets