Lark Doc

> ⚙️ Cowork / Claude Desktop 执行环境说明（自动注入） > > 本技能依赖本地 lark-cli（@larksuite/cli，可用 command -v lark-cli 定位）及其 ~/.lark-cli 登录态（应用密钥存于 macOS keychain）。 > > 在 Cowork 中运行任何 lark-cli 命令时，必须在本地 macOS 上执行（使用 Desktop Commander 的 start_process / interact_with_process，或其它本地 shell 工具），不要用隔离的 Linux 沙箱 mcp__workspace__bash——沙箱里没有 lark-cli、也读不到 keychain。 > 执行前确保 npm 全局 bin 目录（npm prefix -g 输出目录下的 bin）在 PATH 中。 > > （在 Claude Code 中可忽略本说明，lark-cli 在本机 shell 直接可用。）

docs

身份：文档操作默认使用 --as user。首次使用前执行 lark-cli auth login。

# 常用示例
lark-cli docs +fetch --doc "文档URL或token"
lark-cli docs +create --content '标题内容'
lark-cli docs +update --doc "文档URL或token" --command append --content '内容'

前置条件 — 执行操作前必读

CRITICAL — 执行对应操作前，MUST 先用 Read 工具读取以下文件，缺一不可：

1. [../lark-shared/SKILL.md](../lark-shared/SKILL.md) — 认证、权限处理、全局参数（所有操作通用）
2. 读取文档（docs +fetch） → 必读 [lark-doc-fetch.md](references/lark-doc-fetch.md)（--scope / --detail 选择、局部读取策略、` / ` 输出结构）
3. 创建或编辑文档内容 → 必读 [lark-doc-xml.md](references/lark-doc-xml.md)（XML 语法规则，仅当用户明确要求 Markdown 时改读 [lark-doc-md.md](references/lark-doc-md.md)）和 [lark-doc-style.md](references/style/lark-doc-style.md)（元素选择、丰富度规则、颜色语义）；从零创建时加读 [lark-doc-create-workflow.md](references/style/lark-doc-create-workflow.md)；编辑已有文档时加读 [lark-doc-update.md](references/lark-doc-update.md) 和 [lark-doc-update-workflow.md](references/style/lark-doc-update-workflow.md)

未读完以上文件就执行相应操作会导致参数选择错误或格式错误。

> 格式选择规则（全局）： > - 创建 / 导入场景（docs +create，或 docs +update --command append/overwrite 的整段写入）：XML 和 Markdown 都可以。用户提供 .md 本地文件、或明确说"导入 Markdown"时，直接用 Markdown；否则默认 XML（可用 callout、grid、checkbox 等富 block）。 > - 精准编辑场景（docs +update 的 str_replace / block_insert_after / block_replace / block_delete / block_move_after 等局部精修指令）：优先使用 XML（--doc-format xml，即默认值）。XML 能稳定表达 block 结构和样式，局部精修更可控；不要因为 Markdown 更简单就自行切换。

快速决策

• 先判定任务路径：找文档 / 导入导出走 [lark-drive](../lark-drive/SKILL.md)；只读 / 摘要用 docs +fetch 默认 simple；明确旧文本 → 新文本直接 str_replace；只有 block 链接、评论锚点、插入 / 替换 / 删除 / 移动才局部 fetch with-ids；保真改写已有内容才读 full
• block 直达链接格式：文档基础 URL#block_id；没有 block_id 时局部 fetch with-ids
• 连续执行多个文档写操作时，必须按 [lark-doc-update.md](references/lark-doc-update.md) 的「Block ID 生命周期」判断旧 block ID 是否还能复用；overwrite / block_replace / block_delete 后不要复用受影响的旧 ID，插入 / 复制后要重新 fetch 才能拿到新 block ID
• 用户需要在文档内创建、复制或移动资源块（画板、电子表格、多维表格等）时，必须先读取 [lark-doc-xml.md](references/lark-doc-xml.md) 的「三、资源块」章节
• 写文档时，由内容和用户意图决定表达形式；流程、架构、路线图、关键指标等信息可以使用画板，但不要默认把重要信息都画板化
• 新增画板必须隔离到 SubAgent：简单图由 SubAgent 直接插入 完整 SVG，不读 lark-whiteboard；复杂图才由主 Agent 先建 `，再启动 SubAgent 读取 lark-whiteboard` 写入
• 用户说"看一下文档里的图片/附件/素材""预览素材" → 用 lark-cli docs +media-preview
• 用户明确说"下载素材" → 用 lark-cli docs +media-download
• 用户明确说"下载/更新/删除文档封面图" → 用 lark-cli docs +resource-download/+resource-update/+resource-delete --type cover
• resource-* 目前仅支持 Docx 封面资源；其他图片、附件或素材请走 +media-*
• 如果目标是画板/whiteboard/画板缩略图 → 只能用 lark-cli docs +media-download --type whiteboard（不要用 +media-preview）
• 拿到 spreadsheet URL/token 后 → 切到 lark-sheets 做对象内部操作
• 用户说"给文档加评论""查看评论""回复评论""给评论加/删除表情 reaction" → 切到 lark-drive 处理
• 文档内容中出现嵌入的 `、 或 ` 标签时 → 必须主动提取 token 并切到对应技能下钻读取内部数据，不能只呈现标签本身

| 标签 / 属性 | 提取字段 | 切到技能 | |-|-|-| | ` | token -> spreadsheet_token, sheet-id | [lark-sheets](../lark-sheets/SKILL.md) | | | token -> app_token, table-id | [lark-base](../lark-base/SKILL.md) | | | 同 | [lark-sheets](../lark-sheets/SKILL.md) | | | 同 | [lark-base](../lark-base/SKILL.md) | | | vc-node-id -> note_id | [lark-note](../lark-note/SKILL.md)：先 note +detail --note-id | | | src-token -> doc_token, src-block-id -> block_id | 用 docs +fetch` 读取 src-token 文档，定位 block |

Shortcuts（推荐优先使用）

Shortcut 是对常用操作的高级封装（lark-cli docs + [flags]）。有 Shortcut 的操作优先使用。

| Shortcut | 说明 | |----------|------| | [+create](references/lark-doc-create.md) | Create a Lark document (XML / Markdown) | | [+fetch](references/lark-doc-fetch.md) | Fetch Lark document content (XML / Markdown / im-markdown; im-markdown only after fetch for lark-im) | | [+update](references/lark-doc-update.md) | Update a Lark document (strreplace / blockinsertafter / blockreplace / ...) | | [+media-insert](references/lark-doc-media-insert.md) | Insert a local image or file at the end of a Lark document (4-step orchestration + auto-rollback). Prefer --from-clipboard when the image is already on the system clipboard (screenshots, copy from Feishu/browser); use --file only for on-disk sources. | | [+media-download](references/lark-doc-media-download.md) | Download document media or whiteboard thumbnail (auto-detects extension) | | [+media-preview](references/lark-doc-media-preview.md) | Preview document media file (auto-detects extension) | | [+resource-download / +resource-update / +resource-delete](references/lark-doc-resource-cover.md) | Download, update, or delete a Docx cover image resource with --type cover | | [+whiteboard-update](../lark-whiteboard/references/lark-whiteboard-update.md) | Alias of whiteboard +update. Update an existing whiteboard with DSL, Mermaid or PlantUML. Prefer whiteboard +update; refer to lark-whiteboard skill for details. |

不在本 Skill 范围

• 文档评论管理 → [lark-drive](../lark-drive/SKILL.md)
• 电子表格或 Base 的数据操作 → [lark-sheets](../lark-sheets/SKILL.md) / [lark-base](../lark-base/SKILL.md)
• 云空间文件上传、下载、权限管理 → [lark-drive](../lark-drive/SKILL.md)

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: DropFan
• Source: DropFan/claude-code-plugins
• License: MIT

Install and usage instructions live in the source repository linked above.