lark-doc

SKILL.md

Create, read, edit, and manage Lark documents with content extraction, summarization, and formatting support.

Supports three document types: Docx, Wiki, and Cloud Documents; handles embedded spreadsheets, multidimensional tables, and whiteboards by extracting tokens for downstream skill routing

Core operations include fetch (with scoping and detail levels), create (XML or Markdown), update (str_replace, block operations, append, overwrite), and media management (insert, download, preview)

All docs +create, docs +fetch, and docs +update commands require --api-version v2 flag; defaults to DocxXML format unless Markdown is explicitly requested

Recognizes Feishu document URLs and tokens from both feishu.cn and doubao.com domains; routes based on URL path patterns and token type, not domain alone

docs

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

# 常用示例
lark-cli docs +fetch --doc "文档URL或token；若 URL 存在 #share-... 锚点，优先使用锚点方式读取，不要全文拉取"
lark-cli docs +create --content '<title>标题</title><p>内容</p>'
lark-cli docs +update --doc "文档URL或token" --command append --content '<p>内容</p>'

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

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

../lark-shared/SKILL.md — 认证、权限处理、全局参数（所有操作通用）

读取文档（docs +fetch） → 必读 lark-doc-fetch.md（--scope / --detail 选择、局部读取策略、<fragment> / <excerpt> 输出结构）

创建或编辑文档内容 → 必读 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

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