SuperAPI AI 工具集

lark-doc

通用与其它

查看项目

更新于 10-15 21:41

技能介绍

用途:面向飞书云文档(Docx / Wiki)的内容操作,包括读取、创建、编辑文档,插入或下载图片附件,以及操作思维笔记。当用户提供文档 URL 或 token(包括 doubao.com 的 /docx/、/wiki/)时使用;按 URL 路径/token 而非域名路由。

主要能力与用法:先判断场景,再读取对应参考文件,不要一次性读取全部参考。文档操作推荐显式指定 --as user。读取/摘要用 +fetch;从零创作走创建工作流;仅创建空文档或原样导入完整内容用 +create;编辑、润色、重组、补写或排版用 +update。辅助能力包括 +script(解析 URL/token 与本地 XML、统计字数,不支持 Markdown 输入)、历史版本 +history-list / +history-revert / +history-revert-status。资源方面:+media-insert 在文末插入本地图片或文件,+media-preview 预览素材,+media-download 下载素材或画板缩略图,+resource-download / +resource-update / +resource-delete 管理 Docx 封面。画板需先读工作流,更新已有画板必须复用现有 token,禁止新建空白画板,用 whiteboard +update 写入。思维笔记已有走思维笔记链路,新建走 lark-doc-whiteboard。

本地文件引用:CWD 内优先 @./相对路径,其他目录用 @绝对路径;XML 内相对资源路径先查 CWD,仅文件不存在时再查源 XML 所在目录,同名以 CWD 为准;内联内容、stdin、在线文档无源文件目录,不回退。

认证与限制:执行 Shortcut 时不预读 lark-shared 或预跑 auth status --verify,仅在遇到未认证、token/身份或 scope 错误时读取并修复后重试。不在本 Skill 范围:Drive 文件级操作(找文档、导入导出、上传下载、权限管理)走 lark-drive;复制文档用 lark-cli drive files copy,不要用 docs +fetch + docs +create 重建正文;独立评论操作走 lark-drive,仅需紧凑评论上下文时用默认 JSON 响应的 docs +fetch。