lark-doc
飞书云文档(Docx / Wiki)内容操作:读取、创建、编辑文档,插入或下载图片附件,以及操作思维笔记。用户提供文档 URL/token(包括 doubao.com 的 /docx/、/wiki/)时使用;按 URL 路径/token 而非域名路由。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive;随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。
- License 许可
- MIT
- 最近更新
- 2026-09-10
- Stars
- ★ 0
- Forks
- 0
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 而非域名路由。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive;随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。
02 资源文件 43
- 参考文档references/genres/business-analysis.md3.1 KB
- 参考文档references/genres/data-report.md2.9 KB
- 参考文档references/genres/email.md4.0 KB
- 参考文档references/genres/execution-plan.md2.9 KB
- 参考文档references/genres/formal-doc.md4.4 KB
- 参考文档references/genres/meeting-minutes.md2.3 KB
- 参考文档references/genres/memo-brief.md2.0 KB
- 参考文档references/genres/official-redhead.md6.1 KB
- 参考文档references/genres/prd.md2.5 KB
- 参考文档references/genres/proposal.md2.1 KB
- 参考文档references/genres/research-report.md3.2 KB
- 参考文档references/genres/retrospective.md2.4 KB
- 参考文档references/genres/route-consumer.md3.8 KB
- 参考文档references/genres/route-creative.md3.6 KB
- 参考文档references/genres/route-knowledge.md4.7 KB
- 参考文档references/genres/route-marketing.md4.2 KB
- 参考文档references/genres/route-media.md3.7 KB
- 参考文档references/genres/route-opinion.md3.6 KB
- 参考文档references/genres/route-personal-brand.md3.4 KB
- 参考文档references/genres/route-platform.md639 B
- 参考文档references/genres/route-report.md1.2 KB
- 参考文档references/genres/route-workplace.md2.8 KB
- 参考文档references/genres/sop-tutorial.md4.0 KB
- 参考文档references/genres/technical-doc.md3.5 KB
- 参考文档references/genres/wechat.md3.9 KB
- 参考文档references/genres/weekly-report.md2.0 KB
- 参考文档references/genres/white-paper.md3.1 KB
- 参考文档references/genres/xiaohongshu.md3.2 KB
- 参考文档references/lark-doc-create-workflow.md9.3 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-vc
仅当用户或上游配置显式指定 lark-vc 时使用,相关请求统一交由 lark-meeting 技能处理。