Lark Doc：为飞书云文档与知识库打造可靠的命令行工作流

技能简介

Lark Doc 是飞书（Lark）官方出品的 Agent 技能，面向"文档多、改得频繁、又不想在多个工具之间来回切换"的团队场景。它把飞书云文档与知识库（Wiki）的读写能力，通过 lark-cli 认证工作流交到 AI Agent 手里，让 Claude、Codex、Claude Code 能按命令行指令直接读取、创建、编辑文档内容，而不必人工复制粘贴。

该技能的定位是"精准操作"而非"整篇覆盖"：它可以只取文档的某一节、某一关键词范围或某个大纲，也能只改指定区块而保留其余内容不动。对需要长期维护文档的运营与协作团队来说，这是一条稳定、可追溯的自动化路径。技能版本为 2.0.0，采用 MIT 许可。

核心能力

1. 按需读取内容：通过 URL 或 token 获取 Docx 或 Wiki 内容，支持 XML、Markdown、指定范围、大纲、关键词以及区块标识符等多种抓取粒度。
2. 创建文档：从 XML 或 Markdown 生成新文档，并返回文档链接与相关标识符。
3. 精准编辑区块：支持追加、覆盖、替换、插入、删除、移动和复制等文本或区块操作，改动落在指定位置。
4. 媒体资源处理：插入、预览或下载文档媒体，下载白板缩略图，并管理 Docx 封面图。
5. 历史版本管理：列出文档历史、选择目标版本、发起回滚并监控回滚状态。
6. 思维笔记与统计：读取已有思维笔记节点、创建或更新节点，并统计文档的字数与字符数。

安装配置

1. 安装技能：执行 npx skillstore add larksuite/lark-doc 将技能加入本地技能库。
2. 准备 lark-cli：安装 lark-cli 命令行工具，它是该技能所有操作的实际执行通道。
3. 完成账号认证：登录并认证飞书账号，确保 Agent 拥有目标文档或资源的访问权限。
4. 确认权限范围：逐份确认待操作文档的读写权限，避免因权限不足导致操作半途失败。

使用步骤

1. 先落地意图：在执行写入、删除、媒体传输、封面修改、思维笔记更新或历史回滚等操作前，先向使用者确认意图。
2. 小范围获取：处理大文档时，先取大纲或某一节，而不是整篇拉取，既减少数据访问也节省上下文。
3. 定位并编辑：找到目标区块后施加精确编辑，同时保留嵌入资源、提及、媒体与无关区块。
4. 创建与发布：根据简报从零创建结构化文档，再补充已审核的媒体，并校验最终字数是否符合要求。
5. 核验结果：操作完成后回读目标区块或文档属性，确认改动生效且未波及无关内容。

适用场景

• 总结文档片段：只抓取被请求的那一节，结合相关区块上下文产出聚焦摘要。
• 维护既有文档：定位目标区块、施加精准编辑、保留嵌入资源，并验证更新结果。
• 发布运营文档：按简报创建结构化文档，再添加已批准的媒体并核对最终篇幅。
• 长文档精修：按读者画像复核文档，逐节获取与编辑、保留资源，并校验目标字数。

适用人群

适合使用飞书办公的运营、产品与项目团队，尤其是需要批量维护知识库、周报、运营手册的岗位，以及希望把飞书文档纳入 Agent 自动化流程的开发者。

工作原理

技能并不直接操作飞书界面，而是把文档操作翻译为 lark-cli 的认证命令。读取时，它可以选择最小必要的抓取范围（节、关键词、范围或区块）；写入时，它把编辑意图映射为对应的区块级操作，并在修改前提示确认、修改后回读校验。文档的嵌入对象、提及与媒体都以资源 token 形式保留，避免误删。安全审计显示，其静态告警均来自可读 Markdown、占位符与解析语法，未发现提示注入或隐藏载荷。

注意事项

• 需要安装并认证 lark-cli，并逐份文档确认权限。
• 它不直接管理文档评论、云盘文件或 Drive 权限。
• 嵌入的表格、Base 多维表格、笔记与白板需要配套的飞书技能才能操作内部数据。
• 思维笔记命令只能读取已有笔记或修改其节点，新建思维笔记需走白板工作流。
• 不要在大文档场景下整篇拉取，也不要覆盖文档来代替用户要求的区块编辑。

官方链接

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