orchestrator

用途

Orchestrator 是创意套件中的调度器（dispatcher），用于把涉及多种资产类型的创意工作按正确顺序路由到合适的技能，使风格只决定一次，并让下游每个资产都继承该风格。其首要规则是“策略先于像素”（strategy before pixels）：在风格锚点存在之前，绝不让生成开始——在简报之前生成的资产会被重新生成。它的定位是调度器而非讲师：快速诊断、选定一条路线、说明每一步向下一步传递什么。

何时使用 / 何时不使用

适用场景：请求跨越多种资产类型；请求命名的是结果而非资产（如“launch assets”“brand refresh”“content for the month”）；或不确定该用哪个技能。

不适用场景：单一明确资产应直接路由——一个 logo → skills/creative/brand-asset；一张产品图 → skills/creative/product-photography；一条 Instagram 帖子 → skills/creative/social-graphics；一张通用图片 → skills/creative/image-generation。

接诊（诊断——一批问题）

结果（Outcome）：这些资产用于什么事件/目标（发布、品牌重塑、持续内容、店面、视频）？
已有什么（What exists）：是否有风格指南或 Creative Direction Brief？是否有 logo/品牌资产？是否有产品照片？（已有产物可跳过其生产步骤。）
交付物与去向（Deliverables & destinations）：哪些资产，放在哪里（平台、商店、网站）？
自动化（Automation）：是否设置了 FAL_API_KEY（或 FAL_KEY）？若不确定，检查：python docs/creative_cli.py test

不要卡住：在已知结果的情况下，从上下文推断其余信息，说明假设，并给出计划。若自动化不可用，计划仍可运行——每一步的交付物变为提示词规格加可运行命令，而非生成的文件。

路由表

按第一条匹配的规则选定一条路线。顺序依据依赖关系；每个箭头标明向前传递的产物。

决策规则：

不存在风格锚点且需要多于 1 个资产 → 以下每条路线都以 skills/creative/creative-strategist 开始。
交付物中包含品牌标识 → brand-asset 先于任何复用该标识的技能运行。
视频交付物 → 先做静帧（它们是视频的源素材）。

路线：

A — 从零建立品牌识别：触发词“new brand”“set up my brand visuals”，什么都不存在。顺序：creative-strategist（Creative Direction Brief + style block）→ brand-asset（获批的 logo/icons/pattern + 指南条目）→ social-graphics 和/或 product-photography（使用标识 + style block 的发布就绪资产）。
B — 产品发布，识别已存在：触发词“launch assets”“images for my store/landing page”。顺序：product-photography（胜出的镜头组）→ social-graphics（复用这些镜头的平台帖子）→ 可选 product-video（消费主视觉静帧的脚本/计划）。
C — 社交活动 / 内容系列：触发词“week of content”“posts for X”，持续存在。顺序：creative-strategist（若已有简报则跳过）→ social-graphics（各平台图形）→ 可选 image-generation（缩略图、杂项视觉，通过自定义 CLI）。
D — 品牌重塑 / 焕新：触发词“rebrand”“new look”“our visuals feel stale”。顺序：creative-strategist（修订简报；与旧风格做 diff）→ brand-asset（重新生成的标识）→ social-graphics（公告资产）→ 若产品图像存在则重跑 B。
E — 视频主导：触发词“product video”“presenter video”“animated demo”。顺序：通过 B 或 C 准备静帧 → product-video 或 talking-head（计划/脚本）→ 若为编码式 Remotion 视频则用 remotion-script-writer。
F — 网页/应用设计：触发词“landing page”“app design”，响应式 UI。顺序：skills/creative/original-design（这是设计，不是资产生成）；将图像需求拉回 B/C。

横切规则：skills/creative/image-generation 是工具型技能，用于专家技能未覆盖的任何资产（缩略图、信息图、纹理）——按需插入；它像其他技能一样消费 style block。

自动化接线（事实，已对照仓库核实）

仅一个模型：FAL.ai 上的 fal-ai/nano-banana-pro。不存在 fast/quality 模型变体。
仓库根目录脚本：docs/fal_api.py（客户端）、docs/creative_cli.py（CLI：product / social / brand / custom / test）、docs/claude_integration.py（Python 辅助函数，含 batch_generate_assets）。
设置：pip install requests；export FAL_API_KEY="..."；用 python docs/creative_cli.py test 验证。
实际可调参数：--num-images 1–4、--aspect-ratio（21:9…9:16）、--resolution 1K/2K/4K，custom 还支持 --format png|jpeg|webp 和 --web-search。
输出自动落在 assets/product-photography/…、assets/social-graphics/…、assets/brand-assets/…、assets/<category>/…。
完整参考：skills/creative/image-generation/references/automation.md——在把任何生成命令写入计划前先阅读它。

使用方式（必需输出格式）

先交付计划，再逐步执行（按顺序调用每个技能，并向前携带其产物）：

Creative Production Plan — [outcome]

Route: [A–F name] — [one-line why this route] Style anchor: [existing brief / to be created in step 1 / assumed: ...] Automation: available (FAL_API_KEY set) | specs-only (no key — commands included)

Sequence

| # | Skill (path) | Produces | Feeds forward | | 1 | skills/creative/... | [artifact] | [what step 2 consumes] | | 2 | ... | ... | ... |

Asset map

Checkpoints

After step [n]: user picks [what] before [next step] starts.

First action

[The single next thing you will do — usually "run step 1 now".]

护栏（Guardrails）

一条路线。用一行理由确定；若确实接近，最多提供一个替代方案。不提供路线菜单。
在风格锚点存在之前绝不生成（或对一次性用途明确豁免）。
在选择点设置用户检查点——logo 概念之后、主视觉镜头变体之后——而非每张图之后。
不虚构能力。若缺少 FAL_API_KEY，如实说明；交付物为提示词规格 + 命令。绝不报告未生成的图像。
不重复生产已有内容。已有的简报/logo/镜头组跳过其步骤；改为消费它。
事实保持核实。模型 ID、脚本路径和 CLI 标志来自自动化参考——绝不凭记忆。

集成

向本技能输入：skills/product-strategy/foundation-sprint（定位和差异化会锐化路线 A/D 第 1 步的简报）。消费其输出：路由表中列出的每个 skills/creative/* 技能——计划告诉每个技能它接收什么产物、必须交回什么。

适用场景与限制

适用场景：多资产创意请求、以结果命名的请求、技能选择不明确的情况。限制：不适用于单一明确资产；在风格锚点存在前不生成；自动化依赖 FAL_API_KEY，缺失时只能输出提示词规格与命令；模型仅 fal-ai/nano-banana-pro 一种，无 fast/quality 变体。