技能库智客分类：文档办公 lark-doc

Lark Doc

飞书云文档（Docx / Wiki）内容操作：读取、创建、编辑文档，插入或下载图片附件，以及操作思维笔记。用户提供文档 URL/token（包括 doubao.com 的 /docx/、/wiki/）时使用；按 URL 路径/token 而非域名路由。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive；随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。

445429 安装量

官方网址：skills.sh

技能介绍

先看中文介绍；官方 description 原文单独保留，不改写 SKILL.md。

做什么

官方 description 用英文写明「Lark Doc」做什么。中文介绍不改写这段原文，能力边界以文件结构与下方原文为准。

何时用

官方 description 未单独写出 Use when。按规范，代理会在用户任务与这段 description 的关键词匹配时激活本技能。

代理如何加载

按 Agent Skills 渐进披露：启动时只加载 name 与 description（约 100 token）；任务匹配后才读入整份 SKILL.md 正文；scripts/、references/、assets/ 仅在需要时再读。本文件正文结构：docs、场景与 Shortcut 路由、文档内容、辅助能力、资源、画板与思维笔记、认证与 Scope。

文件分析

文件分析：除 SKILL.md 外，正文引用了 references/lark-doc-fetch.md、references/lark-doc-create-workflow.md、references/lark-doc-create.md、references/lark-doc-update.md、references/lark-doc-script.md、references/lark-doc-history.md，属于带资源的技能包，这些文件按需再读。

docs场景与 Shortcut 路由文档内容辅助能力资源、画板与思维笔记认证与 Scope不在本 Skill 范围

来源分类：skills.sh agent-skill

来源与网址

市场来源：skills.sh

GitHub 完整包

开源榜 Skill 分类

SKILL.md 与 Agent 调用

官方规范 ↗

name: lark-doc
description: 飞书云文档（Docx / Wiki）内容操作：读取、创建、编辑文档，插入或下载图片附件，以及操作思维笔记。用户提供文档 URL/token（包括 doubao.com 的 /docx/、/wiki/）时使用；按 URL 路径/token 而非域名路由。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive；随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。

发现技能客户端向 Agent 提供名称与描述目录。
匹配与调用用户指定或任务匹配后，载入 SKILL.md 指令。
按需加载按步骤读取参考文档、使用脚本与素材。

指令中引用的文件 · 12

references/lark-doc-fetch.md
references/lark-doc-create-workflow.md
references/lark-doc-create.md
references/lark-doc-update.md
references/lark-doc-script.md
references/lark-doc-history.md
references/lark-doc-media-insert.md
references/lark-doc-media-preview.md
references/lark-doc-media-download.md
references/lark-doc-resource-cover.md
references/lark-doc-whiteboard.md
references/lark-whiteboard-update.md

以下路径提取自原文；文件是否齐全请以来源仓库中的完整目录为准。

具体调用语法与可用工具以目标 Agent 客户端为准。查看调用机制说明 ↗

安装这个技能

Skills CLI ↗

先选择目标 Agent 和安装范围，保留技能包的附属文件，安装后检查客户端能否发现该技能。

该技能引用了附属文件，请从来源获取完整目录；仅复制 SKILL.md 可能缺少依赖。

交给 Agent 安装

复制安装指令给支持 Agent Skills 的代理，确认其中的目标目录与客户端匹配。

把 Agent Skill「lark-doc」安装到我的项目：SKILL.md 原文与官方 description 见 https://zicq.com/zh/skills/skl-f136a127bfb09711-Lark-Doc.html
请存为 .cursor/skills/lark-doc/SKILL.md 或 .claude/skills/lark-doc/SKILL.md，frontmatter 的 name 与 description 保持原样，不要改写。
该技能还带 scripts/、references/、assets/ 等文件，请从 https://github.com/larksuite/cli 取完整目录，不要只建一个 SKILL.md。

GitHub 完整包 ↗

终端安装 · Skills CLI

需要 Node.js 与 npx。先查看仓库技能列表，确认实际名称。

npx skills add 'https://github.com/larksuite/cli' --list

目标客户端安装范围

npx skills add 'https://github.com/larksuite/cli' --skill 'lark-doc'

CLI 会交互选择目标 Agent，默认安装到项目；用户级安装使用 -g。先通过查看命令核对仓库内容，再用 npx skills list 检查已安装技能。

SKILL.md 原文可复制，不会改动源文件

---
name: lark-doc
description: "飞书云文档（Docx / Wiki）内容操作：读取、创建、编辑文档，插入或下载图片附件，以及操作思维笔记。用户提供文档 URL/token（包括 doubao.com 的 /docx/、/wiki/）时使用；按 URL 路径/token 而非域名路由。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive；随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。"
metadata:
  requires:
    bins: ["lark-cli"]
    skills: ["lark-shared"]
  cliHelp: "lark-cli docs --help;lark-cli mindnotes --help"
---

# docs

## 场景与 Shortcut 路由

**CRITICAL：先判断场景，再读取该场景的参考文件；不要在任务开始时一次性读取全部参考文件。每个文件只在首次进入对应阶段时读取一次。**

**身份：文档操作推荐显式指定 `--as user`。**

**本地文件引用统一遵循文件访问权限：CWD 内优先使用 `@./相对路径`，其他目录使用 `@绝对路径`。XML 内的相对资源路径先查 CWD；仅文件不存在时再查源 XML 文件所在目录，同名文件以 CWD 为准。内联内容、stdin、在线文档没有源文件目录，不执行回退。**

### 文档内容

- **读取 / 摘要 — [`+fetch`](references/lark-doc-fetch.md)**：先读参考再获取文档。
- **从零创作 — [`创建工作流`](references/lark-doc-create-workflow.md)**：先完整执行创建工作流，**简单任务不是跳过的理由**；
- **导入 / 空文档 — [`+create`](references/lark-doc-create.md)**：仅创建空文档或原样导入用户提供的完整内容时，跳过创建工作流。
- **编辑 / block 直达链接 — [`+update`](references/lark-doc-update.md)**：语义改写、润色、重组、补写或排版均按 update 参考完成。

### 辅助能力

- **草稿初始化、解析与统计 — [`+script`](references/lark-doc-script.md)**：支持解析文档 URL / token 与本地 XML，统计字数并返回字符诊断；不支持 Markdown 输入。
- **历史版本 — [`+history-list` / `+history-revert` / `+history-revert-status`](references/lark-doc-history.md)**：查询、回滚文档历史版本或检查回滚任务状态。

### 资源、画板与思维笔记

- **插入本地素材 — [`+media-insert`](references/lark-doc-media-insert.md)**：在文末插入本地图片或文件。
- **预览素材 — [`+media-preview`](references/lark-doc-media-preview.md)**：预览文档或评论中的图片、附件或素材。
- **下载素材 — [`+media-download`](references/lark-doc-media-download.md)**：下载文档中的图片、附件、素材或画板缩略图。
- **Docx 封面 — [`+resource-download` / `+resource-update` / `+resource-delete`](references/lark-doc-resource-cover.md)**：下载、更新或删除 Docx 封面。
- **画板 — [`画板工作流`](references/lark-doc-whiteboard.md)**：创建或更新画板时先读取工作流；更新已有画板必须复用现有 token，禁止新建空白画板；使用 [`whiteboard +update`](../lark-whiteboard/references/lark-whiteboard-update.md) 写入。
- **思维笔记 — `mindnotes`**：已有思维笔记走 [`思维笔记链路`](references/lark-doc-mindnote.md)；新建思维笔记走 [`lark-doc-whiteboard`](references/lark-doc-whiteboard.md)。

### 认证与 Scope

执行 Shortcut 时，不预读 [`lark-shared`](../lark-shared/SKILL.md) 或预跑 `auth status --verify`；仅遇到未认证、token / 身份或 scope 错误时读取该 Skill，修复后重试。认证、身份或 scope 管理请求则直接使用该 Skill。

## 不在本 Skill 范围

- **Drive 文件级操作**：找文档、导入导出、云空间文件上传 / 下载 / 权限管理 → [`lark-drive`](../lark-drive/SKILL.md)。复制文档、创建副本或另存为副本时，按其指引使用 `lark-cli drive files copy`；不要用 `docs +fetch` + `docs +create` 重建正文。
- **独立评论操作**：添加、分页查看、回复评论或增删 reaction → [`lark-drive`](../lark-drive/SKILL.md)；只需紧凑评论上下文时，直接使用默认 JSON 响应的 `docs +fetch`。

阅读排版

name: lark-doc description: "飞书云文档（Docx / Wiki）内容操作：读取、创建、编辑文档，插入或下载图片附件，以及操作思维笔记。用户提供文档 URL/token（包括 doubao.com 的 /docx/、/wiki/）时使用；按 URL 路径/token 而非域名路由。文档内嵌资源按读取参考中的统一规则分流。独立评论操作走 lark-drive；随正文读取评论使用 docs +fetch。表格或 Base 内部数据操作不在本 skill。" metadata: requires: bins: ["lark-cli"] skills: ["lark-shared"] cliHelp: "lark-cli docs --help;lark-cli mindnotes --help"

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。