@baimingtao/lbs-agent 1.0.0

package/extensions/skills/optional/creative/hyperframes/references/troubleshooting.md

@@ -0,0 +1,137 @@
+# 故障排查
+
+## `HeadlessExperimental.beginFrame' wasn't found`（首先要检查的事项）
+
+**症状：** `npx hyperframes render` 失败并提示：
+
+```
+✗ Render failed
+Protocol error (HeadlessExperimental.beginFrame):
+'HeadlessExperimental.beginFrame' wasn't found
+```
+
+**原因：** Chromium 147+ 移除了 `HeadlessExperimental.beginFrame` CDP 命令。这影响了将现代版 Chromium 作为系统浏览器提供的沙盒环境（例如 OpenClaw、某些容器化的 agent 宿主机）。详见 [hyperframes#294](https://github.com/heygen-com/hyperframes/issues/294)。
+
+**修复（永久修复 —— 推荐）：** 升级。
+
+```bash
+npx hyperframes upgrade -y
+# or
+npm install -g hyperframes@latest
+```
+
+`hyperframes >= 0.4.2` 会自动检测解析出的浏览器是否支持 `beginFrame`（通过检查二进制文件路径中是否包含 `chrome-headless-shell`），并在不支持时回退到截图捕获模式。提交 [`4c72ba4`](https://github.com/heygen-com/hyperframes/commit/4c72ba4a36ec2bd6733f7b9cb2a9e63f9fb234b9)（2026 年 3 月）发布了此自动检测功能。
+
+**修复（应急方案 —— 如果你无法升级）：**
+
+```bash
+export PRODUCER_FORCE_SCREENSHOT=true
+npx hyperframes render
+```
+
+无论使用什么二进制文件，这都会强制使用截图模式。截图模式速度稍慢，但视觉效果完全相同。
+
+**修复（预防措施 —— 推荐）：** 安装 `chrome-headless-shell` 以便引擎可以使用快速的 BeginFrame 路径：
+
+```bash
+npx puppeteer browsers install chrome-headless-shell
+# or let the CLI do it
+npx hyperframes browser --install
+```
+
+`scripts/setup.sh` 会自动执行此操作。
+
+## `npx hyperframes render` 挂起 120 秒后超时
+
+**原因：** 解析出的浏览器是系统 Chrome（例如 `/usr/bin/google-chrome`）并且不支持 BeginFrame 路径，但自动检测也漏掉了它（较旧的 `hyperframes` 版本）。
+
+**修复：**
+1. 检查正在使用哪个二进制文件：`npx hyperframes browser --path`
+2. 如果是系统 Chrome，请执行以下任一操作：
+   - 安装 `chrome-headless-shell`：`npx hyperframes browser --install`，或者
+   - 设置应急方案：`export PRODUCER_FORCE_SCREENSHOT=true`，或者
+   - 升级：`npx hyperframes upgrade -y`
+
+## `ffmpeg: command not found`
+
+通过你的系统包管理器安装 FFmpeg：
+
+| 操作系统 / 发行版 | 命令 |
+| --------------- | ----------------------------------- |
+| Ubuntu / Debian | `sudo apt-get install -y ffmpeg` |
+| Fedora / RHEL | `sudo dnf install -y ffmpeg` |
+| Arch | `sudo pacman -S ffmpeg` |
+| macOS | `brew install ffmpeg` |
+| Windows | `winget install Gyan.FFmpeg` |
+
+验证：`ffmpeg -version`。
+
+## `Node version X is not supported`
+
+HyperFrames 需要 Node.js >= 22。使用 `node --version` 检查版本。
+
+- **nvm：** `nvm install 22 && nvm use 22`
+- **Homebrew (macOS)：** `brew install node@22 && brew link --overwrite node@22`
+- **apt：** 按照 [nodesource](https://github.com/nodesource/distributions) 的指南安装 Node 22 LTS。
+
+## `ENOSPC: no space left on device` 或渲染期间发生 OOM kills
+
+渲染非常消耗内存和磁盘。最低要求：
+
+- **RAM：** 剩余 4 GB（对于 60fps / `--quality high`，建议为 8 GB）
+- **磁盘：** 剩余 2 GB 暂存空间 —— 帧在捕获期间会写入 `/tmp`
+
+缓解措施：
+- 降低质量：`--quality draft`。
+- 降低 fps：`--fps 24`。
+- 降低 worker 数量：`--workers 1`。
+- 将 `TMPDIR` 设置为具有更大空间的卷：`export TMPDIR=/mnt/scratch`。
+
+## Lint 通过但渲染结果是空白 / 黑帧
+
+在 `preview` 中检查浏览器控制台 —— 通常是因为：
+- 注册 timeline 时使用了错误的 key（例如写成了 `__timelines["typo"]` 而不是 `__timelines["root"]`）。
+- 根 composition 被包裹在 `<template>` 中（只有子 composition 才使用 `<template>`）。
+- script 标签加载失败 —— 在 preview 中检查 Network 选项卡。
+
+运行 `npx hyperframes lint --verbose` 以查看 info 级别的诊断信息。
+
+## 来自 `hyperframes validate` 的对比度警告
+
+```
+⚠ WCAG AA contrast warnings (3):
+  · .subtitle "secondary text" — 2.67:1 (need 4.5:1, t=5.3s)
+```
+
+- **深色背景：** 提亮未通过检测的颜色，直到达到 4.5:1（正常文本）或 3:1（大文本 —— 24px+ 或 19px+ 加粗）。
+- **浅色背景：** 将其调暗。
+- 保持在调色板色系内 —— 不要发明新颜色，而是调整现有的颜色。
+- 如果需要快速迭代，可以使用 `--no-contrast` 暂时跳过检查，但在交付前必须将其清除。
+
+## `Font family 'X' not supported by compiler`
+
+编译器内置了一套精选的 Web 安全字体和开源字体。如果某个字体不受支持，请：
+- 根据警告信息切换为受支持的替代字体。
+- 通过 `@font-face` 注册指向项目目录中 `.woff2` 文件的自定义字体（编译器会内联引用的 `@font-face` 文件）。
+
+## 视频播放时静音或没有声音
+
+请检查：
+- `<video>` 元素包含 `muted playsinline`（必需 —— 符合浏览器自动播放策略）。
+- 音频是一个**独立的** `<audio>` 元素，而不是视频元素本身。
+- 音频的 `data-volume` 已设置（默认为 1）。
+- 音频文件位于预期路径 —— composition 的加载是相对于它们自己的目录进行的。
+
+## 在 Linux 上使用 rootless Docker 时渲染失败
+
+添加 `--privileged` 或传递 `--cap-add=SYS_ADMIN`：
+
+```bash
+npx hyperframes render --docker --docker-args "--cap-add=SYS_ADMIN"
+```
+
+无头浏览器需要命名空间（namespace）权限才能实现沙盒隔离。
+
+## Bug 报告
+
+请附上 `npx hyperframes info` 的输出以及完整的错误日志。在 [github.com/heygen-com/hyperframes](https://github.com/heygen-com/hyperframes/issues) 提交问题。

package/extensions/skills/optional/creative/hyperframes/references/website-to-video.md

@@ -0,0 +1,145 @@
+# Website to Video
+
+捕获网站，并据此制作专业视频。当用户提供 URL 并希望生成视频（如社交广告、产品演示、30秒宣传片等）时使用此工作流。
+
+该工作流共有 7 个步骤。每一步都会生成一个 artifact，作为下一步的前置条件。**切勿跳过任何步骤**——每个 artifact 都能防止后续环节出现特定的失败模式。
+
+## Step 1: Capture & Understand
+
+```bash
+npx hyperframes capture https://example.com -o example-video
+```
+
+生成 `example-video/capture/` 目录，其中包含：
+- `capture/screenshots/` — 首屏（above-the-fold）及各个区块的截图（上限为 `--max-screenshots`）
+- `capture/assets/` — logo、主视觉图（hero image）、背景视频（如果有）
+- `capture/extracted/tokens.json` — 颜色、字体和间距 token
+- `capture/extracted/visible-text.txt` — 提取的标题、段落、CTA
+- `capture/extracted/fonts.json` — 在计算样式中检测到的字体族和字体栈
+- `capture/asset-descriptions.md` — 自动生成的 asset 目录
+
+后续所有步骤都将从 `capture/` 子目录中读取内容——例如 `capture/extracted/tokens.json`、`capture/assets/hero.png` 等。在引用这些文件时，绝对不要去掉 `capture/` 前缀。
+
+**Gate（关卡校验）：** 打印一份网站摘要——包括名称、排名前 3 的颜色、主要及展示型字体、主视觉 asset 路径，以及一句话的整体氛围。将其保留在您的上下文中——无需重复捕获。
+
+## Step 2: 编写 DESIGN.md
+
+在项目根目录创建一个小型品牌参考文档。包含 6 个部分，约 90 行。这是一份备忘录——而非创意策划案。
+
+```markdown
+# DESIGN
+
+## Brand
+- Name: Example Co.
+- One-line mission: "…"
+
+## Colors
+- Background: #0B0F14
+- Primary: #00E0A4 (accent, CTA)
+- Secondary: #7A8B9B (body text)
+- Text: #FFFFFF
+
+## Typography
+- Display: "Inter Tight", 700, tight letter-spacing
+- Body: "Inter", 400
+
+## Motion
+- Mood: precise, technical, confident
+- Eases: `power3.out` for entrances, `expo.in` for exits
+
+## Assets
+- Logo: `capture/assets/logo.svg`
+- Hero image: `capture/assets/hero.png`
+
+## What NOT to Do
+- No purple, no pastels, no serif body
+- No playful/bubbly eases (`elastic`, `bounce`)
+- No drop shadows on text
+```
+
+**Gate（关卡校验）：** `DESIGN.md` 已存在于项目目录中。
+
+## Step 3: 编写 SCRIPT.md
+
+旁白脚本。故事的骨架。**场景时长依据旁白决定，而不是凭空猜测。**
+
+```markdown
+# SCRIPT
+
+## Scene 1 — Hook (0:00–0:04)
+"What if your dashboards wrote themselves?"
+
+## Scene 2 — Problem (0:04–0:11)
+"Teams spend hours stitching together queries, charts, and callouts — every Monday."
+
+## Scene 3 — Solution (0:11–0:22)
+"Example Co. watches your data streams and proposes the dashboard you'd have built — in seconds."
+
+## Scene 4 — CTA (0:22–0:28)
+"Try it free at example.com."
+```
+
+运行 `npx hyperframes tts SCRIPT.md --voice af_nova --output narration.wav` 来生成 TTS 音频。记下精确的时长——这决定了整个视频的时长。
+
+**Gate（关卡校验）：** `SCRIPT.md` 和 `narration.wav` 存在，且时长与计划相符（±0.3秒）。
+
+## Step 4: 分镜 (Storyboard)
+
+纯文本场景规划：针对每个场景，描述其 hero frame——即在该场景最醒目的时刻屏幕上显示的内容。
+
+```markdown
+# STORYBOARD
+
+## Scene 1 (0:00–0:04) — Hook
+Hero frame: giant "WHAT IF YOUR DASHBOARDS WROTE THEMSELVES?" in display font, centered, on near-black. Logo top-left at 40% opacity.
+Entrance: each word staggers in, 0.08s apart.
+Transition out: flash-through-white into Scene 2.
+```
+
+每个场景一段话。切勿跳过此步骤——这是在编写 HTML 之前排查叙事断层的好机会。
+
+**Gate（关卡校验）：** `STORYBOARD.md` 存在。每个场景都包含：hero frame、entrance（入场）、transition（转场）。
+
+## Step 5: 合成 (Composition)
+
+逐场景编写 `index.html`：
+- 每个场景都是一个采用绝对定位、全屏铺满（full-bleed）的 `<div class="scene scene-N">`。
+- 先用纯静态 HTML+CSS 构建 hero frame（先不要加入 GSAP）。
+- 将旁白 `<audio>` 置于高轨道索引处，并设置 `data-start="0"`。
+- 在每个场景之间添加 transition 组件（如 `flash-through-white`、`liquid-wipe` 等）。
+- 然后再添加 GSAP 的入场动画（`gsap.from()`），不需要出场动画——出场效果交由 transition 负责。
+- 注册 `window.__timelines["root"] = tl`。
+
+根据需要安装 transition：
+
+```bash
+npx hyperframes add flash-through-white
+```
+
+## Step 6: 渲染 (Render)
+
+```bash
+npx hyperframes lint --strict          # must pass
+npx hyperframes validate               # WCAG contrast audit
+npx hyperframes render --quality draft --output draft.mp4
+```
+
+观看草稿。将发现的问题记录在 `REVIEW.md` 的项目符号列表中（场景、时间戳、问题）。修复后重新渲染。
+
+满意后：
+
+```bash
+npx hyperframes render --quality high --output final.mp4
+```
+
+## Step 7: 交付 (Deliver)
+
+- 向用户报告文件路径、时长及文件大小。
+- 如果用户需要竖屏版本，请使用 9:16 的 composition（`data-width="1080" data-height="1920"`）重新渲染——这通常需要一个独立的 `index-vertical.html`，以调整字体排布使之更紧凑，并重新调整场景布局。
+
+## 常见失败模式
+
+- **跳过 DESIGN.md** → 颜色在不同场景间发生偏移；成片看起来就像粗制滥造的“AI 幻灯片”。
+- **跳过 STORYBOARD.md** → 场景重叠，或者 hero frame 与转场效果发生视觉冲突。
+- **在转场前加入出场动画** → 转场触发时会出现空白帧。
+- **旁白时长超过 `data-duration`** → 音频会在句子中途被截断。请更新 composition 的 `data-duration`，使其匹配 TTS 输出长度 + 0.5秒的缓冲时间。

package/extensions/skills/optional/creative/hyperframes/scripts/setup.sh

@@ -0,0 +1,135 @@
+#!/usr/bin/env bash
+# HyperFrames setup for Hermes.
+#
+# Verifies Node >= 22 and FFmpeg, installs the `hyperframes` CLI globally,
+# pre-caches `chrome-headless-shell`, and runs `hyperframes doctor`.
+#
+# Pins `hyperframes@>=0.4.2` so the OpenClaw/Chromium-147 fix from
+# https://github.com/heygen-com/hyperframes/issues/294 (commit 4c72ba4)
+# is always present — the engine auto-detects `HeadlessExperimental.beginFrame`
+# support and falls back to screenshot capture otherwise.
+#
+# Idempotent: safe to re-run.
+
+set -euo pipefail
+
+MIN_NODE_MAJOR=22
+MIN_HYPERFRAMES_VERSION="0.4.2"
+
+red()    { printf '\033[31m%s\033[0m\n' "$*"; }
+green()  { printf '\033[32m%s\033[0m\n' "$*"; }
+yellow() { printf '\033[33m%s\033[0m\n' "$*"; }
+bold()   { printf '\033[1m%s\033[0m\n' "$*"; }
+
+bold "==> HyperFrames setup"
+
+# --- 1. Node.js --------------------------------------------------------------
+
+if ! command -v node >/dev/null 2>&1; then
+  red "✗ Node.js is not installed."
+  echo "   Install Node.js >= ${MIN_NODE_MAJOR} (nvm, Homebrew, or your package manager) and re-run."
+  exit 1
+fi
+
+node_version="$(node --version | sed 's/^v//')"
+node_major="$(echo "$node_version" | cut -d. -f1)"
+if [ "$node_major" -lt "$MIN_NODE_MAJOR" ]; then
+  red "✗ Node.js ${node_version} is too old. HyperFrames requires Node.js >= ${MIN_NODE_MAJOR}."
+  echo "   Upgrade with 'nvm install ${MIN_NODE_MAJOR} && nvm use ${MIN_NODE_MAJOR}' or your package manager."
+  exit 1
+fi
+green "✓ Node.js ${node_version}"
+
+# --- 2. FFmpeg ---------------------------------------------------------------
+
+if ! command -v ffmpeg >/dev/null 2>&1; then
+  red "✗ FFmpeg is not installed."
+  case "$(uname -s)" in
+    Linux*)   echo "   sudo apt-get install -y ffmpeg   # Debian/Ubuntu"
+              echo "   sudo dnf install -y ffmpeg       # Fedora/RHEL";;
+    Darwin*)  echo "   brew install ffmpeg";;
+    MINGW*|MSYS*|CYGWIN*) echo "   winget install Gyan.FFmpeg";;
+    *)        echo "   See https://ffmpeg.org/download.html";;
+  esac
+  exit 1
+fi
+green "✓ FFmpeg $(ffmpeg -version 2>&1 | head -1 | awk '{print $3}')"
+
+# --- 3. npm ------------------------------------------------------------------
+
+if ! command -v npm >/dev/null 2>&1; then
+  red "✗ npm is not installed (should ship with Node.js)."
+  exit 1
+fi
+
+# --- 4. Install / upgrade hyperframes CLI -----------------------------------
+
+bold "==> Installing hyperframes CLI (>= ${MIN_HYPERFRAMES_VERSION})"
+
+current_hyperframes=""
+if command -v hyperframes >/dev/null 2>&1; then
+  current_hyperframes="$(hyperframes --version 2>/dev/null | tail -1 | sed 's/^v//')"
+fi
+
+if [ -n "$current_hyperframes" ]; then
+  yellow "   Found hyperframes ${current_hyperframes}"
+fi
+
+# Always install/upgrade to >= MIN version.
+# Using 'latest' so we pick up any newer auto-detect/capture fixes.
+if ! npm install -g "hyperframes@latest" >/dev/null 2>&1; then
+  red "✗ npm install -g hyperframes@latest failed."
+  echo "   Try: sudo npm install -g hyperframes@latest"
+  echo "   Or use a user-scoped npm prefix: npm config set prefix ~/.npm-global && export PATH=\"\$HOME/.npm-global/bin:\$PATH\""
+  exit 1
+fi
+
+installed_version="$(hyperframes --version 2>/dev/null | tail -1 | sed 's/^v//')"
+green "✓ hyperframes ${installed_version} installed globally"
+
+# Sanity-check minimum version.
+version_ge() {
+  # version_ge A B  →  true if A >= B
+  [ "$(printf '%s\n%s\n' "$1" "$2" | sort -V | head -1)" = "$2" ]
+}
+if ! version_ge "$installed_version" "$MIN_HYPERFRAMES_VERSION"; then
+  red "✗ hyperframes ${installed_version} is below required minimum ${MIN_HYPERFRAMES_VERSION}."
+  echo "   Try 'npm install -g hyperframes@latest' or 'sudo npm install -g hyperframes@latest'."
+  exit 1
+fi
+
+# --- 5. Pre-cache chrome-headless-shell --------------------------------------
+#
+# Chromium 147+ removed HeadlessExperimental.beginFrame. System Chrome (e.g.
+# /usr/bin/google-chrome) can't render with the fast path, so the engine
+# auto-detects and falls back to screenshot mode — but BeginFrame mode is
+# faster and produces higher-quality output. Install chrome-headless-shell
+# up front so the engine picks it over system Chrome.
+
+bold "==> Pre-caching chrome-headless-shell (for best render quality)"
+
+if ! npx --yes puppeteer browsers install chrome-headless-shell >/dev/null 2>&1; then
+  yellow "⚠ Could not pre-install chrome-headless-shell."
+  yellow "  Rendering will still work via screenshot-mode fallback (slower)."
+  yellow "  If you hit HeadlessExperimental.beginFrame errors:"
+  yellow "     export PRODUCER_FORCE_SCREENSHOT=true"
+  yellow "  See references/troubleshooting.md."
+else
+  green "✓ chrome-headless-shell installed"
+fi
+
+# --- 6. Doctor ---------------------------------------------------------------
+
+bold "==> Running hyperframes doctor"
+
+if hyperframes doctor; then
+  green "✓ HyperFrames is ready"
+  echo
+  echo "   Scaffold a project:   npx hyperframes init my-video"
+  echo "   Preview:              npx hyperframes preview"
+  echo "   Render:               npx hyperframes render"
+else
+  yellow "⚠ hyperframes doctor reported issues."
+  yellow "  See references/troubleshooting.md or re-run 'hyperframes doctor'."
+  exit 1
+fi

package/extensions/skills/optional/creative/kanban-video-orchestrator/SKILL.md

@@ -0,0 +1,158 @@
+---
+name: kanban-video-orchestrator
+description: 规划、设置并监控由 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` 等），并根据需要调用外部 API 进行 TTS、图像生成和图生视频。
+version: 1.0.0
+author: [SHL0MS, alt-glitch]
+license: MIT
+platforms: [linux, macos, windows]
+metadata:
+  hermes:
+    tags: [video, kanban, multi-agent, orchestration, production-pipeline]
+    related_skills: [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]
+    credits: |
+      The single-project workspace layout, profile-config patching pattern,
+      SOUL.md-per-profile model, TEAM.md task-graph convention, and
+      `--workspace dir:<path>` discipline are adapted from alt-glitch's
+      original multi-agent video pipeline at
+      https://github.com/NousResearch/kanban-video-pipeline.
+---
+
+# Kanban 视频编排器
+
+将任何视频请求 —— 从 15 秒的产品预告片到 5 分钟的叙事短片，再到音乐视频或 ASCII 循环动画 —— 封装到一个 Hermes Kanban 流水线中，将工作分解给专门的 agent 配置文件。
+
+此技能本身**不会**渲染任何内容。它是一个元流水线，其功能包括：
+
+1. 通过有针对性的探索**界定**请求范围
+2. 根据风格**设计**合适的团队（包含哪些角色，每个角色使用哪些工具）
+3. **生成**用于创建 Hermes 配置文件、项目工作区和初始看板任务的设置脚本
+4. **移交**给 director 配置文件，由其通过看板进行任务分解
+5. **监控**执行过程，并在任务停滞或失败时协助干预
+
+一旦看板开始运行，实际的渲染工作就会在看板内部通过适合对应场景的现有技能和工具来完成 —— 包括 `ascii-video`、`manim-video`、`p5js`、`comfyui`、`touchdesigner-mcp`、`blender-mcp`、`songwriting-and-ai-music`、`heartmula`、外部 API，或者直接使用基于 PIL + ffmpeg 的 Python 代码。
+
+## 何时不使用此技能
+
+- 视频属于一个连续的程序化项目，不需要专家干预。直接编写代码即可。
+- 用户想要快速的、一步到位的转换（例如“将此 mp4 转换为 GIF”）—— 直接使用 ffmpeg。
+- 输出的是静态图像、GIF 或纯音频文件 —— 使用匹配的特定技能（`ascii-art`、`gifs`、`meme-generation`、`songwriting-and-ai-music`）。
+- 工作完全契合单一的现有技能（例如纯 ASCII 视频 —— 直接使用 `ascii-video`）。
+
+## 工作流程
+
+```
+DISCOVER  →  BRIEF  →  TEAM DESIGN  →  SETUP  →  EXECUTE  →  MONITOR
+```
+
+### 第 1 步 — 探索（提出正确的问题）
+
+探索过程是**自适应的**：只询问确实需要的内容。始终从三个基本问题开始，以确定大致方向：
+
+- **视频是什么？**（一句话简介）
+- **多长？**（5-30秒预告片 / 30-90秒短片 / 90秒-3分钟解说视频 / 3-10分钟电影 / 更长）
+- **宽高比 + 目标平台是什么？**（1:1 / 9:16 / 16:9；X、IG、YouTube、内部使用等）
+
+根据回答，对风格类别进行分类。风格决定了接下来要问哪些问题。**不要一次性问出所有问题。** 每次问 2-4 个，倾听反馈，然后再继续。只要用户暗示了答案，就做出合理的假设。
+
+如需了解完整的引导模式和按风格划分的问题库，请参阅 **[references/intake.md](references/intake.md)**。
+
+### 第 2 步 — 简介
+
+掌握足够的信息后，使用 `assets/brief.md.tmpl` 中的模板生成结构化的 `brief.md`。各个阶段：
+
+1. **概念** —— 一句话核心诉求 + 情感北极星指标
+2. **范围** —— 时长、宽高比、平台、截止日期
+3. **风格** —— 视觉参考、品牌限制、基调
+4. **场景** —— 逐帧节拍分解（时长、内容、目标工具）
+5. **音频** —— 旁白 / 音乐 / 音效 / 静音（如有需要，可按场景划分）
+6. **交付物** —— 文件格式、分辨率、可选的备选方案（竖屏剪辑版、GIF 等）
+
+在设计团队之前，请向用户展示简介以进行确认。**简介就是契约** —— 每一个下游任务都会引用它。
+
+### 第 3 步 — 团队设计
+
+从库中挑选适合该视频的角色原型。**按需组合，不要直接克隆。** 大多数视频需要 4-7 个配置文件。Director 始终存在；其余角色则根据简介的实际需求进行挑选。
+
+如需了解角色库和按风格划分的团队组合，请参阅 **[references/role-archetypes.md](references/role-archetypes.md)**。
+
+如需了解角色到 Hermes 技能 + 工具集的映射关系，请参阅 **[references/tool-matrix.md](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. 配置 profile YAML（工具集、always_load 技能、cwd）
+6. 写入 `brief.md`、`TEAM.md` 以及 `taste/` 中的内容
+7. 触发分配给 director 的初始 `hermes kanban create` 任务
+
+使用 `scripts/bootstrap_pipeline.py` 从简介 + 团队设计 JSON 生成 setup.sh。有关设置脚本结构、配置文件配置模式以及关键的“共享工作区”规则，请参阅 **[references/kanban-setup.md](references/kanban-setup.md)**。
+
+### 第 5 步 — 执行
+
+运行 `setup.sh`。然后向用户提供监控命令：
+
+```bash
+hermes kanban watch --tenant <project-tenant>     # 实时事件
+hermes kanban list  --tenant <project-tenant>     # 看板快照
+hermes dashboard                                   # 可视化看板 UI
+```
+
+接下来交由 director 配置文件接管，它将通过看板工具集进行任务分解，并将任务路由到专家配置文件。
+
+### 第 6 步 — 监控和干预
+
+保持参与 —— 看板会自动运行，但遇到任务停滞或输出效果不佳时，需要人工（或 AI）介入判断。
+
+监控模式：定期轮询 `kanban list`，使用 `kanban show <id>` 检查任何超出预期运行时间的 RUNNING 任务，并检查心跳。当工作节点的输出未通过审查时，标准的干预措施包括：
+
+1. 在工作节点的任务下提供具体反馈评论（`kanban_comment`）
+2. 创建一个以原任务为父节点的重新运行任务
+3. 调整简介的范围，让 director 重新分解
+
+如需了解诊断模式、干预方案以及“任务停滞”的排查手册，请参阅 **[references/monitoring.md](references/monitoring.md)**。
+
+## 参考：实践案例
+
+六个涵盖完全不同视频风格的具体流水线实例 —— 叙事电影、产品/营销、音乐视频、数学/算法解说视频、ASCII 视频、实时装置艺术 —— 展示了相同的工作流程如何产出截然不同的团队和任务图谱。请参阅 **[references/examples.md](references/examples.md)**。
+
+## 关键规则
+
+1. **先探索，后行动。** 在没有至少问完三个基本问题之前，绝不开始生成简介或团队。糟糕的简介会引发连锁反应，影响整个流水线。
+
+2. **团队要匹配视频需求。** 不要为每个项目都重复使用相同的 4 配置文件设置。没有节拍分析配置文件的音乐视频将会失败。没有编剧配置文件的叙事电影将会产生不连贯的场景。请参阅 `references/role-archetypes.md`。
+
+3. **每个项目对应一个工作区。** 给定视频的所有配置文件共享同一个 `dir:` 工作区。任务通过共享文件系统和结构化交接来传递产物。**每一个** `kanban_create` 调用都必须传递 `workspace_kind="dir"` + `workspace_path="<absolute project path>"`。
+
+4. **每个项目使用独立 Tenant。** 使用特定于项目的 tenant（`--tenant <project-slug>`）。这能保持 dashboard 的范围清晰，并防止与其他正在运行的看板发生交叉干扰。
+
+5. **尊重现有技能。** 当某个场景适合现有技能时，相应的渲染器应通过其任务上的 `--skill <name>` 或其配置文件中的 `always_load` 来加载该技能。不要重复推导已有技能提供的功能。
+
+6. **Director 绝不亲自执行。** 即使拥有完整的 `kanban + terminal + file` 工具集，director 的 `SOUL.md` 规则也禁止其亲自执行工作。它只负责分解和路由 —— 每一个具体的任务都会变成向专家配置文件发起的 `hermes kanban create` 调用。自动注入到每个看板 worker 系统提示词中的看板编排指南对此有进一步的明确说明。
+
+7. **不要过度分解。** 一个 30 秒的产品视频不需要 20 个任务。旨在寻找最小的任务图谱，同时依然能够保持良好的并行处理能力，并留出合适的人工审查节点。
+
+8. **在触发前验证 API 密钥。** 外部 API（TTS、image-gen、image-to-video）需要在 `${HERMES_HOME:-~/.hermes}/.env` 或用户的密钥存储中配置相应的密钥。如果 worker 遇到密钥缺失错误，会浪费一个任务槽位。如果缺少所需密钥，设置脚本中的 `check_key` 助手会干净地中止操作。
+
+## 文件映射
+
+```
+SKILL.md                            ← this file (workflow + rules)
+references/
+  intake.md                         ← discovery question banks per style
+  role-archetypes.md                ← role library (writer, designer, animator, …)
+  tool-matrix.md                    ← skill + toolset mapping per role
+  kanban-setup.md                   ← setup script structure & profile config
+  monitoring.md                     ← watch + intervene patterns
+  examples.md                       ← six worked pipelines
+assets/
+  brief.md.tmpl                     ← brief skeleton
+  setup.sh.tmpl                     ← setup script skeleton
+  soul.md.tmpl                      ← profile personality skeleton
+scripts/
+  bootstrap_pipeline.py             ← generate setup.sh from brief + team JSON
+  monitor.py                        ← polling + intervention helpers
+```

package/extensions/skills/optional/creative/kanban-video-orchestrator/assets/brief.md.tmpl

@@ -0,0 +1,79 @@
+# Video Brief — {{TITLE}}
+
+> Slug: `{{SLUG}}` · Tenant: `{{TENANT}}` · Project workspace: `{{WORKSPACE}}`
+
+## 1. Concept
+
+**One-line pitch.** {{ONE_LINE_PITCH}}
+
+**Emotional north star.** {{EMOTIONAL_NORTH_STAR}}
+*(What should the viewer feel walking away?)*
+
+## 2. Scope
+
+| | |
+|---|---|
+| Duration | {{DURATION_S}} seconds |
+| Aspect ratio | {{ASPECT}} |
+| Resolution | {{RESOLUTION}} |
+| Frame rate | {{FPS}} fps |
+| Target platforms | {{PLATFORMS}} |
+| Deadline | {{DEADLINE}} |
+| Quality bar | {{QUALITY_BAR}} *(rough draft / polished / archival)* |
+
+## 3. Style
+
+**Visual references.** {{VISUAL_REFS}}
+
+**Tone.** {{TONE}}
+
+**Brand constraints.** {{BRAND_CONSTRAINTS}}
+*(colors, typography, motion language; or "n/a")*
+
+**Aesthetic rules.**
+{{AESTHETIC_RULES}}
+
+## 4. Scenes
+
+Beat-by-beat breakdown. Each scene gets a row.
+
+| # | Time | Content | Target tool / skill | Audio | Notes |
+|---|------|---------|---------------------|-------|-------|
+| 1 | 0:00–0:0X | {{SCENE_1_CONTENT}} | {{SCENE_1_TOOL}} | {{SCENE_1_AUDIO}} | {{SCENE_1_NOTES}} |
+| 2 | 0:0X–0:0Y | ... | ... | ... | ... |
+
+## 5. Audio
+
+**Approach.** {{AUDIO_APPROACH}}
+*(narration / music-only / synced to track / silent / mixed)*
+
+**Voiceover.** {{VO_DETAILS}}
+*(provider, voice, language, script source — "n/a" if no VO)*
+
+**Music.** {{MUSIC_DETAILS}}
+*(provided track path / commission via Suno / commission via heartmula /
+license-free / "n/a")*
+
+**SFX.** {{SFX_DETAILS}}
+*(generated, library, or "n/a")*
+
+## 6. Deliverables
+
+| Format | Resolution | Notes |
+|--------|-----------|-------|
+| {{PRIMARY_FORMAT}} | {{PRIMARY_RES}} | The main output |
+| {{ALT_FORMAT_1}} | {{ALT_RES_1}} | {{ALT_NOTES_1}} |
+
+**Final filename.** `output/final.mp4`
+*(plus optional `output/final-9x16.mp4`, `output/captions.srt`, etc.)*
+
+## 7. Constraints
+
+- API keys required: {{API_KEYS_REQUIRED}}
+- External dependencies: {{EXT_DEPS}}
+- Source assets to incorporate: {{SOURCE_ASSETS}}
+
+---
+
+**This brief is the contract. The director and every downstream profile read
+it. If the brief changes, the kanban must be re-fired — don't edit live.**