feishu-doc-orchestrator（飞书文档编排器）

飞书文档创建技能 - GitHub发布版

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

快速开始

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"

2. 检查配置

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

3. 使用技能

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

支持的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-doc-orchestrator/        # 主技能
├── feishu-md-parser/               # Markdown解析
├── feishu-doc-creator-with-permission/  # 创建+权限
├── feishu-block-adder/             # 批量添加
├── feishu-doc-verifier/            # 文档验证
└── feishu-logger/                  # 日志记录

测试脚本

# 测试所有25种块类型
python .claude/skills/feishu-doc-orchestrator/scripts/test_all_25_blocks.py

注意事项

⚠️ 重要：

• 配置文件包含敏感信息，请勿提交到Git
• .claude/feishu-config.env 和 .claude/feishu-token.json 已在.gitignore 中
• 发布时请确保不包含个人隐私数据