什么是 lark-doc？
如果你用过飞书文档，大概知道它是个好东西：写文档、协作、@人、插表格，都很顺手。但如果你想让AI来帮你处理这些文档，事情就变得麻烦了：AI看不到你的飞书文档，你得手动复制内容给它，它改完了你再复制回去。
lark-doc 就是来解决这个问题的。它是飞书官方开源的一个 AI Agent 技能，让你的 AI 编程助手（Claude Code、Cursor、Codex 等）能够直接读取、创建和编辑飞书云文档。
这个技能不是让你在飞书里用 AI 写作——那是飞书文档自带的 AI 助手。lark-doc 的定位是：让你的外部 AI 工具能操作飞书文档。你可以让 AI 去读一份飞书文档然后总结，也可以让 AI 根据你的需求直接生成一份飞书文档，甚至让 AI 去修改你已经写好的文档。
lark-doc 是飞书官方 lark-cli 工具套件的一部分。整个套件覆盖了飞书的 11 大业务领域，包括文档、多维表格、即时通讯、日历、审批、幻灯片等，总计封装了 2500 多个 API 和 19 个 AI Agent Skills。其中 lark-doc 是安装量最高的技能之一，在 chatgptskill.cn上的安装量已超过 40 万次。
主要功能
1. 读取和提取文档内容
lark-doc 最基础的功能是读取飞书文档。你给 AI 一个飞书文档的 URL 或 token，AI 就能把文档内容读出来。
读取时可以控制范围和详细程度：是只读某个章节，还是读全文；是只读正文，还是连带评论和元数据一起读。读出来的内容会以 Markdown 或 XML 格式返回，方便 AI 做后续处理。
2. 从 Markdown 创建文档
你有一份 Markdown 格式的内容（可能是 AI 生成的，也可能是你本地写的），想让 AI 帮你把它变成一份飞书文档。lark-doc 支持直接从 Markdown 创建飞书文档。
创建时默认使用 DocxXML 格式（能保留更多样式，比如高亮块、网格布局、复选框等），但如果用户明确要求 Markdown 导入，也可以用 Markdown。
3. 精细化编辑
lark-doc 不只是“读取”和“创建”，它还能对已有文档做精细化的修改。支持的操作包括：
追加（append）：在文档末尾加一段内容
覆盖（overwrite）：用新内容替换整个文档
替换（str_replace）：查找并替换指定文本
插入（insert）：在指定位置插入内容
删除（delete）：删除指定块
这些操作都支持块级别的精准控制，而不是“全文替换”这种粗粒度操作。
4. 媒体文件管理
文档里的图片、附件、画板怎么办？lark-doc 支持上传、下载和预览文档中的媒体文件。AI 可以读取文档中的图片，也可以往文档里插入新的图片或附件。
特别说明：文档里的图片和附件需要通过专门的媒体工具单独获取，不会自动包含在文档内容里。
5. 识别多种文档类型
飞书里有多种文档类型——Docx 文档、Wiki 文档、思维笔记、电子表格等。lark-doc 能自动识别文档类型并正确处理。
不同类型的文档有不同的 URL 格式和 token 处理方式。比如 /docx/ 开头的 URL，token 可以直接使用；但 /wiki/ 开头的 Wiki 文档，需要先查询才能拿到真正的文档 token。
lark-doc 也支持 doubao.com 域名下的文档 URL。
如何安装 lark-doc
方式一：单独安装 lark-doc 技能
在终端中执行以下命令：
npx skills add larksuite/cli --skill lark-doc
这条命令会从飞书官方的 larksuite/cli 仓库中单独安装 lark-doc 技能。
方式二：全局安装（推荐）
如果你想在所有项目中使用，可以加 -g 参数：
npx skills add larksuite/cli -y -g
这会安装整个 larksuite/cli 技能包（包含 lark-doc 在内的所有飞书技能）。
方式三：安装完整技能包
npx skills add larksuite/cli这会安装飞书官方的全部 19 个技能，包括 lark-doc、lark-base（多维表格）、lark-im（即时通讯）、lark-calendar（日历）等。
前置配置
首次使用 lark-doc 之前，需要先完成飞书 CLI 的认证：
lark-cli auth login
认证完成后，后续所有文档操作默认使用 --as user 的身份执行。
应用场景
场景一：让 AI 帮你读文档、做总结
这是最直接的使用场景。你有一份飞书文档——可能是产品需求文档、技术方案、会议纪要——内容很长，没时间细看。让 AI 去读这份文档，然后给你一个摘要、提炼几个要点、或者回答你关于这份文档的具体问题。
场景二：让 AI 帮你写文档
你需要写一份周报、项目计划或技术文档，但不想从头敲。让 AI 先生成内容，然后直接用 lark-doc 创建一份飞书文档。内容直接就在飞书里了，排版、格式都是对的，你只需要打开文档做最后的微调。
场景三：让 AI 帮你改文档
你有一份已经写好的飞书文档，需要修改——比如调整某个章节的表述、补充一段内容、或者统一全文的术语。让 AI 去读文档、做修改、然后写回飞书。不需要你手动复制粘贴。
场景四：文档驱动的 AI 工作流
你有一个自动化流程，需要定期从飞书文档中提取数据、或者定期生成报告并写入飞书文档。lark-doc 让 AI 能成为这个流程中的一环——读取、处理、写入，全程自动化。
使用案例
案例一：用 AI 总结一份 50 页的 PRD
一个产品经理在飞书里写了一篇 50 页的 PRD，开发团队要开始干活了，但没人有时间把 50 页从头读到尾。他在 Cursor 里对 AI 说：“帮我读一下这份 PRD，总结核心功能列表和优先级。”
AI 通过 lark-doc 读取了文档内容，生成了一份结构清晰的摘要：6 个核心功能、每个功能的优先级、以及 3 个需要特别注意的技术依赖。开发团队用这份摘要直接开始了技术方案设计，省掉了每人花两小时读 PRD 的时间。
案例二：周报自动生成
一个团队每周都要写周报，格式固定但内容不同。团队负责人在 Claude Code 里配置了一个自动化流程：每周五下午，AI 自动读取本周的项目管理文档和代码提交记录，生成一份周报草稿，然后通过 lark-doc 创建一份新的飞书文档。
团队成员只需要打开文档做最后的补充和修改。以前每个人花 30 分钟写周报，现在只需要 5 分钟。
案例三：技术文档的批量迁移
一个技术团队之前用 Markdown 文件管理技术文档，现在要全部迁移到飞书文档。几百个 Markdown 文件，手动创建和排版要干一周。
他们用 lark-doc 的 docs +create 命令，写了一个简单的脚本，批量把 Markdown 文件转换成飞书文档。AI 自动处理了标题层级、代码块、表格等格式转换。几百份文档，一晚上迁移完成。
案例四：AI 辅助的文档审阅
一个团队在飞书里写了一份重要的对外发布文档，需要审阅措辞、检查逻辑、统一术语。以前的做法是：手动复制到某个 AI 工具里、让 AI 审阅、再把修改建议复制回飞书。
现在直接在 AI 编程助手里说：“帮我审阅这份飞书文档，检查措辞是否准确、逻辑是否通顺、术语是否统一。”AI 通过 lark-doc 读取文档内容，给出修改建议，然后直接用 docs +update 把修改写回飞书。整个过程在对话中完成，不需要手动复制粘贴。
总结
lark-doc 解决的是一个很实际的问题：你的文档在飞书里，但你的 AI 工具看不到飞书。
安装简单：一行
npx skills add命令
如果你日常用飞书文档来管理工作内容，并且希望 AI 能直接参与进来——帮你读、帮你写、帮你改——lark-doc 可能是你装过的所有技能里，最能让 AI 融入你日常 workflow 的那一个。
◯ 评论 0