Score
8.9
/ 10
Installs
715K
Repo Stars
17.0K
Last Updated
15d ago
Quality Ratio
98%
Description
Verified
Language
Go
First Published
Mar 2026
Summary
The Lark Doc agent skill enables comprehensive programmatic management of Lark Suite cloud documents, including creation, content retrieval, diverse update operations, and embedded media handling. This is designed for developers and automation agents who need to programmatically interact with and discover diverse content types, such as documents, spreadsheets, and wikis, within the Lark Suite ecosystem. This is a moderately adopted skill. It offers direct shortcuts for common tasks like `+create`, `+fetch`, and `+update` for document content, alongside `+media-insert` and `+media-download` for managing embedded files. Crucially, it guides the AI agent on correctly parsing document URLs and resolving complex Wiki link tokens to their actual `obj_token` and type (e.g., `docx`, `sheet`) before performing operations. Furthermore, the skill's `+search` function serves as a versatile resource discovery tool, locating not only documents and wikis but also other cloud objects like spreadsheets and reports. However, it does not directly support editing existing whiteboard content, guiding users instead to the specialized `lark-whiteboard` skill for those interactions.
Skill Definition
场景与 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。