Lark Sheets：把复杂表格操作变成可靠的命令行工作流

技能简介

Lark Sheets 是飞书官方推出的电子表格 Agent 技能，面向"表格结构复杂、改动风险高、必须精确验证"的工作场景。复杂表格工作对指令精度与结果校验要求极高，一次误操作就可能破坏共享数据或让公式失效。该技能把飞书表格的读写能力，通过 lark-cli 认证工作流交给 AI Agent 执行，让 Claude、Codex、Claude Code 能够稳定地检查、修改和验证表格。

它强调"先检查、再改动、后验证"：读取前先确认工作表与范围标识，写入时保留数据类型，并对破坏性操作提供试运行与确认机制。技能版本为 3.0.0，MIT 许可，质量评级为 gold。

核心能力

1. 工作簿全生命周期管理：创建、导入、导出、检查并重组飞书工作簿与工作表。
2. 读写单元格内容：读写单元格的值、公式、样式、批注、图片以及带类型的分组表格数据。
3. 范围结构操作：插入、删除、调整大小、隐藏、冻结、合并、移动、复制、填充、清除与排序范围。
4. 图表与透视分析：创建并维护图表、透视表、筛选器、筛选视图、条件格式与迷你图。
5. 公式翻译：把 Excel 公式翻译为飞书表格支持的公式，并验证返回结果是否正确。
6. 批量有序更新：把相关写操作合并为有序的批量更新，并提供试运行与确认指引，降低误改风险。

安装配置

1. 安装技能：执行 npx skillstore add larksuite/lark-sheets 将技能加入本地技能库。
2. 准备 lark-cli 与配套指引：安装并认证 lark-cli，同时保留其声明依赖的 lark-shared 同级指引。
3. 确认表格权限：逐份确认目标表格的读写权限，尤其是共享工作簿。
4. 定位工作簿标识：在读取或写入某范围之前，先获取工作簿与工作表的标识，避免写错位置。

使用步骤

1. 检查工作簿结构：给出表格 URL，列出其工作表、定位目标工作表，并在不改动数据的前提下概括结构。
2. 读取目标范围：读取指定范围，明确即将施加的改动，并确认邻近格式与数据类型会被保留。
3. 施加改动并逐格验证：写入后逐一核对每一个发生变化的单元格，确认结果与预期一致。
4. 构建分析视图：按分组字段与指标对源范围做分析，创建透视表与合适的图表，并校验其源范围。
5. 迁移与重建模型：从源文件重建财务模型，保留带类型的输入项、翻译公式、补充敏感性分析，并验证代表性计算。

适用场景

• 分析运营数据：检查范围、保留数据类型、计算汇总，并构建图表或透视表用于周期性报表。
• 维护共享追踪表：追加行、更新公式、施加统一格式，并验证改动而不替换无关内容。
• 搭建财务模型：创建带类型的工作簿、翻译公式、添加敏感性视图，并校验计算结果。
• 迁移 Excel 资产：把既有 Excel 表格平移到飞书表格，处理公式差异并做结果核对。

适用人群

适合财务、运营、数据分析与项目管理岗位，尤其是需要长期维护共享表格、对数据准确性要求高的团队，以及希望把表格操作纳入 Agent 自动化流程的开发者。

工作原理

技能把表格操作翻译为 lark-cli 的认证命令。它区分读取与写入两条路径：读取时先取工作簿与工作表标识，再按范围抓取数据；写入时优先使用带类型的原值，避免把数字、百分比、日期存成文本而破坏排序、公式、图表与透视。破坏性操作会走试运行并提示确认，批量相关写操作合并为有序更新。安全审计显示，其静态告警均源于 Markdown 语法、占位 URL、文档链接与密集中文文本，两处子进程示例调用的是固定参数的 lark-cli，未发现提示注入或数据外泄。

注意事项

• 需要已安装并认证的 lark-cli 及其声明的配套指引。
• 它不按文件名搜索飞书云盘，定位未知表格需使用 lark-drive。
• 写入与删除会改动共享数据，必须核对目标并确认后再执行。
• 部分 Excel 公式需要翻译，因为飞书表格并非支持全部函数与数组行为。
• 不要猜测工作表名、标识符与范围；不要用格式化文本代替带类型的数值与日期。

官方链接

• Skill 详情页：https://skillstore.io/skills/larksuite-lark-sheets
• 项目仓库：https://github.com/larksuite/cli