把重复任务、短视频剪辑流程、HyperFrames / Remotion 视频生产管线，整理成 Codex 可以反复执行的 Skill。
这个仓库来自三篇 X 长文的方法论蒸馏，最终沉淀为一个可安装的 Codex Skill：codex-workflow-builder。它不是普通教程摘要，而是一个面向真实执行的工作流设计器：当你有一个模糊但反复发生的任务时，它会帮你把目标、输入、输出、目录、步骤、检查点、封装方式全部整理清楚。
- 5分钟入门Codex，一个工作流在抖音赚了5W+
- Codex自动化剪辑从0到1，开源我在抖音赚了5W+的剪辑工作流【万字长文】
- Codex + HyperFrames 自动剪辑视频：深度技术解析与工程化最佳实践
很多人使用 Codex 时，容易停留在「问一句，答一句」的模式。但现实工作里，真正有价值的事情往往不是单次问答，而是可重复的流程：
- 每天整理 AI 资讯，生成选题 Brief
- 每周整理数据，输出周报
- 按固定结构写公众号、小红书、短视频脚本
- 用参考视频和素材库批量生成带货短视频草稿
- 把文章、PDF、README 做成带字幕和动效的视频
- 把讲书号、数据科普、工具教程、产品讲解做成日更视频生产线
- 把一个已经跑通的复杂流程封装成 Skill 或自动任务
codex-workflow-builder 的作用，就是把这些「说不清、但经常做」的任务，拆成 Codex 能稳定执行的工作流。
适用于日报、周报、内容生产、资料整理、业务流程等场景。
它会输出：
- 工作流目标
- 触发条件
- 输入材料
- 输出结果
- 项目目录结构
- 执行步骤
- 人工检查点
- 质量标准
- 停止条件
- 是否适合进一步封装成 Skill 或自动任务
典型产物是一个清晰的 Workflow Contract：
## Workflow Contract
- Goal:
- Trigger:
- Inputs:
- Outputs:
- Project folder:
- Steps:
- Human review points:
- Quality checks:
- Stop conditions:适用于电商带货、营销混剪、产品视频、轻量 Vlog、批量短视频生产。
它会把流程拆成：
- 准备参考视频和素材库
- 拆解参考视频镜头
- 提取关键帧
- 生成
recipe.json - 分析每个镜头需要什么素材
- 生成
fragment_plan.json - 从素材库匹配合适素材
- 生成
matches.json - 标记低置信度素材位
- 生成配音和字幕
- 对齐画面、配音、字幕
- 生成预览
- 生成剪映 / CapCut 可编辑草稿
这条路线的关键原则是：
宁可留空素材，也不要用无关素材硬凑。
如果某个镜头没有合适素材，Skill 会要求标记为 missing_asset，并告诉你应该补充什么类型的素材，而不是为了填满时间线强行选择不相关内容。
适用于文章转视频、PDF 转视频、README 讲解视频、产品介绍、信息图卡、字幕动效、界面演示、教程类视频。
这条路线的核心分工是：
- Codex 负责：编排、写代码、分镜、字幕、审阅闭环
- HyperFrames 负责：把 HTML / CSS / JavaScript 合成为确定性的 MP4
它会设计完整管线：
Design -> Script -> Storyboard -> HTML Review Page -> Timeline Preview -> Validate -> Render
并补齐这些工程步骤：
- 初始化 HyperFrames 项目
- 组织
assets/ - 明确视频时长、比例、风格和关键元素
- 编写 HTML 分镜页面
- 根据字幕时间线安排动效
- 预览画面
- 校验合成结构
- 检查素材路径
- 渲染 MP4
- 输出可复现的视频产物
它特别适合浏览器可以表达的内容：字幕、图表、截图、产品页、UI 演示、动效图卡、下三分之一字幕条、数据动画。
这一版不再只有“调用工具 → 输出视频”的 SOP。视频任务会先生成一份 Production Configuration，明确内容格式、风格预设、事实来源、脚本模板、镜头 ID 和参考资产，再进入分镜、预览和渲染。
codex-workflow-builder/
├── scripts/ # 可组合基础骨架与项目脚本模板
├── prompts/ # TikTok、AI 演示、产品、开箱、新闻、B-roll、生成式视频
├── styles/ # Apple、Tesla、Bloomberg、Cyberpunk、Minimal 预设
├── references/ # 设计语言、镜头库、动效、生成式视频、参考图、分镜和视频接入规范
├── examples/ # 输入 → 配置 → 分镜 → 最终帧/生成资产计划的 Few-shot 示例
├── remotion/ # 可交给真实 Remotion 工程的生产合同
└── tests/ # 生产资料与运行时路由的回归测试
仓库还包含一个实际可运行的最小生产线：
examples/remotion-starter/
├── src/ # typed content、Root 和可复用 composition
├── scripts/ # still/MP4 产物签名检查
├── package-lock.json # 可复现依赖
└── outputs/ # 已验证的首帧 PNG 与短 MP4 证据
它不是只写流程的示意：在本地或 CI 中会真实执行 typecheck、still frame、H.264 smoke render 和二进制产物检查。
每条视频必须选择一个风格预设。预设锁定字体、配色、动画节奏、留白、UI 层级和转场词汇；其它设计类 Skill 不能静默覆盖它。只有用户明确更换预设，才重新审查所有场景。
预设名描述的是可迁移的设计特征，不复制品牌的 logo、界面、广告画面、素材或字体。默认使用 minimal；新闻可选择 bloomberg，产品可选择 apple，工程性能内容可选择 tesla，技术系统才使用 cyberpunk。
scripts/固定开场、叙事、收尾和字幕的作用，并提供 AI 演示、产品发布、开箱、新闻解释、TikTok/Shorts、B-roll、教程、案例复盘、对比选型和趋势观点等项目模板。prompts/覆盖 TikTok、AI 产品演示、产品介绍、开箱、新闻播报、B-roll 和生成式视频；每份都要求镜头、时长、事实来源与缺失素材处理。references/shot-library.md提供可直接写进分镜的镜头 ID、构图和时长。
这些模板不是封闭范围。新题材先选最接近的项目模板，再与开场、叙事、收尾和字幕骨架组合；没有完全对应的模板时，写出可审查的 custom beat map，而不是退回成泛泛的旁白。
融合 zhouwei713/seedance-prompt 的 MIT 方法后，缺少关键画面时可把生成式视频当作受控资产路线：先定义素材身份（谁、为何、设备/年代）、设备物理特征、自然失误、时间轴、音画关系和收束，再生成可投喂的 prompt。
它不会替代真实素材，也不会把 prompt、缩略图或设想的画面写成已交付视频。多段生成必须有 Continuity Ledger 锁定人物、地点、时间、相机语法、声音和首末帧锚点；选择的 style_preset 继续控制成片的版式、字幕和转场。
prompts/generative-video.md：七段式模型提示词与资产状态记录。references/generative-video-production.md：来源身份、设备语法、自然事件、连续性账本和 QA 门。examples/generative-video-sequence.md：从用户授权实拍到生成 B-roll 的完整 Few-shot，明确标为not_rendered。
仓库内包含自制的 9:16 安全区图、AI 演示/新闻分镜图、构图与动效示例，以及外部参考视频的授权接入规范。它们提供可见的版式、节奏和阅读路径；外部视频、截图和音乐必须由用户提供授权来源，不能被复制进最终视频。
这是本仓库自制的静态最终帧参考，不宣称已经渲染为 MP4；真正的预览与最终文件仍需由实际项目的验证/渲染命令产生。
本仓库的真实渲染证据见 examples/remotion-starter/outputs/。它只证明最小样例已渲染，不代表任何用户项目的内容已经交付。
- AI 功能演示：30 秒 Minimal 录屏讲解。
- 产品发布：30 秒 Apple 风格的真实物件演示。
- 新闻速览：45 秒 Bloomberg 风格的来源优先新闻解释。
- 生成式 B-roll 序列：Seedance 风格的两段连续资产计划，不假称已生成。
每个示例都包含输入、Production Configuration、脚本/镜头骨架和通过条件，告诉使用者“最佳输出长什么样”，而不是只给一段抽象提示词。
当用户要做的不是单条视频，而是长期的视频日更栏目时，本 Skill 不直接吞掉所有细节，而是作为父 Skill 先定义工作流合同，再把视频专项部分交给 codex-remotion-daily-video。
父 Skill 负责：
- 判断是否值得工作流化
- 定义触发条件、输入、输出和项目目录
- 明确人工审阅点
- 明确质量检查和停止条件
- 决定是否要封装成 Skill 或自动任务
子 Skill codex-remotion-daily-video 负责：
- 判断用 HyperFrames 先做样片，还是直接进入 Remotion 模板
- 选择内容格式：讲书号、数据科普、工具教程、产品讲解、观点解释等
- 设计内容 JSON schema
- 设计 Remotion composition 和复用组件
- 设计 still frame 检查、渲染检查和发布后复盘
典型父子协作产物：
## Workflow Contract
- Goal: 每天把一篇书摘做成 60 秒竖屏讲书视频
- Trigger: 用户把书摘放进 inputs/book-notes/
- Inputs: 书名、金句、核心观点、现实案例、行动建议
- Outputs: content JSON、HyperFrames 样片 brief、Remotion MP4
- Project folder: daily-book-video/
- Human review points: 样片方向、标题、still frame、最终视频
- Quality checks: 字幕安全区、标题长度、时长、封面可读性
- Stop conditions: 缺少书籍信息、缺少授权素材、用户未确认关键数字
- Child skill: codex-remotion-daily-video| 需求 | 推荐路线 |
|---|---|
| 日报、周报、选题、资料整理 | 重复任务工作流 |
| 有参考视频和素材库，希望生成可编辑草稿 | 剪映 / CapCut 草稿流程 |
| 文章、PDF、README、教程转带字幕动效视频 | HyperFrames 视频流程 |
| 讲书号、数据科普、工具教程、产品讲解日更 | 父子协作：先本 Skill，后 codex-remotion-daily-video |
| 需要继续在剪辑软件里精修 | 剪映 / CapCut 草稿流程 |
| 需要可复现 MP4 输出和工程化渲染 | HyperFrames 视频流程 |
| 只问一个简单问题 | 不需要调用本 Skill |
| 高级原创大片、强剧情角色表演 | 不建议用本 Skill 作为主方案 |
把仓库放到 Codex 的 Skills 目录：
git clone https://github.com/jackbauerxu/codex-workflow-builder.git ~/.codex/skills/codex-workflow-builder如果你已经有同名目录，可以先备份旧版本，再替换为本仓库。
安装后重启 Codex，Skill 会出现在可用 Skills 中。
你可以直接说：
用 codex-workflow-builder 帮我把每天整理 AI 资讯并生成选题 Brief 的流程做成工作流。
或者：
我有一个爆款参考视频和一批产品素材，帮我设计一个自动生成剪映草稿的 Codex 工作流。
或者：
我想用 Codex + HyperFrames 把这篇文章做成 9:16 带字幕和动效的短视频，帮我设计可复用流程。
或者：
我想做讲书号日更，先帮我把流程做成 Workflow Contract，再交给 codex-remotion-daily-video 设计样片和 Remotion 模板。
Skill 会先判断这个任务是否值得工作流化。如果只是一次性任务，它会建议直接完成任务；如果适合复用，它会继续设计目录、步骤、检查点和封装方式。
当请求包含预览、still frame、剪辑草稿或 MP4 导出时，Skill 会把生产环境检查作为正式步骤，而不是只生成一份方案：
- 判断使用 HyperFrames、Remotion 还是剪映 / CapCut。
- 检查当前项目的 Node.js、包管理器、锁文件、浏览器运行时、FFmpeg 和对应视频工具。
- 缺少依赖或版本落后时，优先使用项目锁文件和项目本地目录自动安装或更新到最新稳定兼容版本；完成后立即运行诊断和版本检查。
- 网络下载或系统级安装必须经过 Codex 的权限确认；不会使用
sudo或静默改写系统环境。 - 只有预览或最终渲染真正生成目标文件后，才报告视频完成。
HyperFrames 和 Remotion 可以由 Codex 自动准备项目依赖。剪映 / CapCut 桌面端属于外部图形软件，无法可靠地静默安装；如果它不存在，流程会停在可编辑草稿和人工交接，并明确说明不能直接导出 MP4。
如果要先验证生产链路，可以直接运行：
cd examples/remotion-starter
npm ci
npm run typecheck
npm run render:still
npm run render:smoke
npm run verify:artifacts它使用 minimal 预设、1080×1920、30fps、60 帧和内置 typed content，不依赖外部素材；verify:artifacts 会检查 PNG/MP4 的真实签名。CI 会重复这条路径并上传短期渲染证据。
project-name/
├── inputs/
├── working/
├── outputs/
├── prompts/
├── logs/
└── RUNBOOK.md
video-project/
├── AGENTS.md
├── assets/
│ ├── appearance/
│ ├── function/
│ ├── scene/
│ └── human-shot/
└── work/
└── YYYY-MM-DD/
├── reference/
├── reference_segments/
├── keyframes/
├── matched_assets/
├── voiceover/
├── subtitles/
├── preview/
└── jianying_draft/
hyperframes-video/
├── AGENTS.md
├── index.html
├── assets/
│ ├── audio/
│ ├── images/
│ ├── video/
│ └── data/
├── scripts/
├── outputs/
│ ├── preview/
│ └── final/
└── notes/
├── script.md
├── storyboard.md
└── review-notes.md
codex-workflow-builder/
├── SKILL.md
├── agents/
│ └── openai.yaml
├── .github/
│ └── workflows/verify.yml
├── LICENSE
├── CONTRIBUTING.md
├── CHANGELOG.md
├── scripts/
├── prompts/
├── styles/
├── references/
│ ├── images/
│ ├── storyboards/
│ └── videos/
├── examples/
├── remotion/
├── examples/remotion-starter/
├── tests/
│ ├── repository-contract/
│ └── production-skill-contract/
├── test-prompts.json
└── README.md
SKILL.md：Codex 实际读取的精简 Skill 主体；详细工作流按需加载references/workflow-patterns.md和references/video-workflows.md。scripts/、prompts/、styles/：视频生产所需的脚本、提示词和被锁定的设计语言；其中包含独立的开箱生产路径。references/：镜头、构图、动效、参考图/分镜与外部参考视频接入规范。examples/：从输入到配置、分镜、最终帧的 Few-shot 参考。remotion/：交接给真实 Remotion 工程或子 Skill 的生产合同。examples/remotion-starter/：可真实渲染的最小 Remotion 工程，包含锁文件、首帧、MP4 和产物检查。tests/：检查生产资料、Skill 路由、仓库完整性和 metadata 是否同时存在。test-prompts.json：触发测试、非触发测试和边界测试。agents/openai.yaml：Codex UI 中的显示信息。README.md：仓库说明文档。
- 把重复工作整理成 Codex 项目流程
- 把已经跑通的流程封装成 Skill
- 把内容生产流程标准化
- 把短视频批量生产流程拆成可检查步骤
- 把参考视频结构迁移到自己的素材库
- 把文章、PDF、README 做成视频生成流程
- 把 HyperFrames 项目流程标准化
- 把日更视频栏目路由到
codex-remotion-daily-video - 把视频生产从手动时间线操作变成分镜审阅和工程化渲染
- 单次简单问答
- 临时写一段短文，不需要复用
- 只想了解 Codex 某个按钮在哪里
- 缺少素材、缺少目标、缺少输出标准的任务
- 强依赖真实表演、复杂镜头语言、精细情绪表达的视频项目
- 主要依赖生成式画面连续演出的项目
当前版本包含测试用例，覆盖：
- 普通重复任务工作流
- Skill 封装请求
- 剪映 / CapCut 草稿流程
- HyperFrames 视频流程
- Remotion 日更视频父子协作路由
- AI 产品演示、产品开箱、新闻播报、TikTok/Shorts 与受控生成式视频资产路径
- 单一风格预设锁定、脚本/镜头/提示词路由和缺失素材处理
- 参考资产、最终帧示例、首个预览候选与最终渲染的真实状态
- 不应触发的简单问答
- 不适合自动剪辑的高要求原创视频
- 不适合 HyperFrames 作为主路线的生成式角色视频
- 边界模糊的内容生产请求
- 可运行 Remotion starter 的 typecheck、still frame、MP4 smoke render 和 PNG/MP4 签名检查
- Skill metadata、License、CI、贡献指南、Change Log 和主 Skill 拆分边界
本地校验命令：
python3 "$HOME/.codex/skills/.system/skill-creator/scripts/quick_validate.py" "$HOME/.codex/skills/codex-workflow-builder"
jq empty ~/.codex/skills/codex-workflow-builder/test-prompts.json
bash ~/.codex/skills/codex-workflow-builder/tests/production-skill-contract/focused-check.sh
node tests/repository-contract/check-skill-metadata.mjs
bash tests/repository-contract/check-repository.sh
cd examples/remotion-starter && npm ci && npm run typecheck && npm run render:still && npm run render:smoke && npm run verify:artifacts- 先判断是否值得工作流化，不为了封装而封装。
- 所有流程都必须有输入、输出、步骤和质量检查。
- 视频生产必须保留人工审阅点。
- 自动剪辑时，低置信度素材宁可留空。
- HyperFrames 路线必须先预览和校验，再做最终渲染。
- 视频日更路线先由本 Skill 定义合同，再由
codex-remotion-daily-video处理样片、JSON、模板和渲染检查。 - 只有跑通过至少一次的流程，才建议封装成长期 Skill 或自动任务。
- 视频生产必须先选内容格式和单一风格预设，再引用脚本、提示词、镜头和参考资产；不能让泛化设计指令覆盖设计锁。
- 生成式视频必须记录素材身份、权利、状态和真实文件路径；只有通过 QA 的
accepted资产才能进入最终时间线。
本仓库自有内容使用 MIT License。Seedance 方法的来源与致谢见 prompts/generative-video.md 和 README.md；第三方参考视频、图片、字体、音乐和素材仍需由使用者自行确认授权。