Feishu Cli Docs

---
name: feishu-cli-docs
description: >-
  飞书文档统一入口，覆盖读取和分析 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；
  文档内 HTMLBox、ECharts 交互图表和其他动态组件只使用 feishu-cli-visual，不属于正文编辑。
  只要意图是评论的 list/reply/resolve，即使请求中出现“文档”，也不要使用本 Skill。
compatibility: Requires feishu-cli v1.41.0+ and network access for Feishu API calls.
allowed-tools: Bash(feishu-cli:*) Bash(./feishu-cli:*) Bash(./bin/feishu-cli:*) Bash(jq:*) Bash(python3:*) Bash(sleep:*) Read Write
---

# 飞书文档

只读取当前任务需要的工作流；跨步骤任务可以按顺序读取多个。
加载后，将工作流中的 `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. 用户明确指定接收人时按其要求授权；其余按 write 工作流读取生效的 `owner_email` / `transfer_ownership`，仅在已配置 owner 时处理。未要求通知时在当前会话返回文档链接。