@baimingtao/lbs-agent 1.0.0

package/extensions/skills/optional/creative/kanban-video-orchestrator/assets/setup.sh.tmpl

@@ -0,0 +1,186 @@
+#!/usr/bin/env bash
+# ═══════════════════════════════════════════════════════════════════════
+# Video Pipeline Setup — {{TITLE}}
+#
+# Generated by kanban-video-orchestrator skill.
+#
+# Slug:      {{SLUG}}
+# Workspace: {{WORKSPACE}}
+# Tenant:    {{TENANT}}
+# ═══════════════════════════════════════════════════════════════════════
+set -euo pipefail
+
+PROJECT_SLUG="{{SLUG}}"
+WORKSPACE="$HOME/projects/video-pipeline/${PROJECT_SLUG}"
+TENANT="{{TENANT}}"
+
+# ─────────────────────────────────────────────────────────────────────
+# 1. Verify required API keys
+# ─────────────────────────────────────────────────────────────────────
+echo "═══ Checking required API keys ═══"
+
+check_key() {
+    local var="$1"
+    local kc_account="${2:-hermes}"
+    local kc_service="${3:-$1}"
+    local _hermes_env="${HERMES_HOME:-$HOME/.hermes}/.env"
+    if grep -q "^${var}=" "$_hermes_env" 2>/dev/null && \
+       [ -n "$(grep "^${var}=" "$_hermes_env" | cut -d= -f2-)" ]; then
+        echo "  ✓ ${var} (env)"
+        return 0
+    fi
+    if command -v security >/dev/null 2>&1 && \
+       security find-generic-password -a "${kc_account}" -s "${kc_service}" -w >/dev/null 2>&1; then
+        echo "  ✓ ${var} (Keychain ${kc_account}/${kc_service})"
+        return 0
+    fi
+    echo "  ✗ ${var} not set in ${_hermes_env} or Keychain (${kc_account}/${kc_service})"
+    return 1
+}
+
+# Customize this list per project — only check keys actually used:
+{{KEY_CHECKS}}
+
+# ─────────────────────────────────────────────────────────────────────
+# 2. Create project workspace
+# ─────────────────────────────────────────────────────────────────────
+echo "═══ Creating project workspace ═══"
+mkdir -p "$WORKSPACE"/{taste,audio/{voiceover,sfx},assets,scenes,checkpoints,tools,output}
+{{SCENE_DIRS}}
+echo "  ✓ $WORKSPACE"
+
+# ─────────────────────────────────────────────────────────────────────
+# 3. Create Hermes profiles
+# ─────────────────────────────────────────────────────────────────────
+echo "═══ Creating Hermes profiles ═══"
+
+{{PROFILE_CREATE_COMMANDS}}
+
+# ─────────────────────────────────────────────────────────────────────
+# 4. Configure profiles (toolsets, skills, cwd)
+# ─────────────────────────────────────────────────────────────────────
+echo "═══ Configuring profiles ═══"
+
+configure_profile() {
+    local profile="$1"
+    local toolsets_json="$2"     # JSON array string, e.g. '["kanban","terminal","file"]'
+    local skills_json="$3"       # JSON array string, e.g. '["ascii-video"]'
+    python3 - "$profile" "$toolsets_json" "$skills_json" "$WORKSPACE" <<'PY'
+"""Patch a Hermes profile config.yaml using PyYAML so we don't depend on the
+exact default-config string format. Validates the patch took effect and exits
+non-zero if anything's off."""
+import json
+import os
+import sys
+
+try:
+    import yaml
+except ImportError:
+    print("ERROR: PyYAML required. pip install pyyaml", file=sys.stderr)
+    sys.exit(1)
+
+profile, toolsets_json, skills_json, workspace = sys.argv[1:5]
+toolsets = json.loads(toolsets_json)
+skills = json.loads(skills_json)
+
+p = os.path.expanduser(f"~/.hermes/profiles/{profile}/config.yaml")
+if not os.path.exists(p):
+    print(f"  ✗ profile config not found: {p}", file=sys.stderr)
+    sys.exit(1)
+
+with open(p) as f:
+    cfg = yaml.safe_load(f) or {}
+
+# Apply our changes — only the keys we actually want to set.
+cfg["toolsets"] = toolsets
+cfg.setdefault("skills", {})
+cfg["skills"]["always_load"] = skills
+
+# Note: we do NOT touch cfg["approvals"] — that's a security-sensitive
+# setting (manual confirmation of tool calls). Workspace cwd is overridden
+# per-task by `--workspace dir:<path>` on `hermes kanban create`, so we
+# don't need to mutate cfg["terminal"]["cwd"] either.
+
+with open(p, "w") as f:
+    yaml.safe_dump(cfg, f, sort_keys=False)
+
+# Validate
+with open(p) as f:
+    after = yaml.safe_load(f)
+errors = []
+if after.get("toolsets") != toolsets:
+    errors.append(f"toolsets mismatch: {after.get('toolsets')!r}")
+if after.get("skills", {}).get("always_load") != skills:
+    errors.append(f"skills.always_load mismatch: {after.get('skills', {}).get('always_load')!r}")
+if errors:
+    print(f"  ✗ {profile}: " + "; ".join(errors), file=sys.stderr)
+    sys.exit(1)
+PY
+    if [ $? -ne 0 ]; then
+        echo "  ✗ failed to configure ${profile}" >&2
+        exit 1
+    fi
+    echo "  ✓ ${profile}"
+}
+
+{{PROFILE_CONFIG_COMMANDS}}
+
+# ─────────────────────────────────────────────────────────────────────
+# 5. Write SOUL.md per profile
+# ─────────────────────────────────────────────────────────────────────
+echo "═══ Writing profile personalities ═══"
+
+{{SOUL_WRITES}}
+
+# ─────────────────────────────────────────────────────────────────────
+# 6. Copy brief, TEAM.md, and any provided assets
+# ─────────────────────────────────────────────────────────────────────
+echo "═══ Writing brief + taste ═══"
+
+cat > "$WORKSPACE/brief.md" <<'BRIEF_EOF'
+{{BRIEF_CONTENTS}}
+BRIEF_EOF
+
+cat > "$WORKSPACE/TEAM.md" <<'TEAM_EOF'
+{{TEAM_CONTENTS}}
+TEAM_EOF
+
+{{TASTE_WRITES}}
+
+{{ASSET_COPIES}}
+
+# ─────────────────────────────────────────────────────────────────────
+# 7. Fire the initial kanban task
+# ─────────────────────────────────────────────────────────────────────
+echo "═══ Firing initial kanban task ═══"
+
+hermes kanban create "Direct production of {{TITLE}}" \
+    --assignee director \
+    --workspace dir:"$WORKSPACE" \
+    --tenant "$TENANT" \
+    --priority 2 \
+    --max-runtime 4h \
+    --body "$(cat <<EOF
+Read brief.md, TEAM.md, and taste/.
+
+Decompose into the team graph defined in TEAM.md.
+
+All child tasks MUST use:
+  workspace_kind="dir"
+  workspace_path="$WORKSPACE"
+  tenant="$TENANT"
+
+Do not execute the work yourself — route every concrete subtask to the
+appropriate profile via kanban_create.
+EOF
+)"
+
+echo ""
+echo "═══ Setup complete ═══"
+echo ""
+echo "Monitor with:"
+echo "  hermes kanban watch --tenant $TENANT"
+echo "  hermes kanban list  --tenant $TENANT"
+echo "  hermes dashboard"
+echo ""
+echo "Workspace: $WORKSPACE"

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

@@ -0,0 +1,38 @@
+# {{ROLE_NAME}}
+
+You are the **{{ROLE_NAME}}** for this video production.
+
+## Project context
+
+- **Brief:** read `brief.md` in your CWD
+- **Team graph:** read `TEAM.md` in your CWD
+- **Style spec:** read `taste/brand-guide.md` and `taste/emotional-dna.md` in
+  your CWD
+
+## What you do
+
+{{ROLE_RESPONSIBILITIES}}
+
+## Inputs you read
+
+{{INPUTS_READ}}
+
+## Outputs you produce
+
+{{OUTPUTS_PRODUCED}}
+
+## Tools and skills available
+
+- **Toolsets:** {{TOOLSETS}}
+- **Skills loaded:** {{SKILLS}}
+- **External APIs / CLIs:** {{EXTERNAL_TOOLS}}
+
+## Rules
+
+{{ROLE_RULES}}
+
+{{COMMON_RULES}}
+
+## Common reference commands
+
+{{COMMON_COMMANDS}}

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

@@ -0,0 +1,203 @@
+# Worked 示例
+
+六个涵盖不同视频风格的具体 pipeline。每个示例都展示了针对特定需求简报，orchestrator 会做出的团队组成、task graph 以及 skill/工具选择。**这些仅供说明参考，而非模板** —— 请根据实际需求进行调整。
+
+## 示例 1 — 叙事短片 (text-to-image → image-to-video → cut)
+
+**需求：** 一部 90 秒的黑色电影风格短片。一名侦探走过下雨的城市。旁白叙述。AI 生成的视觉画面。
+
+**团队：**
+- `director` — 视觉构思、任务拆解、审批
+- `writer` — 脚本 + 旁白文案 (加载 `humanizer` 以获得自然的声音)
+- `storyboarder` — 逐拍镜头列表 (加载 `excalidraw`)
+- `image-generator` — 通过本地 ComfyUI workflow 为每个镜头生成静帧 (加载 `comfyui`)
+- `image-to-video-generator` — 为每张静帧制作动画 (Runway/Kling，或通过 `comfyui` 使用 ComfyUI 的 AnimateDiff/WAN workflow)
+- `voice-talent` — 通过 ElevenLabs 生成旁白
+- `audio-mixer` — 旁白 (VO) + 环境音垫层
+- `editor` — 剪辑拼接 + 转场
+- `reviewer` — 最终质量保证 (QA)
+
+**Task graph:**
+```
+T0  director         decompose
+T1  writer           script + voiceover.md                    (parent: T0)
+T2  storyboarder     shot list with framing per beat          (parent: T1)
+T3  image-generator  one still per shot (~12 shots)           (parent: T2)
+T4  image-to-video   animate each still                       (parent: T3)
+T5  voice-talent     generate narration audio                 (parent: T1)
+T6  audio-mixer      mix VO + ambient                         (parent: T5)
+T7  editor           cut + transitions + audio mux            (parents: T4, T6)
+T8  reviewer         final QA                                 (parent: T7)
+```
+
+**关键选择：**
+- 出于成本和可控性的考虑，优先选择通过 `comfyui` skill 使用本地 ComfyUI，而不是外部 API —— 但如果未安装 ComfyUI，使用外部 API 也可以
+- `editor` profile 仅使用 ffmpeg，不需要 Hermes skill (kanban guidance 会自动注入到每个 kanban worker 中)
+- Storyboarder 会生成 Markdown 文件以及 `storyboard.excalidraw` 文件
+
+## 示例 2 — 产品 / 营销宣传片
+
+**需求：** 为一款开发者工具制作 30 秒的产品宣传片。包含代码 + 终端 + UI 屏幕录制、旁白，以及结尾的 CTA。1:1 正方形比例。
+
+**团队：**
+- `director`
+- `copywriter` — 标语、旁白脚本、CTA (加载 `humanizer`)
+- `concept-artist` — 风格帧 (加载 `claude-design` 制作 UI 原型)
+- `renderer-motion-graphics` — UI 动画序列 (Remotion CLI)
+- `renderer-ascii` — 终端风格的演示场景 (加载 `ascii-video`)
+- `voice-talent` — 通过 ElevenLabs 生成旁白 (VO)
+- `editor` — 剪辑拼接 + 品牌色调色处理
+- `audio-mixer` — 旁白 (VO) + 轻柔的背景音乐
+- `captioner` — 针对静音自动播放平台烧录字幕
+- `masterer` — 输出 1:1 + 9:16 + 16:9 多版本
+
+**Task graph:**
+```
+T0  director              decompose
+T1  copywriter            copy.md + cta + vo script               (parent: T0)
+T2  concept-artist        visual-spec.md + style frames           (parent: T1)
+T3a renderer-motion-graphics  scene 1: UI sequence                (parent: T2)
+T3b renderer-ascii        scene 2: terminal demo                  (parent: T2)
+T3c renderer-motion-graphics  scene 3: feature highlight          (parent: T2)
+T3d renderer-motion-graphics  scene 4: CTA card                   (parent: T2)
+T4  voice-talent          narration                                (parent: T1)
+T5  audio-mixer           VO + music bed                          (parent: T4)
+T6  editor                cut + transitions                        (parents: T3*, T5)
+T7  captioner             SRT + burned subtitles                  (parent: T6)
+T8  masterer              1:1, 9:16, 16:9 variants                (parent: T7)
+```
+
+**关键选择：**
+- 多个专业渲染器 (motion-graphics + ASCII) 共存
+- 包含 Captioner 是因为静音自动播放是社交平台上的常态
+- 用于 UI 原型的 `claude-design` skill 直接契合产品视频的表达范式
+
+## 示例 3 — 音乐视频 (与提供的音轨同步)
+
+**需求：** 为提供的 lo-fi hip-hop 音轨制作 3 分钟的音乐视频。视觉效果应随节拍跳动。生成式 + ASCII 混合风格。9:16 竖屏比例。
+
+**团队：**
+- `director`
+- `music-supervisor` — 分析音轨，输出 `audio/beats.json` (加载 `songsee`)
+- `storyboarder` — 与节拍对齐的镜头列表 (加载 `excalidraw`)
+- `renderer-ascii` — 与低音鼓同步的 ASCII 场景 (加载 `ascii-video`)
+- `renderer-p5js` — 与高音同步的生成式粒子场景 (加载 `p5js`)
+- `editor` — 使用 `beats.json` 进行节拍剪辑拼接
+- `reviewer` — 同步效果 QA
+
+**Task graph:**
+```
+T0  director              decompose
+T1  music-supervisor      analyze track → beats.json + spectrogram  (parent: T0)
+T2  storyboarder          shot list aligned to beats                (parents: T1, T0)
+T3a renderer-ascii        scene 1: bass-driven ASCII                (parent: T2)
+T3b renderer-p5js         scene 2: high-end particle field          (parent: T2)
+... (more scenes)
+T4  editor                cut to beats + mux track                  (parents: T3*, T1)
+T5  reviewer              sync QA + final approval                  (parent: T4)
+```
+
+**关键选择：**
+- `music-supervisor` 首先运行 — `beats.json` 是渲染器启动的门控条件
+- `editor` 直接使用 `beats.json` 将剪辑点与低音鼓对齐
+- 无需 voice-talent — 音乐即是全部音频
+- 使用两个专门的渲染器 (`ascii-video` + `p5js`) 营造视觉多样性
+
+## 示例 4 — 数学/算法讲解视频
+
+**需求：** 一段 2 分钟的算法讲解视频。3Blue1Brown 风格。包含动画图表、公式和旁白。1:1 正方形比例。
+
+**团队：**
+- `director`
+- `writer` — 旁白脚本 (加载 `humanizer`)
+- `cinematographer` — 视觉规范 (加载 `manim-video`)
+- `renderer-manim` — 所有动画场景 (加载 `manim-video`)
+- `voice-talent` — 通过 ElevenLabs 生成旁白
+- `editor` — 剪辑拼接 + 音频合成
+- `captioner` — 烧录字幕
+
+**Task graph:**
+```
+T0  director           decompose
+T1  writer             script + narration                  (parent: T0)
+T2  cinematographer    visual spec for all scenes           (parent: T1)
+T3a-Tn renderer-manim  scenes 1..N                          (parents: T2)
+T4  voice-talent       narration audio                      (parent: T1)
+T5  editor             cut + mux                            (parents: T3*, T4)
+T6  captioner          SRT + burn                           (parent: T5)
+```
+
+**关键选择：**
+- `manim-video` skill 同时驱动 cinematographer (视觉语言) 和 renderer (实际场景制作)
+- `manim-video` skill 的参考文档 (animation-design-thinking, scene-planning, equations) 会在需要时通过 renderer 锁定的 skill 自动加载
+
+## 示例 5 — ASCII 视频，纯音乐音轨
+
+**需求：** 一段 60 秒的纯 ASCII 视频，对现有音轨产生反应。无旁白，不使用其他工具。1:1 正方形比例。
+
+**团队：**
+- `director`
+- `music-supervisor` — 音轨分析 (加载 `songsee`)
+- `renderer-ascii` — 所有视觉画面 (加载 `ascii-video`)
+- `editor` — 剪辑拼接 + 音频合成
+
+**Task graph:**
+```
+T0  director           decompose
+T1  music-supervisor   analyze track                       (parent: T0)
+T2a renderer-ascii     scene 1                             (parents: T1, T0)
+T2b renderer-ascii     scene 2                             (parents: T1, T0)
+T2c renderer-ascii     scene 3                             (parents: T1, T0)
+T3  editor             stitch + mux audio                  (parents: T2*)
+```
+
+**关键选择：**
+- 针对专注于单一工具的项目采用最精简团队 (4 个 profile)
+- 无需 reviewer — 作为简短的实验性作品，由 director 直接审批
+- 所有场景都通过同一个 `renderer-ascii` profile 运行，因为 `ascii-video` skill 涵盖了所有需求
+
+此示例说明了一条规则：**不要过度拆解**。通过同一个 renderer 处理三个场景完全没有问题。不要为此生成三个 renderer profile。
+
+## 示例 6 — 实时 / 装置艺术
+
+**需求：** 为画廊装置制作 2 分钟的音频反应视觉画面。由音频输入源驱动。基于 TouchDesigner。16:9 4K 分辨率。
+
+**团队：**
+- `director`
+- `cinematographer` — 视觉语言规范 (加载 `touchdesigner-mcp`)
+- `renderer-touchdesigner` — 所有视觉画面 + 录制到磁盘 (加载 `touchdesigner-mcp`)
+- `audio-mixer` — 对采集的音频进行最终响度处理 (如果源音频已预混则可选)
+- `editor` — 使用 TouchDesigner 的录制内容组装最终片段
+- `reviewer` — 视觉 QA
+
+**Task graph:**
+```
+T0  director                decompose
+T1  cinematographer         TD operator graph spec           (parent: T0)
+T2  renderer-touchdesigner  build TD network + record output (parent: T1)
+T3  editor                  trim + audio mux                 (parent: T2)
+T4  reviewer                final QA                         (parent: T3)
+```
+
+**关键选择：**
+- `touchdesigner-mcp` 控制正在运行的 TouchDesigner 实例 — cinematographer 负责设计 operator graph，renderer 负责构建它
+- 输出内容是运行中的 TD network 的录制文件，而不是渲染至逐帧 (render-to-frames) 的过程；editor 主要只负责裁剪
+
+## 模式识别
+
+当用户描述视频时，请寻找以下信号以将其映射到对应示例：
+
+- **剧情、角色、剧本对话** → 示例 1 (narrative)
+- **特定产品、CTA、品牌色、旁白** → 示例 2 (marketing)
+- **提供了音轨文件、“与音乐同步”** → 示例 3 (music video)
+- **“解释 X 是如何运作的”、数学/算法/概念演示** → 示例 4 (manim explainer)
+- **终端美学、ASCII、复古像素** → 示例 5 (ASCII)
+- **“音频反应”、“实时”、“装置”** → 示例 6 (TouchDesigner)
+- **漫画风格的叙事** → 使用 `renderer-comic` (`baoyu-comic` skill)
+- **复古游戏 / 像素艺术美学** → 使用 `renderer-pixel` (`pixel-art` skill)
+- **3D 场景、逼真的环境** → 使用 `renderer-3d` (`blender-mcp`)
+- **生成艺术、粒子系统、shader** → 使用 `renderer-p5js` (`p5js`)
+- **AI 生成的逼真静帧与动画** → 同时使用 `renderer-comfyui` (`comfyui`) 处理静帧和 image-to-video
+- **“关于系统运作原理的视频”、递归演示** → 可由上述任何示例组合而成；递归只是一种渲染技术，而不是一种风格
+
+实际的团队应该根据具体的需求来组建 —— 这些示例是起点，而不是终点。

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

@@ -0,0 +1,142 @@
+# Intake — Discovery Question Banks
+
+Discovery 流程是**自适应的**。始终先从三个基线问题开始，以识别大致的风格类别，然后深入到特定风格的问题库中。每次提出 2-4 个问题，倾听反馈，然后再继续。每当用户的回答暗示了某种选择时，请做出合理的假设。
+
+## Tier 0 — Baseline (始终询问)
+
+1. **视频是什么？** — 一句话概述
+2. **多长？** — 预计时长
+3. **宽高比 + 目标平台？** — 16:9 / 9:16 / 1:1 / 4:5；X, IG, YouTube, internal 等。
+
+根据这些回答，对风格类别进行分类，并选择相关的 Tier 1 后续问题。**在你至少得到这三个问题的答案之前，不要**继续提问。
+
+## Style classification
+
+将需求映射到以下原型之一（或混合型）：
+
+| Archetype | 特征 |
+| ----------- | ------- |
+| **Narrative film** | 情节、角色、带事件的场景、对话、地点 |
+| **Product / marketing** | 展示/销售特定产品或功能；结尾带有 CTA |
+| **Music video** | 存在特定音轨；视觉与音乐同步 |
+| **Explainer / educational** | 讲授某个概念；由配音驱动 |
+| **Tutorial / changelog** | 软件演示，以终端内容为主，技术性强 |
+| **ASCII / terminal art** | 明确的复古终端美学，字符网格 |
+| **Abstract / loop** | 生成式，无情节，通常是完美循环 |
+| **Documentary / interview cut** | 真实素材，由逐字稿驱动 |
+| **Real-time / installation** | 音频反应、画廊装置、VJ 输出 |
+
+如果不明确，**请询问**哪个类别更合适——不要猜测。混合型很常见（例如，带有叙事弧线的产品视频）；将其分解为主要模式 + 次要修饰。
+
+**Recursive / meta**（“展示其自身制作过程的视频”）是一种*渲染技术*，而不是一种独立的风格——在上述任何风格的基础上，通过添加一个两步渲染步骤来组合，即 pass 2 将 pass 1 的输出作为最终场景内的纹理。
+
+## Tier 1 — Per-style follow-ups
+
+### Narrative film
+
+- **Setting / world?** — 故事发生的时间和地点
+- **Characters?** — 数量、原型，谁负责对话
+- **Beat list or full script?** — 用户已经写好了故事，还是需要我们来起草
+- **Dialogue language?** — 口语台词、仅屏幕字幕、无声
+- **Visual generation approach?** — Text-to-image (FAL/Midjourney/Imagen) → image-to-video (Runway/Kling), 3D animation (Blender), 2D animation, procedural, 或 hybrid
+- **Voice approach?** — TTS（哪种声音）、录制的 VO、无对话
+- **Music / score?** — 委托制作（通过 `songwriting-and-ai-music` Suno 提示词，或本地 `heartmula`）、提供已授权的音轨、无声
+
+### Product / marketing
+
+- **Product?** — 名称、功能、展示的关键特性
+- **Target audience?** — 受众是谁，他们关心什么
+- **CTA?** — 访问 URL、安装、注册等
+- **Tone?** — 严肃、俏皮、技术性、高端、前卫
+- **Brand assets available?** — Logo 文件、调色板、字体、现有素材
+- **Animation style?** — Motion graphics (Remotion / AE-style), screen recording, generative, illustrated
+- **Voiceover?** — 是（哪种声音/语言）还是仅文本
+- **Music?** — 提供音轨、需要免授权音乐、定制作曲
+
+### Music video
+
+- **Track file?** — 音频的路径（必不可少——我们将分析 BPM + 节拍）
+- **Track length to use?** — 完整歌曲还是某个片段
+- **Genre / energy?** — 决定使用什么样的视觉节奏和密度
+- **Lyric / narrative content?** — 是否有需要在屏幕上渲染的歌词，还是纯粹的视觉内容
+- **Visual reference style?** — 用于参考的现有音乐视频/艺术家
+- **Performer footage?** — 无、有片段、将会提供
+- **Visual generation approach?** — Per-beat generative, 基于剪辑的库素材拼接, illustrated, hybrid
+
+### Explainer / educational
+
+- **What concept is being taught?** — 一句话概念，核心要点
+- **Audience expertise?** — 初级 / 中级 / 专家
+- **Diagram density?** — 大量数学/公式/代码/抽象概念
+- **Voiceover?** — TTS / 录制 / 仅屏幕文本
+- **Tool preference?** — `manim-video` (数学), `p5js` (generative), Remotion (UI motion graphics), `comfyui` (AI 生成的视觉效果), `ascii-video` (技术/复古), hybrid
+- **Pacing?** — 快速高密度 (3Blue1Brown) 还是缓慢且发人深省
+
+### Tutorial / changelog / software demo
+
+- **Software being demonstrated?** — 名称、功能
+- **Demo script?** — 要展示的命令/屏幕序列
+- **Terminal-only or with GUI?** — 仅终端还是带有 GUI
+- **Voiceover for narration?** — 是否需要配音叙述
+- **Diagram support needed?** — 这些通常受益于在 screen-capture/render 步骤旁使用图表技能 (`excalidraw`, `architecture-diagram`, `concept-diagrams`)
+
+### ASCII / terminal art
+
+- **Source material?** — Generative / 由音频驱动 / 转换现有视频 / 静态图像起点
+- **Color palette?** — 品牌主导（金/黑/蓝）、黑客帝国绿、全彩虹、单色
+- **Audio reactivity?** — 无 / 宽松的氛围 / 紧凑的节拍同步 / FFT 驱动
+- **Character set?** — 仅 ASCII / Unicode 画块字符 / 神秘符号
+- **Loop or narrative?** — 完美循环或单次播放
+
+### Abstract / loop
+
+- **Mood / emotion?** — 捕捉这种感觉的一个词
+- **Motion type?** — 自身缩放、粒子漂移、波浪、几何、有机
+- **Loop required?** — 完美循环 (Droste-style) 或仅仅是令人满意的结尾
+- **Audio?** — 无声、环境氛围音、节拍同步
+
+### Documentary / interview cut
+
+- **Source footage?** — 提供的片段，每个片段的长度
+- **Transcript / subtitles?** — 已提供还是需要生成
+- **Story structure?** — 时间顺序 / 主题 / 弧线
+- **B-roll approach?** — 生成式、素材库、无
+
+### Real-time / installation
+
+- **Output environment?** — 画廊墙面、投影仪、屏幕、Web 嵌入
+- **Audio source?** — 实时音频输入、预录音轨、两者兼有
+- **Reactivity tightness?** — 氛围层面（宽松）对比紧凑的节拍同步对比实时参数控制
+- **Tool preference?** — `touchdesigner-mcp` 用于完整的 TD 算子图；`p5js` 用于 Web-canvas；`comfyui` 用于由音频特征驱动的 generative-AI
+
+## Tier 2 — Always ask near the end
+
+- **Brand assets path?** — Logo / 调色板 / 字体 / 音乐库所在的位置
+- **Output format requirements?** — 偏好的编解码器、目标文件大小、可接受的替代方案（竖版剪辑、GIF、纯音频）
+- **Deadline?** — 影响任务 `max_runtime_seconds` 和可接受的范围
+- **Quality bar?** — 用于审查的草稿 / 精修的最终版 / 归档级
+- **Existing footage / assets to reuse?** — 任何应当实际出现的内容，而不仅仅是作为参考信息
+
+## Reasonable assumption defaults
+
+当用户提供的信息不够详细时，填入这些默认值，而不是反复询问：
+
+| 问题 | 默认值 |
+| ---------- | --------- |
+| Frame rate | 30 fps 适用于 X / IG；60 fps 适用于 tutorials/explainers；24 fps 适用于 narrative film |
+| Resolution | 1080×1080 适用于正方形，1920×1080 适用于 16:9，1080×1920 适用于 9:16 |
+| Codec | H.264 / yuv420p, CRF 18 |
+| Audio codec | AAC 192 kbps |
+| Voice | 提供商的中性基础声音，除非品牌要求特定的音色 |
+| Music | 无声（如果需要音乐，要求用户明确指定） |
+| Captions | Explainer/tutorial 默认开启；narrative/abstract 默认关闭，除非有要求 |
+| Quality bar | 精修的最终版，除非用户说是草稿 |
+
+明确说明假设：*"除非另有说明，否则假设使用 30fps 和 AAC 音频——继续进行吗？"*
+
+## Anti-patterns
+
+- **一次问 10 个问题。** 每轮最多 4 个。
+- **询问需求中已经暗示的内容。** 如果用户说“为我的曲目制作音乐视频”，不要再问“有曲目吗？”
+- **在深入之前未能进行分类。** Tier-1 问题取决于分类；混淆它们会浪费对话轮次。
+- **将“制作一个视频”视为足以继续推进的条件。** 始终确认这三个基线问题。