feishu-doc-orchestrator

用途

feishu-doc-orchestrator 是一个飞书文档创建主编排技能，主要用途是将 Markdown 文件转换为飞书文档。它通过编排多个子技能协作完成整个转换流程，并支持 25 种飞书文档块类型。

主要能力

• 将 Markdown 文件转换为飞书文档。
• 支持 25 种飞书文档块类型，具体包括：
  • 基础文本（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
• 提供完整的权限管理。
• 技能架构由多个子技能组成：
  • feishu-md-parser：Markdown 解析
  • feishu-doc-creator-with-permission：创建 + 权限
  • feishu-block-adder：批量添加
  • feishu-doc-verifier：文档验证
  • feishu-logger：日志记录

使用方式

1. 配置飞书应用

首次使用需要配置飞书开放平台应用信息，可运行：

python .claude/skills/feishu-doc-orchestrator/scripts/setup_config.py

或手动创建配置文件 .claude/feishu-config.env：

# 从 https://open.feishu.cn/ 获取
FEISHU_APP_ID = "cli_xxx"
FEISHU_APP_SECRET = "xxxxxxxx"

# 可选：自动添加文档权限
FEISHU_AUTO_COLLABORATOR_ID = "ou_xxx"

# 可选：默认文件夹
FEISHU_DEFAULT_FOLDER = "folder_token"

1. 检查配置

python .claude/skills/feishu-doc-orchestrator/scripts/check_config.py

1. 使用技能

以自然语言指令触发，例如：

请帮我将 docs/example.md 转换为飞书文档

测试脚本

可运行以下脚本测试所有 25 种块类型：

python .claude/skills/feishu-doc-orchestrator/scripts/test_all_25_blocks.py

适用场景

适用于需要将 Markdown 内容批量或自动化转换为飞书文档的场景，尤其是需要覆盖多种块类型（如文本、列表、代码块、表格、多维表格等）并管理文档权限的情况。

限制与注意事项

• 配置文件包含敏感信息，请勿提交到 Git。
• .claude/feishu-config.env 和 .claude/feishu-token.json 已在 .gitignore 中。
• 发布时请确保不包含个人隐私数据。
• 关于收费、价格、平台兼容性、具体效果等信息，资料中暂未提供。