/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；
  动态组件使用 feishu-cli-visual。
  只要意图是评论的 list/reply/resolve，即使请求中出现“文档”，也不要使用本 Skill。
argument-hint: <read|write|import|export|markdown> [args]
user-invocable: true
allowed-tools: Bash(feishu-cli:*), Bash(./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. 创建文档后按项目 owner_email 规则授权；不要把真实邮箱写进示例。