Agent skill · software engineering · aiskillstore
lark-doc
飞书云文档（Docx / Wiki 文档）：读取和编辑飞书文档内容。当用户给出文档 URL 或 token，或需要查看、创建、编辑文档、插入或下载文档图片附件时使用。文档中嵌入的电子表格、多维表格、画板，先用本 skill 提取 token 再切到对应 skill。当用户给出 doubao.com 的 /docx/ 或 /wiki/ URL/token 时，也应直接使用本 skill；路由依据是 URL 路径模式和 token，而不是域名。不负责文档评论管理，也不负责表格或 Base 的数据操作。当用户明确要操作飞书思维笔记时，也使用本 skill。
Why this skill is useful
Adds specific commands and workflows for manipulating Lark documents that the AI wouldn't reliably generate on its own.
What it needs
Requires lark-cli installed locally. About 3k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
docs 身份：文档操作默认使用 --as user。首次使用前执行 lark-cli auth login。 前置条件 — 执行操作前必读 CRITICAL — 执行对应操作前，MUST 先用 Read 工具读取以下文件，缺一不可： 1. ../lark-shared/SKILL.md — 认证、权限处理、全局参数（所有操作通用） 2. 读取文档（docs +fetch） → 必读 lark-doc-fetch.md（--scope / --detail 选择、局部读取策略、<fragment> / <excerpt> 输出结构） 3. 创建或编辑文档内容 → 必读 lark-doc-xml.md（XML 语法规则，仅当用户明确要求 Markdown 时改读 lark-doc-md.md）和必读 lark-doc-style.md（写作原则：默认段落、按体裁、组件克制）；从零创建时加读 lark-doc-create-workflow.md；编辑已有文档时加读 lark-doc-update.md 和 lark-doc-update-workflow.md 未读完以上文件就执行相应操作会导致参数选择错误或格式错误。 格式选择规则（全局）： - 创建 / 导入场景（docs +create，或 docs +update --command append/overwrite 的整段写入）：XML 和 Markdown 都可以。用户提供 .md 本地文件、或明确说"导入 Markdown"时，直接用 Markdown；否则默认 XML。 - 精准编辑场景（docs +update 的 strreplace / blockinsertafter / blockreplace / blockdelete / blockmoveafter 等局部精修指令）：优先使用 XML（--doc-format xml，即默认值）。XML 能稳定表达 block 结构和样式，局部精修更可控；不要因为 Markdown 更简单就自行切换。 快速决策 用户要复制文档 / 创建文档副本 / 另存为副本时，切到 lark-drive，按其中的复制指引使用 lark-cli drive files copy；不要用 docs +fetch + docs +create 重建正文，也不要走 drive +export / drive +import。 先判定任务路径：找文档 / 导入导出走 lark-drive；只读 / 摘要用 docs +fetch 默认 simple；明确旧文本 → 新文本直接 strreplace；只有 block 链接、评论锚点、插入 / 替换 / 删除 / 移动才局部 fetch with-ids；保真改写已有内容才读 full block 直达链接格式：文档基础 URL#blockid；没有 blockid 时局部 fetch with-ids 连续执行多个文档写操作时，必须按 lark-doc-update.md 的「Block ID 生命周期」判断旧 block ID 是否还能复用；overwrite / blockreplace / blockdelete 后不要复用受影响的旧 ID，插入 / 复制后要重新 fetch 才能拿到新 block ID 用户需要在文档内创建、复制或移动资源块（画板、电子表格、多维表格等）时，必须先读取 lark-doc-xml.md 的「三、资源块」章节 写文档时，由内容和用户意图决定表达形式；流程、架构、路线图、关键指标等信息可以使用画板，但不要默认把重要信息都画板化 新增或更新画板时，按 lark-doc-whiteboard.md 选型；Mermaid 可由主 Agent 直接插入，SVG / 复杂图 / 已有画板更新按其中流程隔离到 SubAgent 用户说"看一下文档里的图片/附件/素材""预览素材" → 用 lark-cli docs +media-preview 用户明确说"下载素材" → 用 lark-cli docs +media-download 用户想把文档回滚到某个 revisionid 或某一时刻 → 先读 lark-doc-history.md，按其中流程操作 用户明确说"下载/更新/删除文档封面图" → 用 lark-cli docs +resource-download/+resource-update/+resource-delete --type cover resource- 目前仅支持 Docx 封面资源；其他图片、附件或素材请走 +media- 如果目标是画板/whiteboard/画板缩略图 → 只能用 lark-cli docs +media-dow …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/lark-doc