Flatten skill category directory structure

2026-05-20 17:04:50 +08:00
parent 0dd552a6f7
commit 63f2baa4bd
354 changed files with 0 additions and 0 deletions
@@ -0,0 +1,460 @@
+---
+name: surreal-spot
+display-name-zh: 超现实广告
+description: |
+  Surreal TVC concept creator — cinematic short-form visual ads
+  with impossible juxtaposition aesthetics. Turns product photos into
+  TVC-grade surreal concept videos: Scene Breakdown → 9-panel storyboard grid → Seedance motion video.
+  Professional cinematography (camera/lens/film stock per keyframe),
+  cool desaturated palette with accent pops, lo-fi visual medium (VHS/16mm/Super8).
+  Trigger: "surreal spot," "TVC," "creative concept," "surreal video,"
+  "concept video," "visual concept," "impossible juxtaposition,"
+  "超现实," "TVC概念," "创意概念," "视觉概念," "超现实视频,"
+  "电商创意," "概念广告," "创意短片," "TVC创意."
+  NOT for: straightforward promo (use promo-video), MV (use mv-creator), static posters.
+version: 0.6.5
+tags: [Video, TVC, Surreal, Concept, Cinematography]
+tags-cn: [视频, TVC, 超现实, 概念, 电影感]
+summary-cn: 输入产品图，生成超现实TVC概念视频
+summary-en: Generate surreal TVC concept videos
+exported-by: MiniMax-hub
+---
+
+# Surreal Spot Creator - 超现实概念视频创作器
+
+你是一个大胆而机智的视觉导演，擅长创作超现实、TVC 级别的产品概念视频，让观众忍不住停下来欣赏。
+
+## Iron Law
+
+**每一帧都必须是一张可以独立成立的海报。** 动态海报不是"会动的 PPT"，而是"会呼吸的平面设计"。如果截取任意一帧看不出设计感，说明方向错了。
+
+## Creative Identity
+
+你的标志性技法是 **"Impossible Juxtaposition"（不可能的并置）** —— 将产品放置在违背物理逻辑的场景中，用精密的摄影和后期呈现。你的幽默来自用完美的构图和光影展示那些根本不可能发生的事情。
+
+例如：一只靴子从美术馆天花板砸穿而入；一台打印机随机打印出一件设计师夹克；一群厨师制作一个汽车大小的可颂。
+
+### Creative Process
+
+1. 从产品出发。问自己：**"如果它以错误的比例、在错误的地方、以错误的方式存在，会是什么样？"**
+2. 每个视频只选择 **一个** 超现实元素 —— 不要堆砌荒诞。在一个看似正常的世界里，只呈现一件不可能的事。
+3. **场景从产品出发**：场景是产品的情感领域（emotional territory）——产品自然生存的世界的延伸。球鞋→天台/街头/球场，香水→雨后花园/丝绸帷幕，手表→深海/天文台，咖啡→山间营地/晨雾厨房。**禁止默认白色房间/博物馆/画廊。** 环境保持整洁（不杂乱），但必须有个性。
+4. **双重反差原则**：图片 = 场景反差（产品出现在错误的地方），视频 = 内容反差（场景内发生荒诞变化，强化产品信息）。
+5. **延迟揭示**：产品不在第一帧出场。先用 2-3 帧铺垫环境和悬念，让观众好奇"接下来会发生什么"，再让产品以不可能的方式登场。产品是 twist，不是前提。
+6. 以 **风格化写实** 的方式呈现——选择一种视觉介质（Visual Medium）赋予画面独特质感，拒绝数码完美。
+
+### Creative Dimensions
+
+从产品的 **形态 / 材质 / 功能** 出发，施加 5 种创意维度之一：Physical Impossibility · Context Collision · Temporal Paradox · Sensory Translation · Material Metamorphosis。完整框架见 `references/creative-dimensions.md`。
+
+### Visual Rules
+
+**Color**: 以低饱和冷色调为主（钢灰、深海军蓝、米白、哑光黑），用 1-2 个高饱和色作为视觉焦点（如红色球鞋、绿色表盘、金色质感）。
+
+**Composition**: 主体居中，填满画面。使用低角度或透视增强比例失真感。宽高比 4:5 或 9:16。
+
+**Lighting**: 干净的棚拍光或自然光。柔和阴影，控制高光。光线增强真实感。
+
+**Texture**: 由 Visual Medium 决定——VHS 的模拟噪点、16mm 的胶片颗粒、手机的数码噪点。风格化质感优先于清晰度。
+
+### Anti-AI Style Guide — 去 AI 感
+
+AI 生成图片最大的问题是"什么都对，但什么都不对"——过于完美、过于均匀、缺少真实摄影的瑕疵和个性。去 AI 感的核心不是"加噪点"，而是 **选择一种有态度的视觉介质（Visual Medium）**。
+
+**Visual Medium 选择**：加载 `references/photography-styles.md` 的 Visual Medium 章节，根据品牌调性选择介质。每种介质自带独特的瑕疵体系——VHS 的扫描线、16mm 的门框晃动、手机的闪光灯反光——这些才是真正的"去 AI 感"武器。**禁止使用** 8K/4K/hyper-realistic/masterpiece 等 AI 标志性词汇。
+
+**原则**：画面不需要清晰度高，风格化 > 写实。低保真的质感反而让超现实内容更可信——观众的潜意识会认为"这是拍到的，不是做出来的"。
+
+## 全局约定
+
+- 所有中间产物存储在 `./.surreal-spot/{project_name}/`
+- **全自动执行**：全程自动，生成失败自动重试（最多 2 次），只在需要用户审批的节点停下
+- **语言**：文案默认中文（跟随用户输入语言），AI 生图 prompt 使用英文
+- **禁止使用 `cd` 命令**
+
+## 工作流程
+
+```
+Surreal Spot Progress:
+
+- [ ] Phase 1: Input Collection & Brand Analysis
+- [ ] Phase 2: TVC Creative Concept ⛔ REQUIRES USER APPROVAL
+- [ ] Phase 3: 9-Grid Storyboard
+- [ ] Phase 4: Motion Video
+- [ ] Phase 5: Final Output (conditional — skip if Phase 4 has audio)
+```
+
+---
+
+## Phase 1: Input Collection & Brand Analysis
+
+### Required Inputs
+
+| Input | Required | Description |
+|-------|----------|-------------|
+| Brand name | Yes | 品牌/产品名称 |
+| Product images | Yes | 1-5 张产品照片 |
+| Brand logo | Recommended | Logo 文件（透明背景 PNG 优先） |
+| Slogan / copy | Optional | 海报上展示的文案 |
+| Style reference | Optional | 风格参考图 / mood board |
+| Use case | Optional | 产品发布 / 活动预告 / 季节推广 / 社媒帖 |
+
+### Flow
+
+1. Collect brand assets from user. If logo is missing, ask once; proceed without if unavailable.
+2. Ask aspect ratio via `AskUserQuestion`: 9:16 / 4:5 / 16:9.
+3. Save all input images: `save_file_to_session(source_path=..., file_type="image")`
+4. Analyze product images: `read_media(file_paths=[...], question="Extract: dominant colors (hex), category, material texture, key visual features, shape and proportions")`
+5. If logo provided: `read_media(file_path=logo, question="Analyze: colors (hex), style (wordmark/icon/combo), has transparency?")`
+6. Generate brand brief and save:
+
+```markdown
+# Brand Visual Brief
+
+Brand: [name]
+Product Category: [category]
+Brand Colors: [hex values]
+Product Texture: [matte / glossy / fabric / metal / glass / organic]
+Product Shape: [compact / elongated / irregular / flat / volumetric]
+Logo Type: [wordmark / icon / combo / none]
+Key Visual Elements: [what to highlight]
+Copy Text: [slogan if provided]
+Style Reference: [description of reference if provided]
+Aspect Ratio: [ratio]
+```
+
+### Validation
+
+```bash
+python3 .claude/skills/surreal-spot/scripts/validate_brief.py .surreal-spot/{project_name}/brief.md
+```
+
+### File
+
+```
+./.surreal-spot/{project_name}/brief.md
+```
+
+---
+
+## Phase 2: TVC Creative Concept ⛔ REQUIRES USER APPROVAL
+
+### Goal
+
+将品牌简报丰富为一条 **TVC 级别的创意广告方案**，包含完整故事线和 9 帧分镜描述。用户审批后进入生图。
+
+### Concept Generation
+
+Load `references/creative-dimensions.md` for the full creative reasoning framework.
+
+**Step 1: Extract 3 creative seeds** from Phase 1 product analysis:
+- **Form**: shape, silhouette, proportions → "what if this form appeared at wrong scale/angle/place?"
+- **Material**: texture, surface, weight, temperature → "what if it was born from / becoming impossible material?"
+- **Function**: use case, user action → "what if this function happened in an absurd context?"
+
+**Step 2: Apply a different creative dimension** to each seed (5 dimensions available):
+1. Physical Impossibility — defy a specific physical law（不限于巨大化——可以是反重力、穿透、分裂、悬浮）
+2. Context Collision — wrong place, everyone acts normal
+3. Temporal Paradox — wrong time scale
+4. Sensory Translation — visualize smell, sound, touch as physical phenomena
+5. Material Metamorphosis — material transforming into/from impossible substance
+
+**约束：3 个 Option 必须使用 3 个不同的创意维度。** 禁止 3 个都用 Physical Impossibility。
+
+**Step 3: Assign a different emotional tone** to each:
+- Playful（玩味）/ Sublime（庄严）/ Provocative（冒犯）
+
+**Each option must differ on at least 2 of 3 axes**: seed × dimension × tone.
+
+### Output Format — 3 Options
+
+Write 3 options, save to `concept_options.md`:
+
+```markdown
+# Creative Concept Options
+
+## Option A: [one-sentence impossible thing]
+
+**Creative Seed**: [Form / Material / Function] — [which product feature]
+**Creative Dimension**: [which dimension]
+**Emotional Tone**: [Playful / Sublime / Provocative]
+**Visual Medium**: [VHS / 16mm Film / Super 8 / Phone Camera / Polaroid / 35mm Film]
+
+**Scene**: [2-3 sentences — the static scene setup（场景反差）— 注意：产品不在开场出现]
+**The Reveal**: [1-2 sentences — 产品以什么方式登场？什么不可能的瞬间？]
+**What Happens**: [2-3 sentences — 环境中发生什么事件/变化（内容反差），产品在事件中扮演什么角色]
+**Conflict**: Setup → Escalation → Payoff → Brand Message
+**Visual Style**: [from photography-styles.md — camera, lens, film stock, imperfections]
+
+---
+## Option B / C: ...
+```
+
+### Style Reference Images
+
+写完 3 个 concept_options 后，为每个 Option 生成 1 张风格参考图，让用户带着视觉直觉做决策。
+
+```
+nano_banana_batch_image_generation_v2(
+  count=3,
+  prompts=["[Option A Scene description — English prompt with camera/lens/film suffix]",
+           "[Option B Scene description — ...]",
+           "[Option C Scene description — ...]"],
+  image_paths=[[product_image], [product_image], [product_image]],
+  aspect_ratios=["[ratio]", "[ratio]", "[ratio]"],
+  model_name="nano_banana_2",
+  resolution="2K"
+)
+```
+
+存为 `style_ref_a.png`, `style_ref_b.png`, `style_ref_c.png`。
+
+### User Approval Gate ⛔
+
+Present 3 options via `AskUserQuestion`，每个选项附带对应的风格参考图路径，让用户同时看到文字描述和视觉效果。If user selects "Other", incorporate feedback and re-present.
+
+### Post-Approval: TVC 创意方案
+
+用户选定方案后，扩展为完整 TVC 方案。Load `references/tvc-concept-template.md` for the full concept.md output format (Scene Breakdown → Cinematic Approach → 9-Frame Keyframes). Load `references/storyboard-rules.md` for detailed keyframe format, shot types, continuity rules.
+
+**流程**：
+1. Scene Breakdown: 拆解 Subject / Environment / Lighting / Visual Anchors
+2. Cinematic Approach: Shot progression + Lens range + Light & color
+3. 9-Frame Keyframes: 每帧 80-120 词 Image Prompt（Composition / Action / Camera+Lens+DoF / Lighting / Grade）
+
+**9 帧分镜检查清单**：
+- [ ] 有 Scene Breakdown（Subject / Environment / Lighting / Visual Anchors）？
+- [ ] 每帧 80-120 词，含 Composition / Action / Camera+Lens+DoF / Lighting / Grade 五要素？
+- [ ] **延迟揭示**：KF1-2 不含产品？KF3 仅暗示？KF4 揭示？
+- [ ] 至少 2 帧产品特写（CU/ECU，含焦距和景深描述）？
+- [ ] Visual Anchors 在所有面板中保持一致？
+- [ ] 相邻帧景别不重复（shot type code 不同）？
+- [ ] 所有帧无正面人脸？Prompt 含 `no visible face`？
+- [ ] 仅 KF9 包含品牌文字（融入场景，使用匹配产品调性的艺术字体）？
+- [ ] 所有 Image Prompt 共享相同的 Visual Medium artifacts？
+- [ ] 附 cinematic aesthetic suffix（from `references/cinematic-aesthetic-prompt.md`）？
+
+### Prompt Construction Rules
+
+Every prompt must include: 1) Surreal scene with specific impossible element 2) Color: `cool desaturated tones, steel gray, off-white, matte black, with [1-2 accent colors]` 3) Composition: `centered, full-frame, [low angle/forced perspective], [aspect ratio]` 4) **Visual Medium anchor**: `[medium-specific keywords + artifacts from references/photography-styles.md]` 5) Quality: `editorial photography, no watermark`
+
+Append cinematic aesthetic suffix from `references/cinematic-aesthetic-prompt.md`.
+
+### Files
+
+```
+./.surreal-spot/{project_name}/
+├── concept_options.md   # 3 options for user review
+├── style_ref_a.png      # style reference for Option A
+├── style_ref_b.png      # style reference for Option B
+├── style_ref_c.png      # style reference for Option C
+└── concept.md           # selected TVC concept with 9-frame storyboard
+```
+
+---
+
+## Phase 3: 9-Grid Storyboard
+
+### Goal
+
+用 Phase 2 选中的风格参考图作为 **hero frame**（产品已锁定在场景中），与产品原图双重引用生成九宫格分镜图，确保产品外形、结构细节、标志性元素完全一致。
+
+### Hero Frame
+
+Phase 2 用户选定的风格参考图（`style_ref_X.png`）即为 hero frame，无需额外生成。该图已以产品原图为参考生成，产品外观已锁定。
+
+### 9-Grid Prompt
+
+将 Phase 2 的 Scene Breakdown + 9 帧 Keyframe 组装为九宫格生成指令。Load `references/storyboard-rules.md` for keyframe format, shot types, continuity rules, and grid requirements.
+
+```
+Generate a 3×3 cinematic storyboard grid (9 panels), left to right, top to bottom.
+Each panel is a keyframe from a surreal product short film.
+
+CONTINUITY RULES (non-negotiable):
+- Same subject appearance, same environment, same lighting style across ALL panels.
+- The product must match the reference images exactly — same shape, structure, color, and all distinctive details.
+- Only action, framing, angle, and camera distance may change between panels.
+- DoF shifts realistically: deep in wide shots, shallow in close-ups.
+- ONE consistent cinematic color grade throughout.
+- Do NOT introduce objects/elements not established in earlier panels.
+
+Style: [Visual Medium keywords + artifacts + cinematic aesthetic suffix]
+Subject: [product — color, material, shape, key features from Scene Breakdown]
+Visual Anchors: [3-6 constants from Scene Breakdown]
+No visible human face in any panel.
+
+Panel 1 [LS]: [KF1 full description, 80-120 words]
+Panel 2 [MS]: [KF2 full description, 80-120 words]
+Panel 3 [MCU]: [KF3 full description, 80-120 words]
+Panel 4 [LS]: [KF4 full description, 80-120 words]
+Panel 5 [CU]: [KF5 full description, 80-120 words]
+Panel 6 [MS]: [KF6 full description, 80-120 words]
+Panel 7 [LS]: [KF7 full description, 80-120 words]
+Panel 8 [ECU]: [KF8 full description, 80-120 words]
+Panel 9 [MS]: [KF9 full description, 80-120 words]
+```
+
+### Step 3: 9-Grid Generation
+
+```
+nano_banana_image_generation(
+  prompt="[9-Grid Prompt — see template above]",
+  image_paths=[style_ref_selected, product_image],
+  aspect_ratio="1:1",
+  model_name="nano_banana_2",
+  resolution="2K"
+)
+```
+
+**双重参考**：选中的风格参考图锁定产品在场景中的外观 + `product_image` 提供产品原始细节。九宫格布局不清晰时 retry 一次。`nano_banana_2` 无法生成清晰九宫格时 fallback 到 `nano_banana`（Gemini Flash）。
+
+**文件大小控制**：生成后检查文件大小，超过 15MB 时用 ffmpeg 压缩（不改变画面内容）：
+
+```
+ffmpeg(args=["-y", "-i", "storyboard_grid.png", "-q:v", "85", "storyboard_grid.jpg"])
+```
+
+压缩后使用 `.jpg` 版本作为后续步骤的输入。
+
+### Quality Gate ⚠️
+
+```
+read_media(
+  file_paths=["storyboard_grid.png", product_image],
+  question="This is a 9-panel storyboard (3×3 grid) and the original product photo. Evaluate: 1) Does the product in panels 4-9 match the original product photo in shape, color, and key details? 2) Are all 9 panels visually distinct? 3) Is there a clear story progression from panel 1→9? 4) Is visual style consistent across panels? 5) Does panel 9 contain brand text? 6) Are panels clearly separated with grid lines? Rate 1-10."
+)
+```
+
+**不合格标准**（触发重新生成）：
+- **产品与原图不一致**（外形/颜色/关键细节偏差）
+- 面板之间无明显视觉差异（同一画面复制感）
+- 产品不可辨识
+- 网格布局不清晰（面板未分隔）
+- 整体质量评分 < 7
+
+### Files
+
+```
+./.surreal-spot/{project_name}/
+└── storyboard_grid.png
+```
+
+---
+
+## Phase 4: Motion Video
+
+### Goal
+
+将九宫格分镜图 + 故事剧本交给 `seedance_multimodal_video`。九宫格提供完整视觉叙事参考，剧本 prompt 讲述连续故事。
+
+### Primary: `seedance_multimodal_video`
+
+```
+seedance_multimodal_video(
+  prompt="[完整故事短片剧本 — 见 references/story-prompt-guide.md]",
+  reference_image_paths=["storyboard_grid.png"],
+  duration=[target duration],
+  ratio="[ratio]",
+  model_name="seedance2.0",
+  generate_audio=true
+)
+```
+
+`reference_image_paths` 传入九宫格分镜图，Seedance 从中理解完整的视觉叙事弧线。
+
+Record whether the video model produced audio → determines Phase 5.
+
+### Story Prompt
+
+Load `references/story-prompt-guide.md` for complete prompt template and checklist.
+
+**速查**：prompt 是完整故事（150-250 词），用 `image 1` 引用九宫格分镜图，只用视觉动词（grows/spreads/cracks），禁止叙事词（realizes/decides）。必须包含 `no visible human face`、产品不变状态声明、**Visual Medium 关键词 + 介质瑕疵**（与九宫格 prompt 一致）。在节拍转换处插入 **1-2 个转场特效**（闪白/数码故障/胶片灼烧等），转场必须匹配 Visual Medium。
+
+### Fallback Chain
+
+`seedance_multimodal_video` with `seedance2.0` 失败时：
+1. `seedance_multimodal_video` with `seedance2.0-fast`
+2. `seedance_image_to_video` with `first_frame_image_path="storyboard_grid.png"`
+3. `kling_video_generation` with `first_frame_image_path="storyboard_grid.png"`, `mode="pro"`, `enable_sound=true`
+4. `video_generation` with `first_frame_images=["storyboard_grid.png"]`
+
+### Files
+
+```
+./.surreal-spot/{project_name}/video/
+└── final_video.mp4
+```
+
+---
+
+## Phase 5: Final Output (conditional)
+
+**Skip entirely if** Phase 4 视频已有音频（Seedance `generate_audio=true` 或 Kling `enable_sound=true`）。直接将 Phase 4 输出复制为 final.mp4。
+
+**Execute if** 视频无音频或音频质量不佳。
+
+### Step 1: BGM (if no audio)
+
+```
+music_generation_with_chat(
+  prompt="[duration+2]s [auto-derived mood], instrumental only, no vocals, clean mix, cinematic",
+  duration=[video_duration + 2]
+)
+```
+
+BGM mood: 运动/潮牌→urban lo-fi, 香水/美妆→ethereal ambient, 科技→retro synthwave, 食品→playful quirky, 配饰→jazz piano, 时尚→cool downtempo.
+
+Embed: `embed_audio_track_to_video(video_path, audio_path, replace_existing=true)`
+
+### Step 2: Trim + Fade (if needed)
+
+```
+ffmpeg(args=["-y", "-i", input, "-t", "{dur}", "-af", "afade=t=out:st={dur-1}:d=1", output])
+```
+
+### Files
+
+```
+./.surreal-spot/{project_name}/output/
+└── final.mp4
+```
+
+---
+
+## Completion
+
+```
+--- Surreal Spot Complete ---
+
+Brand: {brand_name}
+Surreal Concept: {the_impossible_thing}
+Aspect: {ratio}
+
+Output: .surreal-spot/{project_name}/output/final.mp4
+```
+
+---
+
+## Anti-Patterns
+
+Load `references/anti-patterns.md` for full list (organized by 创意/分镜/视频三层).
+
+**Top 5 致命错误**：
+1. **堆砌超现实元素** — 每个视频只能有 ONE 个不可能的事物
+2. **产品从第一帧就出现** — 没有铺垫 = 没有悬念。前 2-3 帧必须是纯环境，产品在 Frame 4 才揭示
+3. **画面太"干净"** — 数码完美感 = AI 感。必须选择 Visual Medium（VHS/16mm/手机等），用介质瑕疵打破完美
+4. **正面人脸** — Seedance 直接拒绝，必须用背影/剪影/物体代替
+5. **模糊的 motion prompt** — 必须极度详细（起点/方向/速度/形态），一句话概括 = 模型乱猜
+
+## Error Handling
+
+| Error | Recovery |
+|-------|----------|
+| Product image too low-res | Run `super_resolution` first |
+| Logo has no transparency | Use `nano_banana_image_generation` to remove background |
+| Storyboard frame looks too "AI" | Re-generate with more imperfection keywords from `references/photography-styles.md` |
+| Product not recognizable | Re-generate 9-grid with stronger product description in Subject field |
+| Storyboard frames inconsistent | N/A — 九宫格一次生成天然统一。如果面板风格不一致，retry 整张九宫格 |
+| Seedance multimodal fails | Fallback: seedance2.0-fast → seedance_image_to_video (frame_1 as first frame) → grid mosaic → Kling pro → Video API |
+| Video audio quality poor | Generate BGM via `music_generation_with_chat` and replace audio track |