# Feishu CLI Docs

> 飞书文档统一入口，覆盖读取和分析 docx/wiki/sheet、创建与编辑文档、Markdown 导入、 docx/wiki/sheet 导出 Markdown/PDF/Word/Excel，以及云盘原生 .md 文件 CRUD。用户要求阅读、 总结、创建、追加、覆盖、替换或删除文档内容，把 Markdown 导入飞书并转换 Mermaid/PlantUML/SVG、 下载图片或导出本地文件、 比较、覆盖或查找替换原生 Markdown 时必须使用本 Skill。 本 Skill 只处理正文内容和文档/Markdown 文件转换。明确禁止用于文档评论、二进制文件导入、 云盘目录和权限管理，这些使用 feishu-cli-storage；考勤等工作管理使用 feishu-cli-work； 动态组件使用 feishu-cli-visual。 只要意图是评论的 list/reply/resolve，即使请求中出现“文档”，也不要使用本 Skill。

- Skill: `riba2534/feishu-cli-docs` (Agent Skill, multi-file: 9 files)
- Install (CLI): `npx skillmds add riba2534/feishu-cli-docs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/riba2534/feishu-cli-docs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Data & Analytics
- Author: riba2534 (https://skillmd.com/u/riba2534)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/riba2534/feishu-cli-docs

---


# 飞书文档

只读取当前任务需要的工作流；跨步骤任务可以按顺序读取多个。
加载后，将工作流中的 `references/`、`scripts/`、`templates/`、`examples/` 相对路径按该
`workflow.md` 所在目录解析；执行脚本时使用解析后的实际路径，不要依赖当前 shell 目录。

## 路由

| 意图 | 读取文件 |
|---|---|
| 阅读、分析、获取块结构，不主动落盘 | `references/workflows/read/workflow.md` |
| 创建、追加、覆盖、替换或编辑 docx | `references/workflows/write/workflow.md` |
| 把 Markdown 导入为飞书 docx | `references/workflows/import/workflow.md` |
| 导出 docx/wiki/sheet 到本地文件 | `references/workflows/export/workflow.md` |
| 上传、下载、覆盖、查找替换或比较云盘原生 `.md` | `references/workflows/markdown/workflow.md` |

## 关键边界

- “查看并总结”走 read；明确要求保存到路径才走 export。
- Markdown 转为可阅读 docx 走 import；把 `.md` 源文件原样存入云盘走 markdown。
- DOCX/XLSX 等二进制文件导入走 `feishu-cli-storage` 的 drive 工作流。
- `doc htmlbox` 属于 `feishu-cli-visual`；权限和转移所有权属于 `feishu-cli-storage`。

## 执行规则

1. 解析 URL 后区分普通文档 token 与 wiki node token。
2. 写入前确认目标、更新模式和影响范围；优先 dry-run 或测试文档。
3. 导入前读取 `references/workflows/import/references/doc-guide.md`。
4. 创建文档后按项目 owner_email 规则授权；不要把真实邮箱写进示例。