Pinvou/pinvou-agent / pinvou3-app/src-tauri/resources/common/bundle/lark-skills/lark-doc
lark-doc
Unverified【何时用:仅当用户明确指向飞书/Lark(发到飞书、飞书文档等)时使用;泛指做个文档或PPT或表格或方案默认走本地工具,不要误用飞书】飞书云文档(Docx/Wiki)与思维笔记内容操作:读取、创建、编辑,插入/下载图片附件,查询/回滚历史版本。用户给出文档URL/token(doubao.com /docx/、/wiki/)按路径/token 路由;`/page/<token>` 是妙搭应用非云文档;内嵌表格/多维表格提取 token 切对应 skill;画板无技能,CLI 直连。评论走 lark-drive;表格/Base 内部操作不在本 skill。
docs
场景与 Shortcut 路由
CRITICAL:先判断场景,再读取该场景的参考文件;不要在任务开始时一次性读取全部参考文件。每个文件只在首次进入对应阶段时读取一次。
身份:文档操作推荐显式指定 --as user。
本地文件引用统一遵循文件访问权限:CWD 内优先使用 @./相对路径,其他目录使用 @绝对路径。XML 内的相对资源路径先查 CWD;仅文件不存在时再查源 XML 文件所在目录,同名文件以 CWD 为准。内联内容、stdin、在线文档没有源文件目录,不执行回退。
文档内容
- 读取 / 摘要 —
+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,禁止新建空白画板。lark-whiteboard skill 未随包收录,写入用lark-cli whiteboard +update(用法以--help为准)。 - 思维笔记 —
mindnotes:已有思维笔记走思维笔记链路。新建思维笔记暂无专门的 docs/mindnotes 创建命令:要新建到知识库,用wiki +node-create --obj-type mindnote(见lark-wiki-node-create.md),创建后按思维笔记链路维护节点;思维笔记不是画板(whiteboard),不要路由到画板工作流。
认证与 Scope
执行 Shortcut 时,不预读 lark-shared 或预跑 auth status --verify;仅遇到未认证、token / 身份或 scope 错误时读取该 Skill,修复后重试。认证、身份或 scope 管理请求则直接使用该 Skill。
不在本 Skill 范围
- Drive 文件级操作:找文档、导入导出、云空间文件上传 / 下载 / 权限管理 →
lark-drive。复制文档、创建副本或另存为副本时,按其指引使用lark-cli drive +copy(复制到知识库用wiki +node-copy);不要用docs +fetch+docs +create重建正文。 - 独立评论操作:添加、分页查看、回复评论或增删 reaction →
lark-drive;只需紧凑评论上下文时,直接使用默认 JSON 响应的docs +fetch。 - Drive 原生文件的历史版本:
docx等在线文档的历史版本走本 skill 的+history-*;但 Drive 二进制文件(type=file,如上传的附件)的历史版本查询 / 下载 / 回滚 / 删除 →lark-drive的+version-*,不走本 skill。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| canvas-designanthropics/skillsCreate beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations. | Stars: 195k | Updated | Claude CodeCodex | Verified | Install |
| docxanthropics/skillsUse this skill whenever the user wants to create, read, edit, or manipulate Word documents (.docx files) or Word templates (.dotx files). Triggers include: any mention of 'Word doc', 'word document', '.docx', '.dotx', or requests to produce professional documents with formatting like tables of contents, headings, page numbers, or letterheads. Also use when extracting or reorganizing content from .docx or .dotx files, inserting or replacing images in documents, performing find-and-replace in Word files, working with tracked changes or comments, or converting content into a polished Word document. If the user asks for a 'report', 'memo', 'letter', 'template', or similar deliverable as a Word or .docx file, use this skill. Do NOT use for PDFs, spreadsheets, Google Docs, or general coding tasks unrelated to document generation. | Stars: 195k | Updated | Claude CodeCodex | Verified | Install |
| pdfanthropics/skillsUse this skill whenever the user wants to do anything with PDF files. This includes reading or extracting text/tables from PDFs, combining or merging multiple PDFs into one, splitting PDFs apart, rotating pages, adding watermarks, creating new PDFs, filling PDF forms, encrypting/decrypting PDFs, extracting images, and OCR on scanned PDFs to make them searchable. If the user mentions a .pdf file or asks to produce one, use this skill. | Stars: 195k | Updated | Claude CodeCodex | Verified | Install |
| pptxanthropics/skillsUse this skill any time a .pptx or .potx file is involved in any way — as input, output, or both. This includes: creating slide decks, pitch decks, or presentations; reading, parsing, or extracting text from any .pptx or .potx file (even if the extracted content will be used elsewhere, like in an email or summary); editing, modifying, or updating existing presentations; combining or splitting slide files; working with templates (.potx), layouts, speaker notes, or comments. Trigger whenever the user mentions "deck," "slides," "presentation," or references a .pptx or .potx filename, regardless of what they plan to do with the content afterward. If a .pptx or .potx file needs to be opened, created, or touched, use this skill. | Stars: 195k | Updated | Claude CodeCodex | Verified | Install |