lark-doc
飞书云文档(Docx / Wiki)内容操作:读取、创建、编辑文档,插入或下载图片附件,以及操作思维笔记。用户提供文档 URL/token(包括 doubao.com 的 /docx/、/wiki/)时使用;按 URL 路径/token 而非域名路由;`/page/<token>` 是妙搭应用,非飞书云文档。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive;随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。
- License 许可
- MIT
- 所属仓库
- larksuite/cli
- 最近更新
- 2026-11-13
- Stars
- ★ 1.8w
- Forks
- 1.4k
01 前言 Front Matter
- name
- lark-doc
- metadata
- { "cliHelp": "lark-cli docs --help;lark-cli mindnotes --help", "requires": { "bins": [ "lark-cli" ], "skills": [ "lark-shared" ] } }
- description
- 飞书云文档(Docx / Wiki)内容操作:读取、创建、编辑文档,插入或下载图片附件,以及操作思维笔记。用户提供文档 URL/token(包括 doubao.com 的 /docx/、/wiki/)时使用;按 URL 路径/token 而非域名路由;`/page/<token>` 是妙搭应用,非飞书云文档。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive;随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。
02 资源文件 15
- 参考文档references/lark-doc-create-workflow.md7.6 KB
- 参考文档references/lark-doc-create.md3.2 KB
- 参考文档references/lark-doc-fetch.md7.8 KB
- 参考文档references/lark-doc-history.md5.4 KB
- 参考文档references/lark-doc-md.md5.8 KB
- 参考文档references/lark-doc-media-download.md2.2 KB
- 参考文档references/lark-doc-media-insert.md6.8 KB
- 参考文档references/lark-doc-media-preview.md1.6 KB
- 参考文档references/lark-doc-mindnote.md5.4 KB
- 参考文档references/lark-doc-resource-cover.md4.1 KB
- 参考文档references/lark-doc-script.md5.1 KB
- 参考文档references/lark-doc-update.md7.3 KB
- 参考文档references/lark-doc-whiteboard.md8.7 KB
- 参考文档references/lark-doc-xml-extended-blocks.md4.3 KB
- 参考文档references/lark-doc-xml.md5.3 KB
03 SKILL.md 正文
docs
场景与 Shortcut 路由
CRITICAL:先判断场景,再读取该场景的参考文件;不要在任务开始时一次性读取全部参考文件。每个文件只在首次进入对应阶段时读取一次。
身份:文档操作推荐显式指定 --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。
认证与 Scope
执行 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。
04 同仓库更多 Skills
cli-e2e-testcase-writer
Use when adding or updating Go CLI E2E coverage for one `tests/cli_e2e/{domain}` domain of the compiled `lark-cli`, especially when the work requires live `--help` or `schema` exploration, scenario-based `clie2e.RunCmd` workflows, and per-domain `coverage.md` maintenance.
lark-workflow-standup-report
日程待办摘要:编排 calendar +agenda 和 task +get-my-tasks,生成指定日期的日程与未完成任务摘要。适用于了解今天/明天/本周的安排。
lark-workflow-meeting-summary
会议纪要整理工作流:汇总指定时间范围内的会议纪要并生成结构化报告。当用户需要整理会议纪要、生成会议周报、回顾一段时间内的会议内容时使用。
lark-wiki
飞书知识库:管理知识空间、空间成员和文档节点。创建和查询知识空间、查看和管理空间成员、管理节点层级结构、在知识库中组织文档和快捷方式。当用户需要在知识库中查找或创建文档、浏览知识空间结构、查看或管理空间成员、移动或复制节点时使用。当用户给出 doubao.com 的 /wiki/ URL/token 时,也应直接使用本 skill,不要因为域名不是飞书而回退到 WebFetch;路由依据是 URL 路径模式和 token,而不是域名。不负责:上传文件到知识库节点下(走 lark-drive)、编辑文档/表格/Base 内容(走 lark-doc / lark-sheets / lark-base)。
lark-whiteboard
飞书画板:查询和编辑飞书云文档中的画板。支持导出画板为预览图片、导出原始节点结构、使用多种格式更新画板内容。 当用户需要查看画板内容、导出画板图片、编辑画板时使用此 skill。不负责:飞书云文档内容编辑(lark-doc)、文档内嵌电子表格/Base(lark-sheets / lark-base)。
lark-task
飞书任务:管理任务、清单和任务智能体。创建待办任务、查看和更新任务状态、拆分子任务、组织任务清单、分配协作成员、上传任务附件、注册或注销任务智能体、更新任务智能体的主页数据、写入智能体任务记录。当用户需要创建待办事项、查看任务列表、跟踪任务进度、管理项目清单或给他人分配任务、为任务上传附件文件、注册注销任务智能体、更新智能体主页数据、写入任务记录时使用。