飞书云文档技能，围绕飞书 docx、wiki、sheet 等文档的读取、创作、编辑、导入导出与思维笔记操作提供命令行工作流。
用途与路由 该技能按任务意图选择对应工作流：阅读、总结、分析 docx/wiki/sheet 走 read；从零创作文档走 author；创建、编辑已有文档走 write；Markdown 导入为飞书 docx 走 import；导出到本地走 export；云盘原生 .md 操作走 markdown；思维笔记节点增改走 mindnote。跨步骤任务可按顺序读取多个工作流。加载后，工作流中的 references/、scripts/、templates/、examples/ 相对路径按该 workflow.md 所在目录解析，执行脚本时使用解析后的实际路径，不依赖当前 shell 目录。
主要能力 读取方面：支持阅读、总结、分析 docx/wiki/sheet，大文档可按大纲、章节、关键词局部读取，获取块结构且不主动落盘；可将文档内容转成可直接发 IM 的 Markdown（doc read --doc-format im-markdown，--lang 控制 @人显示语言）；支持带 block id 读取（doc read --with-ids / --engine docs_ai），为精确修改做准备。 创作方面：可从零创作文档，选择体裁、编写 DocxXML 草稿并用 doc script 初始化与预检，覆盖方案、PRD、周报、纪要、报告、教程等。 编辑方面：创建 docx（含 doc create --content 带本地图片/附件、HTML 块、画板源文件建文档）、追加、覆盖、替换、删除或移动内容，按 block id 精确改写，插入本地或剪贴板图片/附件（--from-clipboard）；可设置、下载或删除文档封面（doc resource update/download/delete --type cover）；可查看历史版本、回滚文档（doc history list/revert/revert-status）。 导入导出方面：把 Markdown 文件导入为飞书 docx（含 Mermaid/PlantUML/SVG 转画板）；导出 docx/wiki/sheet 到本地 Markdown/PDF/Word/Excel，下载或预览文档内图片、附件、评论图片或画板缩略图（doc media-download / doc media-preview）；上传、下载、覆盖、查找替换或比较云盘原生 .md。 思维笔记方面：读取已有思维笔记的节点，新增子节点或更新节点（mindnote nodes list/create）。
关键边界 “查看并总结”走 read，明确要求保存到路径才走 export；从零写一篇文档走 author，只建空文档、原样写入用户给定完整内容或改已有文档走 write；Markdown 转为可阅读 docx 走 import，把 .md 源文件原样存入云盘走 markdown；mindnote nodes create 只在已有思维笔记里新增/更新节点，不新建思维笔记，新建思维导图走 feishu-cli-visual 的画板；DOCX/XLSX 等二进制文件导入走 feishu-cli-storage 的 drive 工作流；doc htmlbox 属于 feishu-cli-visual；权限和转移所有权属于 feishu-cli-storage。
使用方式与执行规则 /wiki/ 链接或类型不明的 token 先用 drive inspect --url 解析，Bitable 链接用 bitable resolve；wiki 链接解析后区分 node_token 与底层文档 obj_token，底层是 sheet/bitable/slides 时按类型交给对应技能。修改已有文档一律用 doc content-update，不要用 doc import --document-id（只会追加到文末）；改几个字用文本级替换，改章节或块先 doc read --with-ids 拿 block id；写入前确认目标、更新模式和影响范围，content-update 没有 dry-run，不确定时先在测试文档上验证。写命令默认 Bot 身份，Bot 新建的文档会自动给当前登录用户授予 full_access（输出 permission_grant）；编辑用户自己的文档而 Bot 无权限时，显式 --user-access-token "$(feishu-cli auth token --as user)"；读命令 User 优先、Bot 兜底。按退出码处理结果：2 表示参数或定位有歧义（选择器多处命中、方言占位无法写回、本地文件不存在），修正参数后重试；1 且有失败明细（doc import 的 failures、content-update 的 partial_success、本地资源 failed）时按明细补齐，不要整篇重导；10 表示危险操作缺 --yes（doc delete、doc history revert）。导入前读取 references/workflows/import/references/doc-guide.md。用户明确指定接收人时按其要求授权，其余按 write 工作流读取生效的 owner_email / transfer_ownership，仅在已配置 owner 时处理；未要求通知时在当前会话返回文档链接。删除、覆盖类命令返回退出码 10 时，向用户确认目标与影响后追加全局 --yes 重跑，不要自行添加。身份或 scope 报错（如 99991663/99991668/99991672/99991679）读取 ../feishu-cli-platform/references/workflows/auth/references/identity.md；判断成败、编写脚本或处理确认门禁读取 ../feishu-cli-platform/references/workflows/auth/references/agent-contract.md。
适用场景 适合需要以命令行方式批量或自动化处理飞书文档的任务，例如读取并总结会议纪要、按模板起草 PRD 与周报、精确改写已有文档章节、把本地 Markdown 导入为飞书文档、将飞书文档导出为本地多种格式，以及维护思维笔记节点。
限制 该技能依赖飞书 CLI 及相应身份与权限配置；部分操作（删除、历史回滚）需显式 --yes 确认；content-update 无 dry-run；思维笔记仅支持在已有笔记中增改节点，不新建思维笔记；二进制文件导入、htmlbox、权限与所有权转移由其他技能负责。具体收费、价格与平台支持情况暂未提供。