lark-doc

Create, retrieve, and update Feishu cloud documents with wiki token resolution.

Updated Sep 4, 2025
One-click install
npx skills add https://github.com/ykai55/dotfiles --skill lark-doc-ykai55
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: lark-doc
Source: https://github.com/ykai55/dotfiles/tree/main/opencode/skills/lark-doc
Command: npx skills add https://github.com/ykai55/dotfiles --skill lark-doc-ykai55

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires lark-cli, and includes references (resource) components.

What problem does it solve?

飞书云文档的创建、读取与更新通常需要处理复杂的 Token/URL 规则,以及媒体/画板的额外下载与编辑限制,本 Skill 把这些关键决策与操作流程整合起来,帮助你更可靠地完成文档任务。

Core Features & Use Cases

  • Document discovery & routing:先用搜索定位文档、Wiki、以及电子表格/报表等对象,再按对象类型切换到对应工作流。
  • Read & update workflows:从 URL/Token 获取文档内容(含 Lark DSL 组件),并按追加/覆盖/插入/删除等模式进行局部更新,必要时新建空白画板。
  • Media handling:自动识别文档中的图片/文件/画板标记(通过 fetch 返回的 token),再用专门的媒体下载/插入能力完成素材获取与写入。
  • Wiki token correctness:当你面对 /wiki/ 链接时,先用节点查询确认 obj_type 与真实 obj_token,避免错误调用导致失败。

Quick Start

在已知飞书文档链接或 token 的情况下,向我提出“获取该飞书云文档的内容并把图片/文件 token 列出来”,我会先使用 docs +fetch 读取正文,再按需要引导你用 docs +media-download 获取媒体资源。

Frequently Asked Questions about lark-doc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I retrieve and update Feishu cloud documents using a URL token?

To retrieve and update Feishu cloud documents, you fetch content via lark-cli docs commands using the URL token, then apply incremental updates like append, overwrite, or insert using Lark-flavored markdown for precise section modifications.

Why does my Feishu wiki link fail when I try to fetch document content?

Feishu wiki links fail because they require wiki token resolution first. You must query the wiki spaces get_node endpoint to confirm the actual obj_type and obj_token before calling standard docs commands to avoid incorrect API routing.

How do I download images and whiteboard thumbnails from a Feishu doc?

To download images and whiteboard thumbnails from a Feishu doc, first fetch the document to identify media markers and their tokens, then use the lark-cli docs media-download capability to retrieve the specific image or file resources.

Can I directly edit existing whiteboard content within a Feishu cloud document?

You cannot directly edit existing whiteboard content within a Feishu cloud document due to safety guardrails. The supported workflow allows inserting new blank whiteboards but prevents modifying current whiteboard content directly to protect data integrity.

What is the best way to search and route to different Feishu cloud objects like spreadsheets?

The best way to search and route Feishu cloud objects is to use the document discovery workflow to locate docs, wikis, and spreadsheets, then switch to the corresponding specific workflow based on the identified object type.