Communitygithub.com

simpletibr/simplicio-loop-marketing

组装视频生成提示词,通过 PROVIDERS.md 选择提供商,并委派给对应的提供商专用构建器。

simplicio-loop-marketing 是什么?

该技能是一个通用、与提供商无关的视频生成提示词调度器。它读取 `.specs/architecture/PROVIDERS.md` 中的路由矩阵,根据任务类型(如 `cinematic_reel`、`ugc_product_holder`、`programmatic_short` 等)决定由哪个视频提供商执行,然后委派给专门的提供商构建器(如 `higgsfield-prompt-builder`、`topview-prompt-builder`、`wavespeed-batch`、`hyperframes-prompt-builder`)。该技能支持的文件路径可以包含 `provider_override.video` 覆盖项,以便在 A/B 测试后重新路由到不同的提供商。它还会验证所选提供商的环境变量是否已设置,并记录每次运行到 `data/video-usage.jsonl` 文件中。这对于需要通过单一入口点协调多个视频生成提供商的 AI 代理工作流非常有用,可简化 A/B 测试、提供商切换和运行日志记录。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/simpletibr/simplicio-loop-marketing/tree/HEAD/.skills/video-prompt-builder

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

视频提示词构建器

通用、与提供商无关的视频生成提示词调度器。读取 .specs/architecture/PROVIDERS.md 中的路由矩阵,决定由哪个提供商执行,并委派给专门的构建器(higgsfield-prompt-builder、topview-prompt-builder、wavespeed-batch、hyperframes-prompt-builder)。

何时调用

  • 流水线中的任何视频生成步骤(brief -> script -> creative,当创意类型为视频时)。
  • 当某个片段在 .specs/pieces/*.md 中声明 type: video 时。
  • 跨提供商进行视频钩子 A/B 测试,并且编排器需要一个单一入口点。
  • 在 A/B 测试选出获胜者后,使用相同的 brief 在不同的提供商上重新运行。
  • 当上游代理拥有 brief 但不知道选择哪个提供商时。

输入

  • brief:对象。视觉 brief,至少包含 subject、motion、mood、aspect、duration_seconds。
  • task_kind:字符串。可选值:cinematic_reel、motion_control、ugc_product_holder、product_demo、talking_head、batch_hook_test、motion_typography、data_viz_reel、programmatic_short。
  • piece_path:字符串,可选。片段文件的路径。可能包含 provider_override.video。
  • dry_run:布尔值,可选。为 true 时,返回已解析的提供商和参数,而不调用 MCP。

处理流程

  1. 读取 .specs/architecture/PROVIDERS.md 并将视频矩阵解析为 task_kind -> provider 映射。
  2. 如果设置了 piece_path 且包含 provider_override.video,则使用覆盖值。
  3. 否则在矩阵中查找 task_kind。如果未知,则回退到矩阵中 cinematic_reel 的默认值。
  4. 验证所选提供商是否已设置环境变量(HIGGSFIELD_MCP_ACTIVE、TOPVIEW_API_KEY、WAVESPEED_API_KEY、HYPERFRAMES_ACTIVE)。
  5. 将提供商映射到专业技能:Higgsfield -> higgsfield-prompt-builder,Topview -> topview-prompt-builder,Wavespeed -> wavespeed-batch,Hyperframes -> hyperframes-prompt-builder。
  6. 将 brief 字段转换为专业技能期望的输入形状。
  7. 调用专业技能并捕获其 params 和 mcp_tool 输出。
  8. 如果是 dry_run,则返回已解析的提供商、参数和 MCP 工具。否则调用 MCP 并返回工件引用。
  9. 将运行记录到 data/video-usage.jsonl 中,包含时间戳、提供商、task_kind 和结果。

输出

  • provider_used:字符串。
  • params:对象。准备好用于 MCP 调用的最终参数对象。
  • mcp_tool:字符串。MCP 工具名称。
  • artifact_ref:字符串,非干运行模式时返回。生成的视频路径或 URL。
  • cost_estimate_usd:数字。

示例

示例 1:路由到 Higgsfield 的电影短片

输入:{ brief: { subject: "model in linen suit", motion: "tracking shot", mood: "editorial", aspect: "9:16", duration_seconds: 6 }, task_kind: "cinematic_reel" } 输出:{ provider_used: "higgsfield", mcp_tool: "higgsfield_seedance_generate", params: {...} }

示例 2:路由到 Topview 的 UGC 广告

输入:{ brief: { subject: "skincare bottle held by avatar", motion: "static", mood: "friendly", aspect: "9:16", duration_seconds: 15 }, task_kind: "ugc_product_holder" } 输出:{ provider_used: "topview", mcp_tool: "topview_avatar_generate", params: {...} }

示例 3:路由到 Hyperframes 的周 KPI 短片

输入:{ brief: { headline: "Semana 21 em números", aspect: "9:16", duration_seconds: 12, variables: { leads: 42, delta_pct: 12 } }, task_kind: "programmatic_short" } 输出:{ provider_used: "hyperframes", mcp_tool: "hyperframes_render", params: { composition_spec: {...}, render_args: {...} } } — 通过 hyperframes + hyperframes-cli 技能进行本地渲染。

故障模式

  • task_kind 不在矩阵中:记录警告并使用 cinematic_reel 默认值。
  • 所选提供商缺少必需的环境变量:降级到矩阵中的下一个提供商并显示警告。
  • 专业技能返回错误:显示错误,除非调用方选择,否则不在不同提供商上自动重试。
  • 时长超过提供商限制:裁剪到提供商最大值并显示通知。

相关技能

  • higgsfield-prompt-builder:Soul、DoP、Seedance 的专业构建器。
  • topview-prompt-builder:UGC 和虚拟人驱动广告的专业构建器。
  • wavespeed-batch:廉价批量钩子测试的专业构建器。
  • hyperframes-prompt-builder:HTML 渲染的动态排版、数据可视化短片和参数化程序化短片的专业构建器。
  • llm-router:文本生成的不同调度器;相同的模式,不同的领域。
  • qa-tech-specs:根据平台规范验证最终视频。

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

相关技能