Agent Skills › larksuite/cli › lark-doc

lark-doc

GitHub

提供飞书云文档（Docx/Wiki）的读写、创建、编辑、资源管理及历史版本操作能力，支持URL路由与多场景分流。

skills/lark-doc/SKILL.md larksuite/cli

Trigger Scenarios

用户请求读取或摘要飞书文档用户请求创建或导入飞书文档用户请求编辑或更新飞书文档内容用户请求管理文档附件或图片

Install

npx skills add larksuite/cli --skill lark-doc -g -y

More Options

Use without installing

npx skills use larksuite/cli@lark-doc

指定 Agent (Claude Code)

npx skills add larksuite/cli --skill lark-doc -a claude-code -g -y

安装 repo 全部 skill

npx skills add larksuite/cli --all -g -y

预览 repo 内 skill

npx skills add larksuite/cli --list

SKILL.md

Frontmatter

{
    "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。"
}

docs

场景与 Shortcut 路由

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

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

所有表示本地文件的 @path 均使用 @./xxx 形式的相对路径，并以运行 lark-cli 时的当前工作目录（CWD）为基准。

文档内容

读取 / 摘要 — +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。