feishu-doc-orchestrator

name

feishu-doc-orchestrator

description

飞书文档创建主编排技能 / Feishu document creation orchestrator. 将 Markdown 文件转换为飞书文档，编排多个子技能协作完成，支持25种飞书文档块类型。 Use when: 创建飞书文档, create feishu doc, markdown转飞书, markdown to feishu, 飞书文档排版, feishu document formatting, 批量导入文档, batch import documents, 飞书块类型, feishu block types, 文档权限管理, document permission management. Related: feishu-doc, feishu-wiki-orchestrator, feishu-doc-perm, feishu-doc-converter. Part of the Feishu automation toolkit by UniqueClub.

Feishu Document Orchestrator

将 Markdown 文件转换为飞书文档，支持25种块类型，完整权限管理。

When to Use

• 需要将 Markdown 文件发布为飞书文档时
• 需要创建包含多种块类型（表格、代码块、图片等）的飞书文档时
• 需要自动分配文档权限给群聊或指定用户时
• 需要批量导入多个 Markdown 文档到飞书时

Do NOT use this skill if

• 只需要读取现有飞书文档 → 使用 feishu-doc
• 需要创建到知识库（Wiki） → 使用 feishu-wiki-orchestrator
• 只需要下载已有文档或 PDF → 使用 feishu-pdf-downloader

Typical Trigger Phrases

• "帮我把这个 Markdown 转成飞书文档"
• "Create a Feishu doc from this markdown"
• "批量导入这些文档到飞书"
• "生成飞书文档并设置权限"

Workflow

1. Ask for inputs: 确认 Markdown 文件路径、目标文档标题、是否需要设置权限
2. Check configuration: 运行 python .claude/skills/feishu-doc-orchestrator/scripts/check_config.py 验证飞书应用配置
3. Parse Markdown: 调用 feishu-md-parser 将 Markdown 解析为飞书块格式
4. Create document: 调用 feishu-doc-creator-with-permission 创建文档并分配权限
5. Add blocks: 调用 feishu-block-adder 批量添加25种支持的块类型
6. Verify: 调用 feishu-doc-verifier 验证文档可访问性和内容完整性
7. Log result: 调用 feishu-logger 记录创建结果并返回文档 URL

Guardrails

• 配置文件 .claude/feishu-config.env 包含敏感信息，请勿提交到 Git
• .claude/feishu-config.env 和 .claude/feishu-token.json 已在 .gitignore 中
• 首次使用前必须通过 scripts/setup_config.py 完成飞书应用配置
• 发布前确保不包含个人隐私数据

Supported Blocks

基础文本（11种）：text, heading1-9, quote_container
列表（4种）：bullet, ordered, todo, task
特殊块（5种）：code, quote, callout, divider, image
AI块（1种）：ai_template
高级块（5种）：bitable, grid, sheet, table, board

Related Skills

• feishu-doc - 只读读取飞书文档
• feishu-wiki-orchestrator - 在知识库中创建文档
• feishu-doc-perm - 文档权限管理
• feishu-doc-converter - 文档格式转换

About

Part of the Feishu automation toolkit by UniqueClub. 🌐 https://uniqueclub.ai