lark-doc

Installation
Summary

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
SKILL.md

docs (v2)

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

CRITICAL — API 版本:本 skill 使用 v2 API。执行 docs +createdocs +fetchdocs +update 时必须显式传入 --api-version v2

# 常用示例
lark-cli docs +fetch  --api-version v2 --doc "文档URL或token"
lark-cli docs +create --api-version v2 --content '<title>标题</title><p>内容</p>'
lark-cli docs +update --api-version v2 --doc "文档URL或token" --command append --content '<p>内容</p>'

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

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

  1. ../lark-shared/SKILL.md — 认证、权限处理、全局参数(所有操作通用)
  2. 读取文档(docs +fetch --api-version v2 → 必读 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.mdlark-doc-update-workflow.md
Installs
280.2K
Repository
larksuite/cli
GitHub Stars
14.7K
First Seen
Mar 28, 2026
lark-doc — larksuite/cli