workflows · diff
git:20261109.4347ce7 to git:20261109.f1e4379
2 added, 0 removed. Audit A to A.
What this update changes in the checks
No check changed: every fixed check gives the same answer before and after this update.
A tripped check is a label, not a verdict: read the matched text and the lines below. This week's updates that newly trip a check.
---
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`,也不得用通用画布命令手写工作流。
## 互动影游边界
涉及分支故事、选择、结局或互动广告剧情时,先读取 `interactive-story` Skill。故事结构使用其业务工具;普通工作流只负责素材生产,不替代故事创建或修改。用户在制作阶段要求创建角色或场景参考图时,先读 `interactive-story` 的 `references/reference-images.md`,按完整范例和最新故事资产映射准备纯图片 Plan,创建结果以画布上的图片节点和生成状态为准,不能用阶段确认工具代替。已确认制作方案中的新分镜图复用 `text-to-image-video` Workflow Skill 的 `general-image` Recipe,以一份仅含图片生成节点的 Plan 成组创建;现有视频节点保持在 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`,逐镜头判断。卡片若提示当前模型无法满足这些要求,改为逐项选择兼容模型和参数,不自行沿用冲突的目录缺省值。
+ 字段位置以公开 Schema 为准:Intent 的推荐模型写在 `inputs.image_model` / `inputs.video_model`,完整 Plan 写在 `nodes[].data.model`。不要把模型字段复制进 Intent 的 `items[]`;`recommended` 仅表示模型推荐,不是质量或分辨率值。工具说明与本 Skill 共享同一参数契约,已明确的用户要求始终保留。
+
## 工具调用方式
`freezone_*` 工具不在工具列表里,统一用 `tool_call(name="<工具名>", arguments={...})` 调用;JSON 里先写 `name` 再写 `arguments`(arguments 很大时后写的 `name` 容易被漏掉,缺 `name` 会直接报错);`arguments` 必须传 JSON 对象——不要传转义后的 JSON 字符串,大型嵌套 intent 会因转义损坏而反复失败。**不要先跑 `tool_search` 或 `tool_describe`**——`tool_call` 不依赖它们。**普通流程:读规划包 → 生成结构化 intent → 编译草稿 → 用户确认 → 创建**;已有故事图片批次按 `interactive-story` 参考图契约提交完整 Plan。`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": {...}, "run_after_create": true|false})`
- 自定义拓扑草稿:`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": {...}, "run_after_create": true|false})`;`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`。
已有视频(videoNode 或装视频的上传节点)声明为 `"media_kind":"video"`,只能参考到 videoNode。
不要把已有图片写进 `nodes`、复制源节点或手填图片 URL;服务端在准备和确认时校验源素材。
外部输入被拒时按报错修正;不得悄悄去掉用户指定的素材,确实用不上时必须在回复里告诉用户。
如果用户只是咨询或分析,只展示一般性说明,不创建草稿或写画布。用户提出具体创建需求后,先读取当前已选的唯一 Skill 紧凑规划包并生成结构化 `intent`,再调用 `freezone_prepare_workflow_draft`。只有用户明确要求 Skill 蓝图无法表达的自定义拓扑,或已有互动故事需要按已确认资产用途制作角色/场景图、按逐镜头映射制作分镜图时,才使用 `freezone_prepare_workflow_plan_draft(plan=...)`,并继续走同一草稿确认入口;后一种 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、连线类型、布局或分组。
纯图片请求选择 `text-to-image`,不得因为 `text-to-image-video` 含图片阶段就强制添加视频节点;只有用户明确要求视频时才选择后者。社交平台套图模板只用于用户明确提出平台配图需求。
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=...)`。绑定影游目标(`source_context.targets` 或 `source_context.asset_targets`)的草稿必须显式传 `run_after_create`,常规工作流可省略并默认 `false`(仅创建):用户要求创建并生成/运行时传 `true`;用户用“可以”“确认”等简短回复确认上一轮含生成的方案时,继承该方案并继续传 `true`;仅创建画布时传 `false`;影游绑定工作流不得依赖缺省值。确认时使用草稿中已经固定的执行策略。
9. 草稿校验失败时只修正返回的输入、item、Plan 映射或选项字段后重试;绝不原样重提。同一错误路径修正一次后仍失败,本轮停止重试并报告阻塞,避免累计“失败 ×N”。已有故事图片批次报 `skill_stage_missing`(缺少策划/视频阶段)时,先检查 `story_id`、全部图片在 `asset_targets` / `targets` 的唯一映射及多余执行节点,不补可执行策划或视频、不更改图片用途。仍失败时准确报告自己的图片计划尚未符合契约;不能宣称平台不支持纯图片或建议放宽校验、附加视频。禁止改用单节点工具绕过校验;普通 Intent 不退回整份 Plan,已选择的图片 Plan 路径不改为完整视频 Intent。
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`,保持原顺序并完整列出;不要凭计划重新组织名称。无法完整列出时只报告节点总数,不要输出残缺的表格行。