核心功能
飞书文档 skill 是基于飞书开放平台 API 构建的 CLI 工具封装，提供完整的云文档管理能力。核心功能覆盖文档的读取（get/get-blocks）、创建（create）、更新（update）、删除（delete）以及批量导入（import-file）和文件夹浏览（list）六大模块。支持 JSON、Markdown、Text 等多种输出格式，可将本地 txt、docx、xlsx、csv、md 等文件一键转为飞书文档。
显著优点
企业级集成能力：直接调用飞书官方 Open API，数据流转符合企业合规要求，支持租户级权限隔离（auth:tenant）。格式兼容性强：导入功能覆盖主流办公格式，且自动轮询转换任务状态，对大文件处理友好。自动化友好：CLI 设计便于集成 CI/CD 或定时任务，文档元数据自动落盘（doc-{id}.json），方便后续追踪。权限粒度细：docx:document、drive:file、drive:importTask 等 scope 分离，最小权限原则可落地。
潜在局限
认证门槛高：需自建飞书企业应用并配置 5 项以上权限，非管理员难以独立开通。令牌体系复杂：文档 token（docc）与文件夹 token（fold）需人工区分，批量操作易混淆。覆盖风险：update 默认覆盖模式，追加需显式 --append 标志，误操作可能导致数据丢失。删除不可逆：delete --force 无回收站保护机制，企业级场景建议前置备份策略。
适合人群
- 需将本地知识库批量迁移至飞书的企业 IT 管理员
- 构建文档自动化工作流的开发者（如日报生成、合同归档）
- 在 Claude Code 中实现「AI 写文档→自动入库」闭环的技术团队
常规风险
- 凭证泄露：.env 文件若纳入版本控制，App Secret 存在外泄风险
- 权限滥用：drive:drive 的删除权限与 docx:document 的编辑权限聚合，需按最小原则授权
- API 限流：大文件导入与高频 list 操作可能触发飞书侧限流，生产环境建议加指数退避