{/* 此页面由 website/scripts/generate-skill-docs.py 从技能的 SKILL.md 自动生成。请编辑源文件 SKILL.md,而非此页面。 */}

Kanban 视频编排器

规划、设置和监控由 Hermes Kanban 支持的多代理视频制作流水线。当用户想要制作任何视频 —— 叙事电影、产品/营销、音乐视频、讲解视频、ASCII/终端艺术、抽象/生成循环、漫画、3D、实时/装置 —— 并且工作值得分解为通过看板协调的专门配置文件(编剧、设计师、动画师、渲染师、配音、剪辑师等)时使用。执行自适应探索以确定范围,为请求的风格设计合适的团队,生成创建 Hermes 配置文件 + 初始看板任务的设置脚本,然后在任务停滞或失败时帮助监控并介入。根据每个节拍将场景路由到相应的 Hermes 渲染/音频/设计技能(ascii-video, manim-video, p5js, comfyui, touchdesigner-mcp, blender-mcp, pixel-art, baoyu-comic, claude-design, excalidraw, songsee, heartmula, …)以及外部 TTS、图像生成和图像转视频 API。

技能元数据

来源可选 —— 使用 hermes skills install official/creative/kanban-video-orchestrator 安装
路径optional-skills/creative/kanban-video-orchestrator
版本1.0.0
作者[‘SHL0MS’, ‘alt-glitch’]
许可证MIT
平台linux, macos, windows
标签video, kanban, multi-agent, orchestration, production-pipeline
相关技能kanban-orchestrator, kanban-worker, ascii-video, manim-video, p5js, comfyui, touchdesigner-mcp, blender-mcp, pixel-art, ascii-art, songwriting-and-ai-music, heartmula, songsee, spotify, youtube-content, claude-design, excalidraw, architecture-diagram, concept-diagrams, baoyu-comic, baoyu-infographic, humanizer, gif-search, meme-generation

参考:完整 SKILL.md

:::info 以下是 Hermes 在触发此技能时加载的完整技能定义。这是技能激活时代理所看到的指令。 :::

Kanban 视频编排器

将任何视频请求 —— 从 15 秒的产品预告片到 5 分钟的叙事短片、音乐视频、ASCII 循环 —— 封装在 Hermes Kanban 流水线中,将工作分解到专门的代理配置文件。

此技能本身不渲染任何内容。它是一个元流水线(meta-pipeline),负责:

  1. 界定范围(Scope) —— 通过有针对性的探索了解需求
  2. 设计团队(Design) —— 根据风格设计适当的团队(哪些角色,每个角色使用哪些工具)
  3. 生成(Generate) 设置脚本,创建 Hermes 配置文件、项目工作空间和初始看板任务
  4. 交给(Hand off) 导演配置文件,其通过看板进行分解
  5. 监控(Monitor) 执行,在任务停滞或失败时帮助介入

实际的渲染在看板运行后通过适配合适的现有技能 + 工具完成 —— ascii-video, manim-video, p5js, comfyui, touchdesigner-mcp, blender-mcp, songwriting-and-ai-music, heartmula, 外部 API 或纯 Python 配合 PIL + ffmpeg。

何时不使用此技能

  • 视频是一个连续的编程项目,不需要专门人员。直接编写代码即可。
  • 用户想要快速的一次性转换(例如”将此 mp4 转换为 GIF”)—— 直接使用 ffmpeg。
  • 输出是静态图像、GIF 或仅音频文件 —— 使用匹配的特定技能(ascii-art, gifs, meme-generation, songwriting-and-ai-music)。
  • 工作可以由单个现有技能干净地完成(例如纯 ASCII 视频 —— 直接使用 ascii-video)。

工作流程

探索 → 简报 → 团队设计 → 设置 → 执行 → 监控

步骤 1 — 探索(提出正确问题)

探索过程是自适应的:只询问实际需要的内容。始终从三个问题开始以确定大致形态:

  • 这是什么视频?(一句话简报)
  • 多长?(5-30s 预告片 / 30-90s 短片 / 90s-3min 讲解 / 3-10min 电影 / 更长)
  • 什么宽高比 + 目标平台?(1:1 / 9:16 / 16:9;X, IG, YouTube, 内部等)

从答案中,分类风格类别。风格确定要问哪些后续问题。不要一次性问所有问题。 每次问 2-4 个,倾听,然后继续。当用户暗示答案时,做出合理的假设。

完整的输入模式和各风格问题库参见 references/intake.md

步骤 2 — 简报

当信息足够后,使用 assets/brief.md.tmpl 中的模板生成结构化的 brief.md。阶段:

  1. 概念 —— 一句话宣传语 + 情感核心
  2. 范围 —— 时长、宽高比、平台、截止日期
  3. 风格 —— 视觉参考、品牌约束、基调
  4. 场景 —— 逐拍分解(时长、内容、目标工具)
  5. 音频 —— 旁白 / 音乐 / 音效 / 静音(如需按场景设置)
  6. 交付物 —— 文件格式、分辨率、可选备选方案(竖版剪辑、GIF 等)

在设计团队前将简报展示给用户确认。简报是合同 —— 每个下游任务都引用它。

步骤 3 — 团队设计

从库中选择适合此视频的角色原型。组合而非克隆。 大多数视频需要 4-7 个配置文件。导演始终存在;其余根据简报实际需要选择。

角色库和各风格团队组成参见 references/role-archetypes.md

角色 → 加载的 Hermes 技能和工具集映射参见 references/tool-matrix.md

步骤 4 — 设置

生成设置脚本(setup.sh)并运行。脚本:

  1. 创建项目工作空间(~/projects/video-pipeline/<slug>/
  2. 将任何提供的资产复制到 taste/, audio/, assets/
  3. 通过 hermes profile create --clone 创建每个 Hermes 配置文件
  4. 写入每个配置文件的 SOUL.md(个性 + 角色定义)
  5. 配置配置文件 YAML(工具集, always_load 技能, cwd)
  6. 写入 brief.md, TEAM.mdtaste/ 内容
  7. 触发初始 hermes kanban create 任务,分配给导演

使用 scripts/bootstrap_pipeline.py 从简报 + 团队设计 JSON 生成 setup.sh。参见 references/kanban-setup.md 了解设置脚本结构、配置文件配置模式以及关键的”共享工作空间”规则。

步骤 5 — 执行

运行 setup.sh。然后向用户提供监控命令:

hermes kanban watch --tenant <项目租>     # 实时事件
hermes kanban list  --tenant <项目租>     # 看板快照
hermes dashboard                             # 可视化看板 UI

导演配置文件从此接手,通过看板工具集将工作分解并路由给专门配置文件。

步骤 6 — 监控和介入

保持参与 —— 看板自主运行,但卡住的任务或错误的输出需要人类(或 AI)判断。

监控模式:定期轮询 kanban list,检查任何超过预期时长的 RUNNING 任务(kanban show <id>),并检查心跳。当工作者的输出未通过评审时,标准介入措施包括:

  1. 在工作者的任务上评论具体反馈(kanban_comment
  2. 创建以原任务为父级的重新运行任务
  3. 调整简报范围,让导演重新分解

诊断模式、介入方案和”任务卡住”的应对手册,参见 references/monitoring.md

参考:工作示例

六个涵盖不同视频风格的具体流水线 —— 叙事电影、产品/营销、音乐视频、数学/算法讲解、ASCII 视频、实时安装 —— 展示相同工作流程如何产生非常不同的团队和任务图。参见 references/examples.md

关键规则

  1. 先探索再行动。 在提出至少三个基础问题前,切勿开始生成简报或团队。糟糕的简报会在整个流水线中产生级联影响。

  2. 根据视频匹配团队。 不要为每个任务重用相同的 4 配置文件设置。没有节拍分析配置文件的音乐视频会失败。没有编剧配置文件的叙事电影会产生不连贯的场景。参见 references/role-archetypes.md

  3. 每个项目一个工作空间。 给定视频的所有配置文件共享同一个 dir: 工作空间。任务通过共享文件系统和结构化交接传递产物。每次 kanban_create 调用都传递 workspace_kind="dir" + workspace_path="<绝对项目路径>"

  4. 每个项目一个租户。 使用项目特定的租户(--tenant <项目slug>)。保持仪表盘范围隔离,防止与其他正在进行的看板交叉污染。

  5. 尊重现有技能。 当场景适合现有技能时,相关渲染器应通过任务上的 --skill <名称> 或配置文件中的 always_load 加载该技能。不要重新发明轮子。

  6. 导演从不执行。 即使拥有完整的 kanban + terminal + file 工具集,导演的 SOUL.md 规则禁止其亲自执行工作。它只负责分解和路由 —— 每个具体任务都变成对专门配置文件的 hermes kanban create 调用。kanban-orchestrator 技能对此有进一步说明。

  7. 不要过度分解。 30 秒的产品视频不需要 20 个任务。以最小的任务图为目标,同时仍能良好并行化并暴露适当的人工评审关卡。

  8. 先验证 API 密钥再触发。 外部 API(TTS, 图像生成, 图像转视频)需要 ~/.hermes/.env 或用户的密钥存储中的密钥。遇到缺失密钥错误的工作者会浪费一个任务槽位。设置脚本的 check_key 辅助函数在缺少必需密钥时会干净地中止。

文件映射

SKILL.md                            ← 本文件(工作流程 + 规则)
references/
  intake.md                         ← 各风格探索问题库
  role-archetypes.md                ← 角色库(编剧、设计师、动画师……)
  tool-matrix.md                    ← 每个角色的技能 + 工具集映射
  kanban-setup.md                   ← 设置脚本结构和配置文件配置
  monitoring.md                     ← 观察 + 介入模式
  examples.md                       ← 六个工作流水线
assets/
  brief.md.tmpl                     ← 简报模板
  setup.sh.tmpl                     ← 设置脚本模板
  soul.md.tmpl                      ← 配置文件个性模板
scripts/
  bootstrap_pipeline.py             ← 从简报 + 团队 JSON 生成 setup.sh
  monitor.py                        ← 轮询 + 介入辅助函数