feishu-cli-docs
飞书云文档正文：读取与总结 docx/wiki/sheet（含转成可直接发 IM 的 Markdown），从零创作文档（PRD、方案、报告、纪要等体裁模板，DocxXML 草稿与 doc script 预检），创建与编辑 docx（带内容新建并上传本地图片/附件/HTML 块/画板源文件、追加、覆盖、按章节或 block 精确替换/删除/移动、插入本地或剪贴板图片、设置文档封面、历史版本查看与回滚），Markdown 导入（Mermaid/PlantUML/SVG 转画板），导出 Markdown/PDF/Word/Excel 与下载或预览文档素材，云盘原生 .md 文件的上传、diff 与覆盖，以及读取和编辑已有思维笔记的节点。用户要阅读、总结、撰写、写入或改写飞书文档，把 Markdown 导入飞书，把文档导出到本地，设置文档封面，操作思维笔记节点，或把误改的文档回滚时使用。不用于：评论（即使请求提到文档）、协作者与权限、DOCX/XLSX 等二进制导入、上传文件的版本和云盘目录，使用 feishu-cli-storage；按单元格读写表格使用 feishu-cli-data；文档内 HTMLBox/ECharts 动态组件使用 feishu-cli-visual；获取会议的纪要、妙记与逐字稿使用 feishu-cli-meetings（撰写纪要类文档仍用本 Skill）。
- Installs
- 167
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-docs- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads feishu-cli-docs automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
飞书文档
只读取当前任务需要的工作流；跨步骤任务可以按顺序读取多个。
加载后，将工作流中的 references/、scripts/、templates/、examples/ 相对路径按该
workflow.md 所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。
路由
| 意图 | 读取文件 |
|---|---|
| 阅读、总结、分析 docx/wiki/sheet，大文档按大纲/章节/关键词局部读取，获取块结构，不主动落盘 | references/workflows/read/workflow.md |
取文档内容转成可直接发 IM 的 Markdown（doc read --doc-format im-markdown，--lang 控制 @人显示语言） | references/workflows/read/workflow.md |
带 block id 读取（doc read --with-ids / --engine docs_ai），为精确修改做准备 | references/workflows/read/workflow.md |
从零创作文档（写 / 起草方案、PRD、周报、纪要、报告、教程等），选体裁、写 DocxXML 草稿并用 doc script 初始化与预检 | references/workflows/author/workflow.md |
创建 docx（含 doc create --content 带本地图片/附件、HTML 块、画板源文件建文档）、追加、覆盖、替换、删除或移动内容，按 block id 精确改写，插入本地或剪贴板图片/附件（--from-clipboard） | references/workflows/write/workflow.md |
设置、下载或删除文档封面（doc resource update/download/delete --type cover） | references/workflows/write/workflow.md |
查看历史版本、回滚文档（doc history list/revert/revert-status） | references/workflows/write/workflow.md |
| 把 Markdown 文件导入为飞书 docx（含 Mermaid/PlantUML/SVG 转画板） | references/workflows/import/workflow.md |
导出 docx/wiki/sheet 到本地 Markdown/PDF/Word/Excel，下载或预览文档内图片、附件、评论图片或画板缩略图（doc media-download / doc media-preview） | references/workflows/export/workflow.md |
上传、下载、覆盖、查找替换或比较云盘原生 .md | references/workflows/markdown/workflow.md |
读取已有思维笔记的节点，新增子节点或更新节点（mindnote nodes list/create） | references/workflows/mindnote/workflow.md |
关键边界
- “查看并总结”走 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。
FAQ
What does the feishu-cli-docs skill do?
飞书云文档正文：读取与总结 docx/wiki/sheet（含转成可直接发 IM 的 Markdown），从零创作文档（PRD、方案、报告、纪要等体裁模板，DocxXML 草稿与 doc script 预检），创建与编辑 docx（带内容新建并上传本地图片/附件/HTML 块/画板源文件、追加、覆盖、按章节或 block 精确替换/删除/移动、插入本地或剪贴板图片、设置文档封面、历史版本查看与回滚），Markdown 导入（Mermaid/PlantUML/SVG 转画板），导出 Markdown/PDF/Word/Excel 与下载或预览文档素材，云盘原生 .md 文件的上传、diff 与覆盖，以及读取和编辑已有思维笔记的节点。用户要阅读、总结、撰写、写入或改写飞书文档，把 Markdown 导入飞书，把文档导出到本地，设置文档封面，操作思维笔记节点，或把误改的文档回滚时使用。不用于：评论（即使请求提到文档）、协作者与权限、DOCX/XLSX 等二进制导入、上传文件的版本和云盘目录，使用 feishu-cli-storage；按单元格读写表格使用 feishu-cli-data；文档内 HTMLBox/ECharts 动态组件使用 feishu-cli-visual；获取会议的纪要、妙记与逐字稿使用 feishu-cli-meetings（撰写纪要类文档仍用本 Skill）。
How do I install feishu-cli-docs?
Run npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-docs in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/feishu-cli-docs/ (personal) or .claude/skills/feishu-cli-docs/ (project).
Which AI agents can use feishu-cli-docs?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is feishu-cli-docs safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains feishu-cli-docs?
It is published by riba2534 in riba2534/feishu-cli. It has 167 recorded installs.
More from riba2534/feishu-cli
feishu-cli-toolkit
riba2534/feishu-cli
飞书轻量工具箱与分诊入口。仅在没有更专用 skill 时使用，主要覆盖普通电子表格、 日历/日程、任务/任务清单、基础文件/素材/评论、知识库、用户和部门查询、审批查询。 文档读写导入导出、云盘增强、多维表格、画板、消息/群聊、邮箱、搜索、权限、OAuth、 视频会议/妙记均优先使用对应 feishu-cli- 专用技能。 sheet filter-view/dropdown 优先用 feishu-cli-sheet；calendar suggestion/room-find/rsvp 优先用 feishu-cli-calendar。
feishu-cli-read
riba2534/feishu-cli
只读操作，不修改文档内容。读取飞书云文档、知识库内容或电子表格，分析文档结构。 支持普通 docx、普通 sheet、知识库 docx 和知识库 sheet。当用户请求"查看"、"阅读"、"分析"、"读取"、 "打开"、"read"、"view" 飞书文档、知识库或电子表格时使用。支持通过文档 ID、知识库 Token 或 URL 读取。 Markdown 仅作为分析中间态存放在 /tmp（不主动落地为用户文件）；如需主动导出到本地路径请用 feishu-cli-export， 写入请用 feishu-cli-write。
feishu-cli-msg
riba2534/feishu-cli
飞书消息发送。发送消息（text/post/interactive 卡片等 10 种类型：text/post/image/file/audio/media/sticker/interactive/sharechat/shareuser；system 分割线 CLI 暂未直接支持，需用 feishu-cli api 透传）、回复消息、 转发/合并转发、消息加急、消息书签（flag 收藏/list/cancel）、下载消息资源（图片/文件）。 发送/回复/转发/加急默认 App Token（Bot 身份）；msg flag 收藏/书签必需 User Token（im:feed.flag:read/write）； msg resource-download 已登录时优先 User Token，未登录回落 App Token。 当用户明确请求通过飞书即时消息/Bot 消息发送、回复、转发、合并转发、加急、消息收藏/书签、 下载消息图片或文件时使用。邮件走 feishu-cli-mail；文档评论/共享权限走对应 skill。 注意：Reaction/Pin/获取消息详情/批量获取消息/话题回复/消息历史/搜索群聊/群聊管理， 以及消息删除（默认 App Token 用于 Bot 自撤回，可选 User Token 让管理员撤回他人） 请使用 feishu-cli-chat 技能。 发送 interactive 卡片时，先用 feishu-cli-card 构造 v2 JSON， 再回到本技能用 --msg-type interactive --content-file 发送。
feishu-cli-write
riba2534/feishu-cli
向飞书文档写入内容、创建新文档、新建空白文档。支持 doc import 从 Markdown 创建、 doc content-update 精准追加/覆盖/替换/插入/删除，doc add/update/delete 低层块操作， 以及图片/文件插入。当用户请求创建文档、写文档、更新文档、替换章节、插入章节、 删除章节、追加内容、覆盖文档、插入图片或文件时使用。
feishu-cli-export
riba2534/feishu-cli
将飞书文档、知识库文档或电子表格导出到本地。支持 docx/wiki/sheet 导出 Markdown， doc export 内嵌电子表格自动展开，图片/画板素材下载，以及 doc export-file 异步导出 PDF/Word/Excel。当用户请求导出文档、保存为 Markdown、导出 PDF/Word/Excel、下载文档图片、 导出表格或表格转 Markdown 时使用。本地导入请用 feishu-cli-import 或 feishu-cli-drive。
feishu-cli-import
riba2534/feishu-cli
从 Markdown 文件导入创建飞书文档。支持嵌套列表、Mermaid/PlantUML 图表自动转画板、 大表格智能处理（超过 9 行用 inserttablerow API 追加保持单 block，超过 9 列拆分保留首列）、公式、Callout 高亮块。 内置飞书侧渲染规范（references/doc-guide.md + references/mermaid-spec.md）， 覆盖图表花括号/par 等语法限制、表格 9 行/列阈值、Callout 6 种颜色映射等飞书兼容性规则。 当用户请求"导入 Markdown"、"从 md 创建文档"、"从 md 文件创建文档"、"把 Markdown 转换到飞书"、 "上传 Markdown"、"Markdown 转飞书"、"md 导入"、"批量导入"，或排查"飞书 Mermaid 渲染失败"、 "Callout 颜色不对"、"飞书表格被拆"、"飞书文档导入兼容性"等问题时使用。 注意：仅支持 Markdown 源文件导入为飞书文档。Markdown 表格创建电子表格请用 feishu-cli-toolkit 的 sheet import-md； DOCX/XLSX 导入为云文档请使用 feishu-cli-drive 的 drive import。
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown：查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件，或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档，也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.