SKILL.md
docs
场景与 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。