feishu-doc-creator-skill

将本地Markdown文件一键转换为飞书文档,并自动管理权限。

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:feishu-doc-creator-skill。
它的用途是:将本地Markdown文件一键转换为飞书文档,并自动管理权限。
完整的 Skill 内容见:https://321skill.com/skills/feishu-doc-creator-skill/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

‘帮我把本地的项目周报README.md发布到飞书,标题设为“项目进展周报”,并添加小李为协作者。’ 它会自动解析Markdown文件,在飞书中创建新文档,上传所有本地图片,将文档所有权转移给你并添加指定协作者,最后验证文档可访问性并记录结果。

介绍

这个技能包解决了将本地Markdown文档高效、自动化地同步到飞书云文档的痛点。传统方式需要手动复制粘贴、调整格式、上传图片并设置权限,过程繁琐且容易出错。该技能包通过集成多个子技能,实现了从解析、创建、内容填充到权限设置和验证的完整流水线。

使用流程非常清晰:用户只需准备好Markdown文件和飞书应用凭证,运行授权脚本扫码登录,然后通过一条命令即可将指定文件转换为飞书文档。技能包内部会自动处理Markdown语法解析、本地图片上传、文档创建、添加协作者、转移所有权等所有步骤,并生成详细的日志。

它非常适合需要频繁在飞书上进行文档协作和知识管理的团队或个人,例如远程办公团队、项目文档管理者、技术写作者等。通过自动化,它将用户从重复的文档迁移工作中解放出来,专注于内容创作本身。

使用前请确保已按照指南在飞书开放平台创建应用并申请必要的API权限。首次使用需要完成OAuth授权,授权信息会本地保存。建议在转换包含大量图片的文档时注意网络环境,并定期检查生成的文档权限是否符合预期。

核心特点

与仅提供基础文档创建API调用的工具不同,本技能包提供了从Markdown解析、图片上传、权限管理到自动化验证的端到端解决方案,特别是其内置的“自动添加协作者+转移所有权”和“Playwright文档验证”功能,确保了文档创建后的可用性和协作性。

注意事项

不适合需要实时双向同步或复杂在线编辑的场景,主要用于从本地Markdown到飞书的单向发布。

常见问题

如何获取飞书应用的App ID和App Secret?

访问飞书开放平台,创建自建应用,在‘凭证与基础信息’页面即可获取。

支持哪些Markdown格式和图片类型?

支持25种块类型解析,本地图片路径(如D:/path/to/image.png)会自动上传至飞书。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/feishu-doc-creator-skill/raw/index.md 读取 feishu-doc-creator-skill 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。