Feishu Doc Orchestrator

Feishu Document Orchestrator (Nested Sub-skill)

飞书文档创建主编排子技能——将 Markdown 转换为飞书文档，编排 5 个子技能协作，使用文件传递数据节省 Token。内部嵌套组件。

When to Use

Use this skill when:

• 需要在嵌套层级中编排文档创建流程时
• 需要协调多个子技能按顺序执行时
• 需要通过文件传递中间结果以节省 Token 时

Do NOT use this skill if:

• 需要顶层编排入口 → use feishu-doc-orchestrator (parent) instead
• 只需要单个子技能功能 → 直接调用对应子技能
• 需要创建到知识库 → use feishu-wiki-orchestrator instead

Typical triggers:

• 「编排文档创建流程」「协调飞书子技能」
• "orchestrate doc creation pipeline", "coordinate feishu sub-skills"

Workflow

1. 探查 (Probe) 确认 Markdown 文件路径和文档标题。

2. 约束 (Constrain) 子技能之间只传递文件路径，不传递实际内容（节省 60-80% Token）。每步结果保存到 workflow/ 目录，支持断点续传。

3. 执行 (Execute) 五步编排：

4. Markdown 解析：feishu-md-parser → workflow/step1_parse/blocks.json

5. 文档创建+权限管理：feishu-doc-creator-with-permission → workflow/step2_create_with_permission/doc_with_permission.json

6. 块添加：feishu-block-adder → workflow/step3_add_blocks/add_result.json

7. 文档验证：feishu-doc-verifier → workflow/step4_verify/verify_result.json

8. 日志记录：feishu-logger → CREATED_DOCS.md + created_docs.json

python scripts/orchestrator.py input.md "文档标题"

4. 验证 (Verify) 检查每步输出文件是否存在且包含有效数据，确认最终文档可访问。

5. 交付 (Deliver) 返回文档 URL 和创建日志，清理临时文件。

Output

成功完成后返回文档 URL、CREATED_DOCS.md、created_docs.json 和完整的 workflow/ 中间结果。

数据流：

input.md → [feishu-md-parser] → blocks.json
→ [feishu-doc-creator-with-permission] → doc_with_permission.json
→ [feishu-block-adder] → add_result.json
→ [feishu-doc-verifier] → verify_result.json
→ [feishu-logger] → CREATED_DOCS.md + created_docs.json

Guardrails

Anti-patterns

• NEVER 在子技能之间传递实际内容（只传文件路径）
• Do NOT 跳过任何编排步骤（尤其是权限管理）
• Do NOT 独立使用本子技能——应由父技能调用

Constraints

• 单一职责：每个子技能只做一件事
• 中间结果保存为文件，可追溯、可断点续传
• Callout 块颜色字段必须直接放在 callout 对象下

Related Skills

• feishu-doc-orchestrator (parent) — 顶层主编排技能
• feishu-md-parser — 子技能：解析 Markdown
• feishu-block-adder — 子技能：添加块

About UniqueClub

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