Skip to content
Back to search

muse-video

SkillWorks with Claude CodeGitHub

"When the user asks to 策划/构思/设计/写脚本/画分镜 for a video project — e.g. '帮我策划一个广告创意' '这个产品演示视频怎么拍' '帮我写科幻短片的分镜脚本' '给我这个品牌TVC的美术方向'。Not for actual video rendering/compositing or AI image/video generation."

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/luojiangyong--muse-video-skill/badge.svg)](/listings/luojiangyong--muse-video-skill)

HTML

<a href="/listings/luojiangyong--muse-video-skill"><img src="/api/listings/luojiangyong--muse-video-skill/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

本 Skill 采用通用 Agent Skills 格式(`SKILL.md`),任何支持 skills 的 AI Agent 均可装载。

**方式一 · 克隆(总是最新):**

git clone https://github.com/LuoJiangYong/muse-video-skill.git
# 放入所用 Agent 的 skills 目录,例如:
#   Claude Code  → ~/.claude/skills/muse-video/
#   Hermes Agent → ~/.hermes/skills/creative/muse-video/

**方式二 · Hermes Skills Hub:**

hermes skills install muse-video-skill

---

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

SKILL.md · Manifest · 93 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ---
  2. name: muse-video
  3. description: "When the user asks to 策划/构思/设计/写脚本/画分镜 for a video project — e.g. '帮我策划一个广告创意' '这个产品演示视频怎么拍' '帮我写科幻短片的分镜脚本' '给我这个品牌TVC的美术方向'。Not for actual video rendering/compositing or AI image/video generation."
  4. version: 0.36.7
  5. author: Hermes Agent + 钱多多
  6. license: MIT
  7. platforms: [linux, macos, windows]
  8. metadata:
  9. hermes:
  10. tags: [video, creative, pre-production, storyboard, script, art-direction, filmmaking]
  11. related_skills: [hyperframes, comfyui, infographic-carousel]
  12. ---
  13. # Muse Video — AI 视频前期策划引擎
  14. > **定位**:产出 Creative Package(剧本 + 分镜 + 美术 + 提示词),由用户导入下游工具制作。
  15. > **不做**:实际视频渲染、AI 生图/生视频。如有 HyperFrames/ComfyUI 等下游工具可对接;如无,产出策划案供手动制作。
  16. > **宪法**:加载 `CONSTITUTION.md` 了解 5 条设计原则 + 数据流 + 禁止模式。
  17. ## 路由决策树
  18. ```
  19. 用户请求视频相关创作
  20. │
  21. ├─ "我做了一个视频,帮我修改/加特效/加字幕" → 这不是本 Skill。如已配置 HyperFrames 等视频合成工具可路由;否则告知用户本 Skill 产出分镜脚本供参考。
  22. ├─ "帮我生成一个视频/图片" → 这不是本 Skill。如已配置 ComfyUI/image_gen 可在视觉阶段按需调用;否则用文字描述替代。
  23. │
  24. └─ "帮我策划/设计/构思一个视频" → ✅ 激活本 Skill
  25. │
  26. ├─ 用户提供参考视频(本地文件 / 可下载 URL)?
  27. │ → 触发 Phase 1 拆解子流程(见 default.md §Phase 1 步骤 2.5)
  28. │ → 逐镜头拆解为拉片表 → 用户校准 → 聚合为技法摘要
  29. │ → 技法摘要写入 Project State,后续角色直接消费
  30. │ → 下载失败:告警 + 问替代方案,不降级不猜测
  31. │
  32. ├─ 用户提到具体案例/风格?
  33. │ → 加载 references/cases/INDEX.md
  34. │ → 匹配案例 → 加载 references/cases/<id>.md
  35. │
  36. ├─ 检测场景类型(关键词匹配):
  37. │ studio-ad: "广告/棚拍/TVC/品牌片"
  38. │ logo-animation: "LOGO/片头/品牌演绎/动画"
  39. │ product-demo: "产品/演示/功能介绍/开箱"
  40. │ sci-fi: "科幻/Cyberpunk/未来/赛博"
  41. │ custom: 无匹配 → 用通用流程
  42. │ 新增场景类型 → references/scenes/_TEMPLATE.md
  43. │
  44. └─ 检测复杂度:
  45. 1-2 场景 / 无角色 / 用户催快 → fast-track 管线
  46. 多场景 / 有角色 / 需要深度策划 → default 管线
  47. ```
  48. ## 管线激活
  49. ### Default Pipeline(8 阶段 + 1 预留,完整创作)
  50. 1. **需求沟通**(Director)→ 确认比例/用途/场景/约束
  51. 2. **内容梳理**(Writer + Director)→ 故事、场景、叙事结构
  52. 3. **视觉开发**(Art Director + Director)→ 色调、风格、场景搭建、人物设定。含反主观化规则:情绪标签映射 visual_cause 字段(见 `references/roles/art-director.md`)
  53. 3.5 **风格定样**(条件性)→ 生图前先选模型(`references/image-gen-routing.md`)→ image_gen 生成场景 moodboard + 角色概念图 → 用户看图确认 → 锁定风格方向。不可用时跳过
  54. 4. **脚本**(Writer → DP → Director review)→ 台词、镜头语言、动作、时长
  55. 5. **声音方向**(Sound Designer)→ 配乐风格、音效、旁白基调
  56. 6. **分镜**(Storyboard Assembly)→ 6/9 宫格分镜 + 显式询问用户是否调用 image_gen 生成分镜图 + 可选实景参考图获取(`references/free-image-sources.md`);生成产物登记顶层 `file_registry`
  57. 7. **组装+调优**(Director)→ `prompt_assembler.py` 产出 Creative Pack → HTML storyboard 确认门禁(四选项 + 默认,唯一最终确认关卡)。参考图经顶层 `file_registry` 全链引用(不转述),确认即锁定
  58. 7.5 **模型编译**(Model Compiler)→ 编译前先选模型(Phase 7 子步骤 6.5);Creative Package 编译为模型调用指令(六段式 prompt + 多模态引用 + arkcli 命令 + 成本估算),导出编译预览 HTML 供用户二次确认。已适配 Seedance 2.0
  59. 8 **下游工具引导**(预留)→ 工具选择与费用预估(不执行,建设时遵循「机场指示牌」原则)
  60. **每阶段**:角色产出 → Director 审核。通过 → 下一阶段。修改 ≤2 轮。拒绝 → 重启该阶段。
  61. **角色文件**:按需加载 `references/roles/<name>.md`,不一次全载入。
  62. ### Fast-Track Pipeline(简化版)
  63. 合并阶段 2+3+4 → 一稿过,跳过 Director 多轮审核。仅适用于简单需求。
  64. ## 案例引用
  65. > 案例匹配 → 加载 `references/cases/INDEX.md`。新增案例 → `references/cases/_TEMPLATE.md`。索引由 `scripts/build_index.py` 自动生成,禁止手动编辑 INDEX.md。
  66. ## 导出格式
  67. `scripts/export_html.py` → 文学剧本 HTML(Courier 标准格式)/ 分镜展示 HTML(卡片网格)/ 编译预览 HTML(`--literary` / `--storyboard` / `--compilation`)
  68. `scripts/export_xlsx.py` → 分镜技术表 Excel(镜号/景别/运动/灯光/VFX)
  69. 用户说"导出剧本/分镜表" → 自动触发对应脚本。
  70. ## 下游对接
  71. > 产出 Creative Package 后,按 `references/downstream-integration.md` 对接下游工具(HyperFrames / ComfyUI / Kling / 火山引擎 / etc.)。
  72. ## INDEX.md 自动化
  73. > 见 `CONSTITUTION.md` §元数据治理。`build_index.py --check` 校验,`--write` 重新生成。禁止手动编辑。
  74. ## 产出验证
  75. > 见 `references/meta/verification-checklist.md`。
README.md · README · 223 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. **简体中文** | [English](README.en.md)
  2. # Muse Video — 视频创作虚拟剧组引擎
  3. 产出一个视频开拍前需要的全部策划案:剧本、分镜、美术方向、提示词,并编译成下游视频模型可直接执行的调用指令。38 个标杆案例技法库 × 六角色协作,做你的「虚拟剧组」。
  4. > Virtual film-crew engine for video creation — idea → script, storyboard, art direction, prompts → model-ready call instructions. 38-case technique library × six-role crew × end-to-end review gates.
  5. > 状态:开发中 | 通用 Agent Skills 格式(适配任何支持 skills 的 AI Agent)
  6. ---
  7. ## 解决什么问题
  8. | 痛点 | Muse Video 怎么做 |
  9. |------|------------------|
  10. | 有创意但不会写专业分镜脚本 | 好莱坞格式剧本 + 6/9 宫格分镜 + 技术表——文学剧本 / 分镜卡片 / 编译预览 / 技术表四种成品一键导出 |
  11. | 想做某个风格但说不清楚 | 38 个标杆案例技法库——说「参考 Apple 1984」比描述「反乌托邦蓝灰色调」快 10 倍 |
  12. | 策划来回改、改完还是散 | 8+1 阶段管线,每阶段 Director 审核 ≤2 轮,产出全程 `_meta` 可追溯 |
  13. | 策划案再好,下游模型用不起来 | Phase 7.5 模型编译:六段式 prompt + 多模态参考图映射 + 调用命令 + 成本估算(已适配 Seedance 2.0)|
  14. | 参考图满天飞、对不上号 | 参考图引用链 + 资产化(人物 / 产品主体 / 关键分镜 / 关键道具)——按资产 ID 全链引用,不转述 |
  15. ---
  16. ## 怎么用
  17. 在任何支持 Agent Skills 的 AI Agent 中,像这样说话:
  18. ```
  19. 帮我策划一个产品广告,风格参考 Apple Don't Blink
  20. ```
  21. ```
  22. 帮我构思科幻短片的故事板,想要银翼杀手那种巨物美学
  23. ```
  24. Agent 会自动匹配案例技法 → 注入角色 prompt → 走管线 → 导出 Creative Package。
  25. ---
  26. ## 产出长什么样
  27. | 组成 | 内容 |
  28. |------|------|
  29. | 剧本 | 场景 / 对白 / 动作 / 镜头语言(文学剧本 HTML 导出,Courier 标准格式)|
  30. | 分镜 | 6/9 宫格分镜卡片:描述 / 机位 / 灯光 / 美术 / VFX / 生图 prompt |
  31. | 美术方向 | 色调板(hex + 成因字段)+ 风格参考 + 场景构成 + 角色设定 |
  32. | 提示词 | 每格分镜的 image_prompt、全片 video prompt 素材 |
  33. | 字幕层 | 文案(中 / 英 / 双语)× 字体族 × 位置——与画面 prompt 解耦,编译为烧录 spec |
  34. | 音频路线 | 配乐 / 配音 / 音效的路线选择 + 生成 brief(解耦,不代生成)|
  35. | 模型调用指令 | Phase 7.5 编译:六段式 prompt + 多模态引用 + arkcli 命令 + 成本估算 + 下游工具配置(ComfyUI / HyperFrames / Kling)|
  36. 完整成品见 [`assets/examples/`](assets/examples/)——科幻短片与棚拍广告两个全流程示例(含 HTML / Excel 导出)。真实项目的完整实测见下方「项目实测」。
  37. ---
  38. ## 实测成片
  39. > 以下为实拍成片的 GIF 预览(静音循环);点击观看 MP4 原片(浏览器直接播放,S2 / S3 含立体声)。
  40. [![S1 · 镜头3 — 棚拍微距](docs/images/renders-01-s1-p3.gif)](https://luojiangyong.com/muse-video-skill/docs/preview/guangdong-slipper/renders/s1/shot_p3.mp4)
  41. **S1 · 镜头3 — 棚拍微距** — 红色人字拖的琉璃质感与琥珀棚拍光
  42. [![S2 · 镜头5 — 设计呈现](docs/images/renders-02-s2-p5.gif)](https://luojiangyong.com/muse-video-skill/docs/preview/guangdong-slipper/renders/s2/shot_p5.mp4)
  43. **S2 · 镜头5 — 设计呈现** — 技术图纸上的红 / 白 / 绿三色设计稿
  44. [![S3 · 镜头10 — 海边微距](docs/images/renders-03-s3-p10.gif)](https://luojiangyong.com/muse-video-skill/docs/preview/guangdong-slipper/renders/s3/shot_p10.mp4)
  45. **S3 · 镜头10 — 海边微距** — 金色时刻逆光与砂砾质感
  46. ---
  47. ## 项目实测
  48. > 以下 6 张实拍截图来自一次完整的 8+1 阶段管线实测——90 秒棚拍广告《把广东省拖拍成奢侈品大片》:从参考视频拆解(Phase 1)到模型编译(Phase 7.5),全部由本 Skill 产出。点击 01–04、06 可在浏览器中打开完整页面。
  49. [![分镜总览](docs/images/gallery-01-storyboard-overview.jpg)](https://luojiangyong.com/muse-video-skill/docs/preview/guangdong-slipper/exports/storyboard.html)
  50. **01 · 分镜总览** — 19 镜 3×3 分镜网格;每格携带画面 / 描述 / 字幕 / 机位 / VFX / 审核状态
  51. [![分镜中段](docs/images/gallery-02-storyboard-panels.jpg)](https://luojiangyong.com/muse-video-skill/docs/preview/guangdong-slipper/exports/storyboard.html)
  52. **02 · 分镜中段** — 微距 / 人物 / 街景多类型镜头,画面与描述层延续
  53. [![编译预览](docs/images/gallery-03-compilation-preview.jpg)](https://luojiangyong.com/muse-video-skill/docs/preview/guangdong-slipper/exports/compilation-preview.html)
  54. **03 · 编译预览(Phase 7.5)** — 六段式 prompt / 多模态引用映射(首帧 · 尾帧 · image_ref)/ arkcli 命令 / 成本估算(19 镜可逐镜展开核对)
  55. [![文学剧本](docs/images/gallery-04-script-literary.jpg)](https://luojiangyong.com/muse-video-skill/docs/preview/guangdong-slipper/exports/script-literary.html)
  56. **04 · 文学剧本** — 好莱坞 Courier 标准格式:标题页(Logline + 导演阐述)+ 场景与旁白
  57. ![成片封面](docs/images/gallery-05-covers.jpg)
  58. **05 · 成片封面** — Seedream 生成的竖版 / 横版双封面
  59. [![参考视频拆解](docs/images/gallery-06-reference-deconstruction.jpg)](https://luojiangyong.com/muse-video-skill/docs/preview/guangdong-slipper/reference/shotlist_v1.html)
  60. **06 · 参考视频拆解(Phase 1)** — 拉片表:80 帧逐镜拆解(镜头 / 光影 / 运镜 / 节奏 / 声音 / 字幕 / 技法);技法摘要注入后续角色
  61. ---
  62. ## 工作流
  63. ```
  64. 用户描述想法
  65. │
  66. ├─ 路由决策树 → 判场景类型(4 种模板 + 自定义)与复杂度
  67. ├─ 加载匹配案例技法 → 注入对应角色 prompt
  68. ├─ 8+1 阶段管线推进(角色产出 → Director 审核 → 下一阶段)
  69. └─ 导出 Creative Package → 下游工具对接
  70. ```
  71. - **六角色虚拟剧组**:Director(导演)/ Writer(编剧)/ DP(摄影)/ Art Director(美术)/ VFX(特效)/ Sound Designer(声音)——每角色独立文档,按需加载
  72. - **两条管线**:Default(8 阶段 + 1 预留,完整创作)/ Fast-Track(合并阶段,简单需求一稿过)
  73. - **四种场景模板**:棚拍广告 / 产品演示 / LOGO 演绎 / 科幻设定——可扩展自定义
  74. **不做**:视频渲染/合成、AI 生图/生视频——本 Skill 产出策划案与调用指令,实际生成交给下游工具(HyperFrames / ComfyUI / Kling / 火山引擎 等)。
  75. ---
  76. ## 门禁 / 确认环节
  77. | 触发点 | 你的动作 | 默认 |
  78. |--------|---------|------|
  79. | Phase 3.5 风格定样 | 看图确认色调 / 风格方向 | image_gen 不可用时跳过 |
  80. | Phase 3.5 资产生成门禁 | 决定关键资产(人物 / 产品)是否生成、生成范围 | 先出候选清单再询问 |
  81. | Phase 6 分镜 | 决定是否调用 image_gen 生成分镜图 | 显式询问 |
  82. | Phase 7 HTML 分镜 | **唯一最终确认关卡**:确认即锁定(四选项 + 默认)| 逐项核对后确认 |
  83. | Phase 7.5 编译预览 | 二次确认模型调用指令(含音频模型引导)| 导出编译预览 HTML 核对 |
  84. ---
  85. ## 案例库
  86. 38 个标杆案例,按角色维度建六组技法交叉索引(叙事 / 镜头 / 色彩美术 / 特效 / 声音 / 创意广告):
  87. | 类型 | 数量 | 代表 |
  88. |------|------|------|
  89. | 商业广告 | 25 | Apple 1984 / Guinness Surfer / Honda Cog / Sony Balls |
  90. | 电影 | 4 | 银翼杀手 2049 / 花样年华 / 流浪地球 / 环太平洋 |
  91. | LOGO 演绎 | 3 | NIO 十周年 / Apple Event 合集 / Pixar Luxo Jr. |
  92. | 短片 | 2 | ACHROMA / Cosmos Laundromat |
  93. | 其他 | 4 | Piper(动画)/ Koyaanisqatsi(纪录片)/ Machine Hallucination(实验)/ The One Moment(MV)|
  94. > 完整注册表 + 技法交叉索引 → [`references/cases/INDEX.md`](references/cases/INDEX.md)
  95. ---
  96. ## 目录结构
  97. ```
  98. muse-video-skill/
  99. ├── SKILL.md ← 路由中枢(入口)
  100. ├── CONSTITUTION.md ← 设计宪法(5 条原则 + 数据流 + 禁止模式)
  101. ├── README.md / README.en.md ← 项目页(中文 / English)
  102. ├── LICENSE ← MIT
  103. ├── .github/workflows/ ← CI 质量门(语法 / 索引 / 契约)
  104. ├── docs/ ← 项目实测画廊(实拍截图 + Pages 在线预览包)
  105. ├── references/ ← 领域知识(按需加载)
  106. │ ├── cases/ ← 38 标杆案例 + 索引 + 案例帧素材
  107. │ ├── roles/ ← 6 角色文档
  108. │ ├── scenes/ ← 4 场景模板 + 新场景模板
  109. │ ├── pipelines/ ← 2 管线(default / fast-track)
  110. │ └── media/ · meta/ · *.md ← 生图知识 / 验证清单 / 路由与编译文档
  111. ├── scripts/ ← 9 个确定性脚本(索引 / 校验 / 组装 / 导出)
  112. ├── assets/
  113. │ ├── schemas/ ← Project State JSON Schema(角色间唯一接口)
  114. │ ├── templates/ ← 剧本 / 分镜 / 导出模板(4 种导出格式)
  115. │ └── examples/ ← 2 个全流程示例(含成品导出)
  116. └── metadata/ ← fields.yaml / phase_gates.yaml / CHANGELOG
  117. ```
  118. ---
  119. ## 安装
  120. 本 Skill 采用通用 Agent Skills 格式(`SKILL.md`),任何支持 skills 的 AI Agent 均可装载。
  121. **方式一 · 克隆(总是最新):**
  122. ```bash
  123. git clone https://github.com/LuoJiangYong/muse-video-skill.git
  124. # 放入所用 Agent 的 skills 目录,例如:
  125. # Claude Code → ~/.claude/skills/muse-video/
  126. # Hermes Agent → ~/.hermes/skills/creative/muse-video/
  127. ```
  128. **方式二 · Hermes Skills Hub:**
  129. ```bash
  130. hermes skills install muse-video-skill
  131. ```
  132. ---
  133. ## 开发自检
  134. ```bash
  135. python scripts/build_index.py --check --deps # 索引完整性 + 死链检查(期望 0 errors)
  136. python scripts/inventory.py --json # 文件级盘点(按角色分类)
  137. python scripts/validate_state.py --input <project-state.json> --phase 7 # 阶段门禁校验
  138. python -m py_compile scripts/*.py # 全脚本可编译
  139. ```
  140. ---
  141. ## 来源与致谢
  142. 案例库收录的影视作品与广告均标注作品与创作者,技法拆解仅用于学习研究;商标与影像版权归各自权利人所有。
  143. ---
  144. ## 许可证
  145. [MIT](LICENSE) © 2026 Jiang Yong Luo
  146. ---
  147. ## 版本
  148. [v0.36.7](metadata/CHANGELOG.md) — 实测成片(3 段渲染镜头 GIF 内联 / MP4 在线播放)+ 项目实测画廊(截图与页面预览);38 案例技法库 × 六角色 × 8+1 阶段管线,参考图资产化 / 字幕层 / 音频路线 / 模型编译(Seedance 2.0)。

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.