Skip to content
Back to search

reference-first-motion-director

Reference-first Codex workflow for edit planning, keyframe approval, and MiniMax H3 prompts.

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/work-fisher--reference-first-motion-director/badge.svg)](/listings/work-fisher--reference-first-motion-director)

HTML

<a href="/listings/work-fisher--reference-first-motion-director"><img src="/api/listings/work-fisher--reference-first-motion-director/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.

推荐直接在 Codex 中输入:

使用 $skill-installer 安装这个 Skill:
https://github.com/Work-Fisher/reference-first-motion-director/tree/main/reference-first-motion-director

也可以克隆仓库后,把 [`reference-first-motion-director`](reference-first-motion-director/) 目录复制到:

$HOME/.agents/skills/reference-first-motion-director

安装后重新打开 Codex 任务,调用:

$reference-first-motion-director

示例请求:

使用 $reference-first-motion-director 分析这份完整口播脚本。
先保存整片视觉总表,再把需要单独制作的动效清单给我确认;
确认后从参考库找精确案例,逐项生成严格 2K 完成图,再输出按内容定时的 AI 视频提示词。

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.

README.md · README · 135 lines

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

  1. # Reference-first Motion Director
  2. ![Codex Skill](https://img.shields.io/badge/Codex-Skill-111827)
  3. ![Python](https://img.shields.io/badge/Python-%3E%3D3.10-3776AB?logo=python&logoColor=white)
  4. ![License](https://img.shields.io/badge/license-MIT-16A34A)
  5. ![Media License](https://img.shields.io/badge/media-CC%20BY--NC%204.0-2563EB)
  6. > 参考先行的整片视觉导演工作流:先锁定全片职责与动效清单,再检索参考,逐项交付一张严格 2048×1152 的成片级参考图和一条按内容定时的 AI 视频提示词。
  7. ![参考先行动态视觉导演](reference-first-motion-director/assets/library-preview/library-cover.svg)
  8. 它不是“每句话都生成一张人物图”的提示词模板。它先判断哪里应该使用人物、真实证据、录屏、现有素材、动态包装或生成镜头,再只制作真正需要独立设计的动效。
  9. ## 核心流程
  10. ```mermaid
  11. flowchart LR
  12. A[完整脚本 / SRT / 文案] --> B[visual-master-plan.md]
  13. B --> C[motion-production-queue.md]
  14. C --> D[精确检索本地或随包参考]
  15. D --> E[final-video-reference 成片级参考图]
  16. E --> F[真实像素验收 2048×1152]
  17. F --> G[按内容路由时长]
  18. G --> H[AI 视频提示词]
  19. ```
  20. - **整片优先**:先保存完整视觉总表,避免被上一张图或最近上下文带偏。
  21. - **清单优先**:从总表派生动效制作清单,先让用户确认真正需要制作的内容。
  22. - **证据优先**:真实页面、作品、录屏和现有素材优先于抽象包装。
  23. - **参考可追溯**:分别绑定色彩/材质、构图/字体和运动/镜头参考,不复制品牌、原文案或完整布局。
  24. - **单张完成图**:默认只交付一张接近成片的 `final-video-reference`,文字或 UI 需要参与构图时直接在图中完成。
  25. - **真实 2K 验收**:读取文件真实像素;不足时保留源图并高质量重采样到 2048×1152,内容失真则重新生成。
  26. - **内容决定时长**:根据事件数量、阅读负担与模型档位选择时长,再编译 I2VA、L2VA、FL2VA、Ref2VA 或 T2VA 提示词。
  27. ## 安装
  28. 推荐直接在 Codex 中输入:
  29. ```text
  30. 使用 $skill-installer 安装这个 Skill:
  31. https://github.com/Work-Fisher/reference-first-motion-director/tree/main/reference-first-motion-director
  32. ```
  33. 也可以克隆仓库后,把 [`reference-first-motion-director`](reference-first-motion-director/) 目录复制到:
  34. ```text
  35. $HOME/.agents/skills/reference-first-motion-director
  36. ```
  37. 安装后重新打开 Codex 任务,调用:
  38. ```text
  39. $reference-first-motion-director
  40. ```
  41. 示例请求:
  42. ```text
  43. 使用 $reference-first-motion-director 分析这份完整口播脚本。
  44. 先保存整片视觉总表,再把需要单独制作的动效清单给我确认;
  45. 确认后从参考库找精确案例,逐项生成严格 2K 完成图,再输出按内容定时的 AI 视频提示词。
  46. ```
  47. ## 开箱可用的 starter library
  48. 不配置本机素材路径也能检索 4 支原创轻量案例和对应的 12 帧联络表。四支案例全部由仓库内可复现的 Python 源码以纯矢量图元逐帧渲染:
  49. | 模式 | 预览 | 学习机制 | 视频 |
  50. |---|---|---|---|
  51. | M02 | ![信号配色状态切换](reference-first-motion-director/assets/starter-library/previews/signal-palette-switch.jpg) | 固定构图、单变量换色、状态索引 | [MP4](reference-first-motion-director/assets/starter-library/clips/signal-palette-switch.mp4) |
  52. | M03 | ![模块化构图组装](reference-first-motion-director/assets/starter-library/previews/modular-assembly-sequence.jpg) | 矢量模块依次进入、锁定、完成态 | [MP4](reference-first-motion-director/assets/starter-library/clips/modular-assembly-sequence.mp4) |
  53. | M05 | ![编辑式章节标题栈](reference-first-motion-director/assets/starter-library/previews/editorial-section-stack.jpg) | 导线、描边显影、实字收束 | [MP4](reference-first-motion-director/assets/starter-library/clips/editorial-section-stack.mp4) |
  54. | M10 | ![节拍式标题钉合](reference-first-motion-director/assets/starter-library/previews/kinetic-title-lockup.jpg) | 方向对撞、斜切、编号钉合 | [MP4](reference-first-motion-director/assets/starter-library/clips/kinetic-title-lockup.mp4) |
  55. 这些案例用于学习信息关系、注意力顺序、色彩行为和运动规律,不是要求复制演示文案或完整布局。
  56. 正常检索和预览不需要重渲染;只有复现这些公开资产时才需要 Pillow 与 FFmpeg。
  57. ## 创作者随包参考库
  58. 除了 4 支纯代码 starter,Skill 还随包提供 48 项由 Work-Fisher 授权公开分发的视觉参考:33 张图片、15 支视频和逐支 12 帧联络表。无需配置本机路径即可检索色彩、构图、字体、材质和运动机制。
  59. ![48 项创作者参考总览](reference-first-motion-director/assets/creator-reference-library/overview.jpg)
  60. 公开副本使用哈希文件名,已移除本机路径、原始文件名和可移除元数据。媒体与描述索引采用 [`CC BY-NC 4.0`](reference-first-motion-director/assets/creator-reference-library/LICENSE.md),完整数量、来源声明和隐私处理见 [`manifest.json`](reference-first-motion-director/assets/creator-reference-library/manifest.json)。
  61. ## 参考库命令
  62. 从技能目录运行:
  63. ```powershell
  64. python -X utf8 scripts/reference_library.py status
  65. python -X utf8 scripts/reference_library.py search --query "章节 标题"
  66. python -X utf8 scripts/reference_library.py preview --asset-id cbb79775b708 --frames 12
  67. ```
  68. 上面三条命令无需配置即可使用 48 项创作者参考与 4 项 starter 案例。需要接入自己的主知识库和增量素材库时:
  69. ```powershell
  70. python -X utf8 scripts/reference_library.py configure `
  71. --reference-library "<reference-library>" `
  72. --primary-learning-root "<learning-root>"
  73. ```
  74. 个人视频需要生成新联络表时,系统还需可调用 `ffmpeg` 和 `ffprobe`。个人路径写入用户目录下的本机配置,不进入 SKILL 或仓库。
  75. ## 输出文件
  76. | 文件 | 作用 |
  77. |---|---|
  78. | `visual-master-plan.md` | 全片唯一视觉真源,记录时间、职责、证据、表现形态、制作层和状态 |
  79. | `motion-production-queue.md` | 从总表派生的动效制作视图,每个 `FXxx` 回链总表 |
  80. | `final-video-reference` | 一张经过真实像素验收的 2048×1152 PNG 成片级参考图 |
  81. | AI video prompt | 标明原视频覆盖时间,并按内容关系与事件数量选择时长的视频提示词 |
  82. 若具体模型要求精确首尾帧,工作流可以在内部准备与完成图空间对齐的干净输入帧;这属于模型输入要求,不增加默认用户交付数量。
  83. ## 边界
  84. - 仓库不包含未授权个人素材、本机绝对路径、原始文件名、字幕或逐秒拆帧;创作者随包媒体有独立权利声明和许可证。
  85. - 新参考只在用户有权持有时进入个人库;保存参考不代表获得再分发权。
  86. - SKILL 负责整片规划、参考检索、关键静帧流程和提示词编译,不声称自动生成最终视频。
  87. - 随包 starter library 的逐项来源与排除边界记录在 [`manifest.json`](reference-first-motion-director/assets/starter-library/manifest.json),完整画面可由 [`render_original_starter_library.py`](reference-first-motion-director/assets/starter-library/source/render_original_starter_library.py) 重新生成。仓库全部公开视觉资产另见 [`ASSET_PROVENANCE.md`](ASSET_PROVENANCE.md)。
  88. ## 验证
  89. ```powershell
  90. python -m unittest discover -s reference-first-motion-director/scripts/tests -p "test_*.py" -v
  91. python reference-first-motion-director/scripts/reference_library.py status
  92. python reference-first-motion-director/scripts/ensure_2k.py "<source.png>" --output "<final-2K.png>"
  93. ```
  94. ## License
  95. Skill 指令与代码采用 [MIT](LICENSE)。`assets/creator-reference-library/` 中的媒体、预览、总览图和描述索引采用 [CC BY-NC 4.0](reference-first-motion-director/assets/creator-reference-library/LICENSE.md)。

Ratings and comments

Sign in to rate this skill.

Sign in

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