用途
lark-doc 是发布在 open.feishu.cn 上的技能，用于让 AI Agent 操作飞书（Lark）云文档。其核心设计是「场景与 Shortcut 路由」：先判断当前任务属于哪个场景，再读取该场景对应的参考文件；不要在任务开始时一次性读取全部参考文件，每个文件只在首次进入对应阶段时读取一次。
身份方面，文档操作推荐显式指定 --as user。
本地文件引用统一遵循文件访问权限：CWD 内优先使用 @./相对路径，其他目录使用 @绝对路径。XML 内的相对资源路径先查 CWD；仅当文件不存在时再查源 XML 文件所在目录，同名文件以 CWD 为准。内联内容、stdin、在线文档没有源文件目录，不执行回退。
主要能力
文档内容
- 读取 / 摘要 —
+fetch：先读参考再获取文档。 - 从零创作 — 创建工作流：先完整执行创建工作流，简单任务不是跳过的理由。
- 导入 / 空文档 —
+create：仅创建空文档或原样导入用户提供的完整内容时，跳过创建工作流。 - 编辑 / block 直达链接 —
+update：语义改写、润色、重组、补写或排版均按 update 参考完成。
辅助能力
- 草稿初始化、解析与统计 —
+script：支持解析文档 URL / token 与本地 XML，统计字数并返回字符诊断；不支持 Markdown 输入。 - 历史版本 —
+history-list/+history-revert/+history-revert-status：查询、回滚文档历史版本或检查回滚任务状态。
资源、画板与思维笔记
- 插入本地素材 —
+media-insert：在文末插入本地图片或文件。 - 预览素材 —
+media-preview：预览文档或评论中的图片、附件或素材。 - 下载素材 —
+media-download：下载文档中的图片、附件、素材或画板缩略图。 - Docx 封面 —
+resource-download/+resource-update/+resource-delete：下载、更新或删除 Docx 封面。 - 画板 — 画板工作流：创建或更新画板时先读取工作流；更新已有画板必须复用现有 token，禁止新建空白画板；使用 whiteboard
+update写入。 - 思维笔记 — mindnotes：已有思维笔记走思维笔记链路；新建思维笔记走 lark-doc-whiteboard。
使用方式
以 Shortcut 为单位调用。任务开始时先判断场景，再按需读取对应参考文件。执行 Shortcut 时，不预读 lark-shared 或预跑 auth status --verify；仅遇到未认证、token / 身份或 scope 错误时读取该 Skill，修复后重试。认证、身份或 scope 管理请求则直接使用该 Skill。
适用场景
适用于飞书文档的读取与摘要、从零创作、空文档创建或原样导入、编辑润色排版、字数统计与字符诊断、历史版本查询与回滚、素材插入预览下载、封面管理，以及画板与思维笔记的创建与更新。
限制
以下内容不在本 Skill 范围：
- Drive 文件级操作：找文档、导入导出、云空间文件上传 / 下载 / 权限管理 → lark-drive。复制文档、创建副本或另存为副本时，按其指引使用
lark-cli drive files copy；不要用docs +fetch+docs +create重建正文。 - 独立评论操作：添加、分页查看、回复评论或增删 reaction → lark-drive；只需紧凑评论上下文时，直接使用默认 JSON 响应的
docs +fetch。
关于具体收费、价格、平台支持与效果等细节，资料中暂未提供。