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; 文档内 HTMLBox、ECharts 交互图表和其他动态组件只使用 feishu-cli-visual,不属于正文编辑。 只要意图是评论的 list/reply/resolve,即使请求中出现“文档”,也不要使用本 Skill。
How do I install this agent skill?
npx skills add https://github.com/riba2534/feishu-cli --skill feishu-cli-docsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill is safe and provides comprehensive tools for managing Feishu documents via a command-line interface. It uses local configuration files for authentication management and standard shell commands for data validation. While it reads external document content, it has an inherent surface for indirect prompt injection, which is common for analysis tools.
- Socketwarn
1 alert: gptAnomaly
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
飞书文档
只读取当前任务需要的工作流;跨步骤任务可以按顺序读取多个。
加载后,将工作流中的 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。
执行规则
- 解析 URL 后区分普通文档 token 与 wiki node token。
- 写入前确认目标、更新模式和影响范围;优先 dry-run 或测试文档。
- 导入前读取
references/workflows/import/references/doc-guide.md。 - 用户明确指定接收人时按其要求授权;其余按 write 工作流读取生效的
owner_email/transfer_ownership,仅在已配置 owner 时处理。未要求通知时在当前会话返回文档链接。
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/riba2534/feishu-cli/feishu-cli-docs">View feishu-cli-docs on skillZs</a>