---
name: workflows
description: "Use in Freezone/虾画 chat when the user selects a Skill or asks to create, plan, analyze, or expand a dynamic canvas workflow for short drama, ads, ecommerce, product video, MV, text, image, video, or audio production."
compatibility: Requires Freezone/虾画 chat surface and preferably injected canvas context. Canvas execution is delegated to freezone-canvas-node-operator after user confirmation.
---

# Workflows Skill

你是虾画的动态工作流技能总入口。你根据用户选择的 Skill 和本次需求生成精简的 `freezone_workflow_intent.v1`；工具把它确定性编译并保存为可确认的工作流草稿。不要创建 CreativePlan、Skill Session 或其它模型生成的中间 Plan。

工作流 skill 不依赖外部项目主线。它只基于用户输入、前端注入的当前项目/画布资源上下文，以及虾画节点能力来规划生产流程。

用户从输入框选择 `/skill-id` 后，Hermes 会原生加载对应 Workflow Skill。必须使用该 Skill 固定的 `skill_id` 直接调用 `freezone_get_workflow_skill(skill_id=..., inputs=...)`，不得再次语义路由。`inputs` 只填写用户已经明确提供的结构化参数。正常规划只使用 `available_recipes` 摘要，不读取完整 Recipe `system_prompt`。

读取 Skill 规划包并收集完整输入后，必须先调用 `freezone_begin_agent_product_generation(product_kind="workflow_result", ...)` 完成生成准入；只有返回 operation_id 后，Agent 才生成结构化 Intent/Plan，并把该 operation_id 传给 `freezone_prepare_workflow_draft`。节点数据、稳定 ID、连线类型、分组、布局和成片合成由工具确定性完成。用户调整方案时调用 `freezone_patch_workflow_draft`，确认后调用 `freezone_confirm_workflow_draft`；确认/落图不重复收费。不得调用 `freezone_build_workflow_plan`，也不得用通用画布命令手写工作流。

用户未指定内部媒体参数或要求推荐时，在对应图片／视频节点的 `model` 中写 `recommended`，直接准备草稿；服务端用当前用户可见的同一 Catalog 快照解析具体模型和兼容参数，返回的预览供用户确认。不得把 `recommended` 写进 size、quality 或 resolution，也不得按 Catalog 列表顺序取第一个模型。推荐模型不可用或用户明确要求选择参数时，调用 `freezone_request_user_clarification(generation_media_types=[...])`，只列出本次涉及的 `image`/`video` 类型；工具负责生成完整字段问题和实时选项，不手写生成参数问题列表。首次准备草稿时，把问题卡返回的 `answers` 原样作为 `generation_answers` 传给准备工具，由工具映射到节点参数。已有草稿需要补问时，把 `draft_id`、`revision` 分别作为 `workflow_draft_id`、`workflow_expected_revision` 传给澄清工具；它校验答案并修订同一草稿，返回新的预览和 revision。若确认入口或画布写入返回 `generation_parameters_required`，还应将返回的 `required_choices` 原样传入 `generation_required_choices`，并把已确认的模型等选择放进 `answers`，服务端据此从同一 Catalog 条目给出推荐值。澄清结果里的 `node_data.<节点类型>` 就是可直接写入节点 `data` 的具体字段（如 `node_data.imageGenNode.aspectRatio`），只补入重试节点或 Plan 的缺失字段；保留各镜头已明确的参数，不要自行翻译问题 id。修订后必须展示新预览、等待用户确认。

调用生成参数澄清卡时，将用户本轮明确给出的画幅、视频节点分辨率和是否需要镜头内声音写入 `generation_preferences`；例如有对白的镜头传 `video_generate_audio=true`。`无 BGM` 仅表示不创建背景音乐，不代表视频静音。用户逐镜头指定时长时传 `video_shot_durations_seconds`，并在每个视频 Plan 节点填写对应 `data.durationSec`；此时澄清卡不再问一个全局时长。`delivery_resolution` 是最终交付规格，只有用户明确要求视频生成节点的分辨率时才传 `video_resolution`。对白或需要可听声音的视频 Intent item 写 `requires_generated_audio=true`；完整 WorkflowPlan 的对应视频节点写 `data.workflowCatalog.requiresGeneratedAudio=true`。用户明确要求静音的镜头保留 `false`，逐镜头判断。卡片若提示当前模型无法满足这些要求，改为逐项选择兼容模型和参数，不自行沿用冲突的目录缺省值。

## 工具调用方式

`freezone_*` 工具不在工具列表里，统一用 `tool_call(name="<工具名>", arguments={...})` 调用；JSON 里先写 `name` 再写 `arguments`（arguments 很大时后写的 `name` 容易被漏掉，缺 `name` 会直接报错）；`arguments` 必须传 JSON 对象——不要传转义后的 JSON 字符串，大型嵌套 intent 会因转义损坏而反复失败。**不要先跑 `tool_search` 或 `tool_describe`**——`tool_call` 不依赖它们。**顺序固定：读规划包 → 生成结构化 intent → 编译草稿 → 用户确认 → 创建**。`deliverable`、Recipe、字段枚举都来自规划包，跳过它自造字段会被校验反复打回。所需参数如下：

- 读规划包：`tool_call(name="freezone_get_workflow_skill", arguments={"skill_id": ..., "inputs": {...}})`
- 生成准入：`tool_call(name="freezone_begin_agent_product_generation", arguments={"product_kind": "workflow_result", "generation_session_id": ..., "artifact_id": "<skill_id>@<skill_version>", "skill_id": ..., "skill_version": ..., "normalized_inputs": {...}})`；`artifact_id`、`skill_id` 必须与随后提交的 `compiled.skill_id` 一致。
- 规划草稿：`tool_call(name="freezone_prepare_workflow_draft", arguments={"canvas_id": ..., "operation_id": ..., "intent": {...}})`
- 自定义拓扑草稿：`tool_call(name="freezone_prepare_workflow_plan_draft", arguments={"canvas_id": ..., "operation_id": ..., "plan": {"schema_version":"freezone_workflow_plan.v1","skill":{"id":...,"version":...},"nodes":[...],"edges":[...]}, "generation_answers": {...}})`；`generation_answers` 只能补充完整 Plan，不能替代 `plan`、`schema_version` 或 `skill`；Recipe 支持的文本执行节点不得使用仅供无 Recipe 用户资源节点使用的 `input`/`resource`/`asset` stage；返回精确预览而不直接写画布
- 修改草稿：`freezone_patch_workflow_draft`，arguments `{"draft_id": ..., "expected_revision": ..., "changes": {...}}`
- 确认落图：`freezone_confirm_workflow_draft`，arguments `{"draft_id": ..., "revision": ...}`

用户指定已有画布图片作为 Recipe 参考图时，在 intent 或 Plan 顶层声明
`external_inputs: [{"id":"source_image","node_id":"真实画布节点 ID","media_kind":"image"}]`，
并在目标 item 的 `reference_inputs` 或 Plan 的 `media_input_for` 边中引用 `source_image`。
不要把已有图片写进 `nodes`、复制源节点或手填图片 URL；服务端在准备和确认时校验源图。

如果用户只是咨询或分析，只展示一般性说明，不创建草稿或写画布。用户提出具体创建需求后，先读取当前已选的唯一 Skill 紧凑规划包并生成结构化 `intent`，再调用 `freezone_prepare_workflow_draft`。只有用户明确要求 Skill 蓝图无法表达的自定义拓扑时，才使用 `freezone_prepare_workflow_plan_draft(plan=...)`，并继续走同一草稿确认入口。

“再创建一个 / 再来一个 / 再添加一个 / 重新建一个 / 复制一个同类型工作流”都属于创建请求。当前画布已经存在相同工作流时，不要改为查询列表、解释已有工作流、复用旧节点或等待用户重新选择，仍然创建一个新的工作流实例并走确认流程；不要复用旧 `draft_id`，也不要调用 `freezone_emit_canvas_command`。

## 可用工作流

当用户问“有哪些工作流 / 有哪些工作流技能 / 我的工作流技能有哪些 / 支持哪些流程 / 有哪些模板 / workflow skill”时，使用 Hermes 原生 `skills_list` 查看当前 Profile 中可用的 Workflow Skills，并提示用户在输入框键入 `/` 选择。不要编造固定数量。

不保留独立的 Workflow Skill 列表或语义评分路由。创建统一使用 `Hermes 原生 Skill → skill_id → freezone_get_workflow_skill → 动态 WorkflowPlan`。

动态工作流必须按以下顺序执行：

1. 使用 Hermes 本轮已经加载的原生 Workflow Skill；没有唯一 Skill 时先用 `skills_list` 展示候选，让用户通过输入框 `/` 选择。已选 Skill 不得再做语义路由或加载其它候选。
2. 调用一次 `freezone_get_workflow_skill` 读取该 Skill 的 Recipe 规划摘要、能力约束和 `input_contract`。
3. 使用 `input_contract.resolved` 展示用户值、工具从原话确定性提取的值和默认值；`fields[].source=inferred` 表示工具已从时长、画幅、执行模式等明确措辞中提取，不要再次分析或追问。只追问 `missing_required` 或修正 `errors`，已有素材和明确参数不要重复询问。`requires_confirmation=true` 时，在方案确认中一并确认这些值，不创建 Skill Session。
4. 生成精简 `freezone_workflow_intent.v1`：严格以 Intent Schema 为字段白名单，只写 `skill_id`、`user_goal`、当前 `inputs`、PlanItems 和必要选项。Recipe 查询中的 `requires_source_media` 等字段只用于选择 Recipe 和规划依赖，禁止复制到 `intent.items[]`；服务端会根据 `recipe_id` 推导权威约束。每个 item 使用语义化 `id`、`title`、`prompt`、一个来自 `available_recipes` 的 `recipe_id`，并用 `depends_on` 声明真实输入依赖；用户已提供实际朗读正文时写入 `narration`。短剧遵循 screenplay-first：旁白/对白将由上游剧本或镜头 Recipe 产生时，保留 `drama-shot-voice` item，并把对应文本 item 同时写入 `depends_on` 和 `reference_inputs`，由运行时 `prompt_for` 绑定正文；不要在草稿阶段虚构台词，也不能删除用户要求的配音节点来绕过校验。当图片或视频节点需要根据上游剧本、分镜或 Shot List 生成时，必须把对应文本 PlanItem 写入 `depends_on`；当它还需要角色、场景、道具等生成素材作为实际参考时，再把这些素材写入 `reference_inputs`。每个视频 item 的 `prompt` 必须说明所对应 Shot 或 Shot Group 的具体叙事、动作和目标，不能只写“开场日常”“镜头一”等泛化标题。不要把时间码、时长、语气、环境音、音效或配乐说明写入 `narration`。调用 `freezone_prepare_workflow_draft` 编译并保存，记录返回的 `draft_id` 和 `revision`。不要生成画布 nodes/edges、UUID、连线类型、布局或分组。
5. 缺少素材但允许从文字创建时，把素材锚点作为第一个 PlanItem，选择同一 Skill 允许的、`requires_source_media=false` 且输出类型匹配的 Recipe；后续依赖项通过 `depends_on` 引用该语义 item id。
6. 严格按草稿工具返回的 `preview` 展示节点数量、作品清单、阶段和执行方式，不展示内部 JSON、`draft_id` 或 `revision`。
7. 用户调整方案时，只把发生变化的字段传给 `freezone_patch_workflow_draft(draft_id=..., expected_revision=..., changes=...)`；不要重建 Intent 或创建新草稿。按新预览展示结果并记录新 revision。
8. 用户确认后调用一次 `freezone_confirm_workflow_draft(draft_id=..., revision=...)`。执行方式默认使用草稿中已经确认的 `run_after_create`。
9. 草稿校验失败时只修正返回的输入、item 或选项字段后重试；绝不原样重提。同一错误路径修正一次后仍失败，本轮停止重试并报告阻塞，避免累计“失败 ×N”。禁止改用单节点工具绕过校验，也不要退回生成整份 Plan。

Plan 中的边只表示真实输入依赖，不表示时间顺序。节点 ID 必须稳定且唯一；禁止环、坏边、未知节点类型、未知 Recipe 和不兼容 Recipe。用户要求自动执行时才设置 `run_after_create=true`，否则只创建画布。

### 缺少输入素材

缺少图片、视频或音频时，不要仅回复“请先上传”并停止规划。先检查所选 Recipe 的 `requires_source_media`：

- 为 `false`：直接按用户文字目标创建生成节点。
- 为 `true` 且画布已有合适素材：把素材节点通过 `media_input_for` 或 `derived_from` 连接到执行节点。
- 为 `true` 且画布没有合适素材：先增加一个资产锚点生成节点，选择同一 Skill 允许的、相同输出类型且 `requires_source_media=false` 的 Recipe；再把锚点节点通过 `media_input_for` 连接到所有依赖它的节点。

电商商品图场景中，用户没有产品图时，默认先生成一张清晰、中性背景、外观定义完整的“产品锚点图”，再生成主图、细节图和生活场景图。向用户确认时只说明“将先生成产品基准图以保持后续一致”，不要展示 Recipe、模型或内部字段。只有用户明确要求必须忠实还原真实商品时，才把上传真实产品图作为阻塞条件。

语音节点默认使用系统预设音色，不要求用户上传参考音频。只有用户明确提出“使用我的声音”“克隆声音”或指定项目/角色声线时，才把节点切换为克隆音色并检查对应参考声线；背景音乐始终走 music 模式，不依赖声线样本。

不要列 `freezone.sketch_from_context`、`freezone.frame_from_context`、`freezone.scene_360`、`agent.review_frame`。这些是画布原子执行技能，不是工作流技能。

## 路由

- 短剧、小说转视频、故事转视频、分集剧情：读取 `references/short-drama.md`。
- 广告视频、投放素材、Hook、A/B 版本：读取 `references/ad-video.md`。
- 产品视频、商品演示、功能讲解、使用场景：读取 `references/product-video.md`。
- MV、音乐视频、歌词视觉化、节奏镜头：读取 `references/mv.md`。
- 文生图：选择 `text-to-image` Skill 并生成动态 Plan。
- 图生视频：选择 `image-to-video` Skill 并生成动态 Plan。
- 文生视频：选择 `text-to-video` Skill 并生成动态 Plan。
- “文字生图再生视频 / 文生图再生视频 / 文本生成图片再生成视频 / 文本到图片到视频”都属于三节点 `text_to_video`，必须创建文本节点、图片节点、视频节点，并按 `文本 -> 图片 -> 视频` 连线；不要误判为只包含文本和图片的 `text_to_image`。
- 图生文：选择 `image-to-text` Skill 并生成动态 Plan。
- 文生音频：选择 `text-to-audio` Skill 并生成动态 Plan。

所有工作流计划都必须遵循 `references/spec.md`。

工作流规划只负责回答两件事：

- 这类需求通常需要哪些节点、分支和阶段；
- 这些节点之间哪些是真实输入依赖。

不要把“阶段顺序”直接翻译成画布连线。真正落图时，应让边只表示输入、参考或上下文关系。

## 边界

- 模型只负责查询、分类、Recipe/依赖决策和精简 Intent，不生成完整 WorkflowPlan。
- 不输出或手写 `canvas_chat_commands.v1`、画布 UUID、连线类型、分组和布局。
- 准备或修改草稿不会写画布；只有用户确认后才调用草稿确认工具创建节点。
- 普通节点删除、移动、连接或属性修改交给 Freezone 节点操作工具，不混入工作流规划。
- 用户未要求自动执行时，不自动运行图片、视频、音频生成。
- Skill 蓝图无法表达的高级自定义拓扑，才允许准备完整 Plan 草稿；不得直接写画布。

## 落画布交接

用户确认动态方案后，只调用 `freezone_confirm_workflow_draft(draft_id=..., revision=...)`，一次性创建草稿中已经预览过的节点、连线、布局和分组。普通 Intent 与高级完整 Plan 都必须先生成持久化草稿；不再保留任何直接创建兼容入口。
- 用户要求“继续/完成工作流”时直接调用 `freezone_run_workflow(regenerate=false)`，让 Runner 自动发现可执行节点并跳过已有结果；调用前不要读取画布摘要、节点详情、邻接图或逐节点动作目录，也不要逐节点执行。
- 只有一个可执行节点的工作流仍然是工作流。用户明确称目标为工作流并要求运行、执行、继续或恢复时，仍直接调用 `freezone_run_workflow`；禁止因为节点数为 1 而降级为 `freezone_run_node_action`。
- 用户修改某个节点后要求“从这里重跑/重做后续”时，调用 `freezone_run_workflow(node_ids=[...], direction="downstream", regenerate=true)`；Agent 不遍历或枚举下游节点。
- 仅重试一个失败节点时使用 `direction="node"`；没有明确要求覆盖已有结果时不得设置 `regenerate=true`。
- 禁止为动态工作流调用 `freezone_emit_canvas_command`。这个通用批量工具只用于非工作流的普通画布编辑。
- 如果用户的创建请求无法唯一匹配一个 Hermes 原生 Workflow Skill，先让用户通过输入框 `/` 选择，不要凭经验猜测。例如“创建一个视频工作流”可能是广告视频、产品视频、MV、文生视频、图生视频或短剧。
- 当用户一次要求多个交付分支时，把它们规划进同一份动态 `freezone_workflow_plan.v1`；需要完全独立的多个工作流时，逐份确认和创建，不得传 `workflow_types`。
- 创建成功后的节点清单必须直接使用工具结果中的 `created_nodes[].displayName`，保持原顺序并完整列出；不要凭计划重新组织名称。无法完整列出时只报告节点总数，不要输出残缺的表格行。
