workflow-creation

工作流创建

目的

在 PostPlus 工作流平台上设计一个可靠的视频制作工作流，用于生成 UGC 风格的多片段视频。面向用户的交付内容是在用户账号中创建一个命名工作流，并保存一个定义版本，以便进行报价和启动。除非用户明确提出要求，否则不要生成独立的定义文件、导出的 JSON 图、审计材料包或后期制作说明。

质量检查在内部进行；不要询问用户是否要执行 QA。仅当缺少品牌、产品、参考内容、工作流目标、命名或声明边界等信息，且这些信息会影响工作流时，才向用户提问。

平台工具接口

工作流创作是一项由服务器验证的能力，有两个入口。使用当前会话提供的入口，不要混用，也不要绕过服务器验证：

• Workspace assistant 类型化工具：workflow_read（通过 action=list 按名称解析；通过 get 检查节点／插槽／版本；通过 runs_get 读取运行记录）、workflow_author（使用 create 创建空白工作流或以模板为基础创建工作流；使用 propose_edit 提交结构编辑——add_node / update_node / remove_node / connect_nodes——返回如实的验证结果，但不持久化）、apply_workflow_edit_to_canvas（当附加了用户的实时画布时执行相同操作）、save_workflow_version（持久化提案；始终需要人工批准），然后使用 quote_workflow_run 和 launch_workflow_run。
• CLI Agent postplus workflow 命令 - 相同的动词，结果以 JSON 格式返回，且需要已登录的会话（postplus auth login）：postplus workflow list / show 和 runs / run-show（读取）、create、propose（即 propose_edit：预览并验证，不持久化）、save（即 save_workflow_version：持久化一个新的不可变版本）、quote 和 launch。结构编辑通过 --operations JSON 数组传入，数组包含相同的 add_node / update_node / remove_node / connect_nodes 操作。运行 postplus workflow help 查看准确的标志。

两个入口一一对应到相同的托管动词，并执行相同的验证；propose 对应 propose_edit，save 对应 save_workflow_version，quote 对应 quote_workflow_run，launch 对应 launch_workflow_run。

边界：

• 解析 ID，不要猜测；名称匹配不明确时，将候选项交由用户选择。
• 不要手动编写完整的定义文档。通过创建和编辑操作构建结构，并由服务器验证；如果 validation.ok=false，修正列出的错误并重新提交提案。服务器绝不会默默修复。
• 只有获得人工批准后才持久化（save_workflow_version / postplus workflow save）；未经用户明确批准，绝不启动——先报价，报告预留的 PostPlus 积分；使用 CLI 时，将报价中的 reservedCredits 作为 --max-reserved-credits 参数传入，并同时使用 --confirm（缺少其中任何一项，启动都会被拒绝）。
• 如果当前会话中两个入口都不可用（没有 Workspace assistant 工具，也没有已登录的 CLI），不要伪造定义或任何替代文件格式。说明工作流创作需要 PostPlus workspace assistant 或已登录的 postplus CLI，并将一次性渲染请求转交给 video-batch-runner。

工作流形态默认值

• 工作流是一个节点画布：包含生成视频节点（每个节点生成一个片段，各自持有面向模型的提示词，以及节点配置中的时长／纵横比／分辨率／音频参数），以及一个可选的组装节点，该节点带有按顺序排列的片段输入槽位。
• 如果有组装节点，每个生成视频节点都必须连接到一个组装槽位；槽位顺序即剪辑顺序。如果没有组装节点，每个节点都会输出一个独立片段。
• 被动参考素材（创作者图片、产品图片、语音样本）作为带标签的工作流资产绑定，并通过 <<<label>>> 在提示词中引用；脚本文本可以作为资产节点输入。资产不会执行。
• 参数值取自节点选定的生成能力；画布验证和启动门禁具有权威性。典型的 UGC 默认值：9:16、720p、每个片段 4-15 秒、开启音频生成。
• 多版本输出 = 启动多个实例，而不是复制节点。除非用户指定名称，否则按 {case-or-brand}-{script-feature}-{duration}s-v{version} 格式命名工作流。

决策路由

应用第一个匹配的路由：

如果	那么
用户要求审查、审计、QA、验证、批准或检查工作流	执行 L2
涉及敏感声明、精确保留、事实冲突、渲染输出故障或批量工作	执行 L2
用户要求先审查逻辑／剪辑设计，或复杂叙事广告包含尚未确定的钩子、痛点段落、产品亮相、证明／价值段落、CTA 或后期制作边界	在构建前返回简短的剪辑方案供审批
用户提供或要求脚本、人物图、产品图、参考资产或逐片段参考	使用 Script-Locked Asset Mode
可见产品没有产品图片	默认询问；仅在明确获准时生成产品图像
缺失的事实会影响声明、参考素材、工作流行为或命名	提出最少且必要的问题
其他情况	正常模式：阅读 references/prompt-quality.md，编写片段提示词，使用 workflow_author 构建，并运行 L0/L1

三方评审框架

用三个视角评判每个工作流；以下规则仅用于这些评判。

• 广告主评审：产品外观、声明、用法、参考素材和合规边界，均符合广告主会信赖的任务专属事实。
• 观众评审：片段从可信的人物瞬间开始，能够吸引注意力，并自然地引出 CTA，而不是宣布功能。
• 生成器评审：下游模型能根据具体可见细节、明确的参考素材职责、独立的片段范围和正向场景构建，逐字执行提示词。

Sidecar 防护原则

防护规则用于诊断，提示词用于编译。业务体验防护规则是旁路审计检查，不属于面向模型的提示词内容。使用它们发现风险（节奏静态、音频空白、空间漂移、实体泄漏），然后将最小且不失真的修正转化为正向场景要素：动作、声源、移动路径、道具操作、镜头行为或台词。切勿将防护类别、审计理由或禁用词列表粘贴到生成提示词中。

工作流优先约定

1. 锁定所需的上下文：用户意图、产品事实、声明限制、参考资料、时长、必须保留的确切开场钩子/旁白，以及明确排除的内容。如果缺少叙事逻辑，先锁定精简的剪辑计划（开场钩子、痛点段落、产品登场、证明/价值段落、行动号召、后期制作边界）。
2. 编写提示词前先阅读 references/prompt-quality.md。将 do not/no/avoid/不要 转化为正向场景载体；为每个参考资料明确绑定用途、范围和边界。时长、宽高比、分辨率和音频生成应配置在节点中，绝不要在提示词文本中重复说明。
3. 通过 workflow_author（或 postplus workflow create / propose）构建：创建工作流（空白或基于模板），然后通过编辑操作提议节点/边/配置结构。
4. 使用返回的判定结果和内部质量门验证。直接修正不影响事实准确性的问题；只有缺少会改变声明或行为的事实时才阻止流程。
5. 仅在获得人工批准后保存并启动：使用 save_workflow_version（或 postplus workflow save），然后使用 quote_workflow_run（或 postplus workflow quote），报告预留的 PostPlus 额度，并在获得明确批准后使用 launch_workflow_run（或 postplus workflow launch ... --confirm）启动——将报价中的 reservedCredits 作为 --max-reserved-credits 传入，并将准确的工作流名称作为 --title。
6. 交接工作流名称和 ID、已保存版本、验证状态、报价/启动状态，以及重要阻碍或剩余风险。运行是异步的，并设有人审关卡——报告状态和工作流页面链接；不要轮询运行直至完成。

脚本锁定素材模式

当用户计划先写脚本、提到人物图 / product 图 / 参考图片、只提供产品图片而没有创作者图片，或希望按片段指定参考资料时触发。构建图之前先锁定脚本（开场钩子、台词、行动号召、总时长、产品动作、声明限制）；将 creator_identity、product_reference、voice_reference 和 style_reference 锁定为带标签的素材；规划片段时注明时长、节拍、产品是否出现，以及场景参考需求。优先采用图结构 creator identity image -> per-clip scene image -> per-clip generation video -> assembly。仅在触发此模式时阅读 references/asset-locked-workflow.md，并遵循其中的构建顺序。

提示词约定

仅编写面向模型的生成指令；内部约束、场景载体和最终模型提示词应分层处理。每个生成节点的提示词都需要包含：注明用途/范围/边界的参考资料绑定、真实的手持式 UGC 风格和场景、一种说话方式（on-camera spoken / voiceover / silent）、带时间戳的剪辑及具体动作和与剪辑匹配的台词、音频规则，以及针对不希望出现的 UI/文本/Logo 的正向替代方案等视觉约束。声明必须基于当前任务内的事实；片段参考资料必须彼此隔离；时长规则应基于口播密度（通常为每秒 2.4-2.8 个单词；仅在用户要求时才使用每秒 3.0-3.8 个单词的快速连珠式表达；涉及信任的内容使用每秒 2.2-2.6 个单词），高密度简报则要求每 1-2s 出现一个新节拍。每个镜头都必须能由一位合理的摄影师实际完成。完整规范、示例和摄影机语法见 references/prompt-quality.md。

如果用户希望使用外部音乐、稍后进行声音设计，或制作静音工作流，请关闭节点的音频生成，并从提示词中移除口头对白和语音参考资料。

内部质量关卡

L0 硬性检查（始终执行，依据提案结果和 workflow_read 获取的内容）：验证结论为通过；如果存在组装节点，则每个生成节点都连接到一个有序槽位；每个生成节点都有预期的提示词、时长 / 画面比例 / 分辨率 / 音频配置和参考绑定；名称中嵌入的时长与片段总时长一致；提示词不包含后期制作痕迹、负向构图措辞或缺乏依据的医疗 / 法律 / 保证类声明。将扫描命中视为信号；只修复影响可启动性、事实准确性或生成质量的问题。

L1 自检（交接前默认执行）：真实性——保留最新意图和约束，不虚构实体、功能、声明或 UI。可看性——开头的 0-5s 引发观众疑问；产品登场可信；效果呈现和 CTA 自然。可执行性——提示词面向模型；参考素材彼此隔离并明确用途；将否定项转化为正向载体；剪辑在物理上合理。进行保留真实性的小幅修正，并重新运行 L0。

L2 深度审查（自动触发；绝不询问）：敏感声明；精确保留要求；在提案 / 验证循环之外进行的编辑；L0 矛盾信号；事实或参考素材冲突；批量工作；涉及人物 / 产品 / 场景 / 故事连续性的 30s+ 多片段内容；多区域场景拓扑；报告的渲染输出问题；或明确的审查请求。通过 workflow_read 获取完整定义，然后阅读 references/ugc-workflow-audit-rubric.md；遇到节奏 / 音频 / 空间 / 痕迹触发条件时，再添加 references/ugc-sidecar-guardrails.md，将旁路检查结果视为诊断信息，除非它们暴露出事实、产品、合规或参考绑定问题。对于已组装的视频，审查跨片段的人物身份、道具、地点、对话流畅度和后期制作痕迹是否连贯。适合独立审查时，为每个工作流使用全新的审查上下文；审查者只负责审查，父级负责通过提案 / 应用操作进行编辑。通过、遇到阻塞项或完成 3 轮审查修订后停止；只有缺失事实会改变声明时，才阻塞并提出最少的问题。

成本与启动规范

启动会消耗实际点数：务必先报价，报告预留的 PostPlus 点数，未经用户明确批准绝不启动。在 CLI 中，若未提供 --confirm 且未确认 --max-reserved-credits 上限，postplus workflow launch 会拒绝运行；服务器会重新报价，如果最新预留点数超出上限则中止，因此已确认的成本上限始终有效。运行会在人工审核关卡（逐片段审批、最终审核）暂停——报告运行状态和工作流页面链接，不要陷入轮询循环。

交接

报告工作流名称和 ID、已保存的版本号、验证状态、报价或启动状态及预留点数，以及受阻事实或重要的剩余风险。除非用户询问，否则不要披露内部 QA 步骤、审查轮次或审计理由。