image-story-video-wizard README

The project's README from github.com/aaronyi97/image-story-video-wizard. As one markdown file: README.md.

Image Story Video Wizard

一个用于 Codex 和 WorkBuddy 的分步式 Skill,带用户从选题、对标、文案、配音、分镜、生图一直做到预览和成片。

它的核心不是把一整套流程一次性丢给用户,而是主动引导和推进:Skill 判断当前阶段、完成能自己做的工作,用户只在关键节点提供材料或做确认。

它怎么带你往下做

每一轮都会说清楚五件事:

  1. 现在进行到:
  2. 我现在会做:
  3. 你现在只需要:
  4. 完成后我会交付:
  5. 确认后下一步:

完整阶段是:

START → BRIEF → BENCHMARKS → WRITING_PACK → SCRIPT → VOICE → STORYBOARD → VISUAL_STYLE → CHARACTER_ANCHORS → IMAGE_PROMPTS → IMAGE_GENERATION → ASSET_QC → MUSIC → PREVIEW → FINAL_RENDER → FEEDBACK

关键确认点包括:

适合的项目

如果你只需要一篇文案、一张图或普通剪辑,不需要调用这个 Skill。

一句话安装

把下面这句话完整发给 Codex:

请使用 skill-installer 从 https://github.com/aaronyi97/image-story-video-wizard 安装 Skill。Skill 位于仓库根目录,安装名使用 image-story-video-wizard。安装完成后告诉我下一轮可以直接启动。

Codex 安装 Skill 后会在下一轮对话加载它。然后直接发:

使用 $image-story-video-wizard 开始一个新项目。我想做一期【选题】的图片联播视频,请主动带我往下做。

终端安装

Codex:

git clone https://github.com/aaronyi97/image-story-video-wizard.git ~/.codex/skills/image-story-video-wizard

如果 WorkBuddy 也从本地 Skill 目录加载,可以在它的 Skill 目录中安装同一仓库,或链接到 Codex 中的这份 Skill。

开始使用

直接对 Codex 或 WorkBuddy 说:

我想做一期【选题】的图片联播视频,请使用 image-story-video-wizard 带我从现在的阶段往下做。你主动推进,每次只让我提供当前必需的材料或做当前确认。

项目会用 PROJECT_STATE.json 记录当前阶段、已确认决定、产物路径和下一个需要用户回答的问题。换到另一个宿主后,可以从这个状态继续。

教程中的默认路线

豆包语音入口:

验证

python3 -m unittest discover -s tests -v
python3 /path/to/skill-creator/scripts/quick_validate.py .

当前自动校验覆盖 Skill 结构、16 个阶段、五段式引导、关键教程要求、状态机一致性,以及项目初始化与恢复所需的状态文件。

WorkBuddy、Kimi、豆包、生图和渲染是实时外部能力,Skill 会在进入对应阶段时先检查当前是否可用,不会在未实际调用时声称已经参与或完成。

License

MIT

image-story-video-wizard (aaronyi97/image-story-video-wizard)

Searching Database…

What is this?A step-by-step guided skill for Codex and WorkBuddy that walks you from picking a topic through research, copywriting, voiceover, storyboarding and image generation all the way to a preview and a finished image-story video.
So is this a separate app I install, or something that lives inside my AI agent?It lives inside the agent: Codex or WorkBuddy loads the skill and drives the project in conversation, with each turn telling you the current stage, what the agent will do, and the one thing it needs from you.
What do I need besides the skill itself?A host — Codex or WorkBuddy — plus real-time external capabilities for image generation, voice and rendering. The skill checks that each capability is actually available when its stage begins instead of assuming it worked.
Does it just run the whole pipeline on its own?No — key steps are confirmation-gated: no writing pack until the benchmark direction is approved, no full voiceover until the script is final, no batch image generation until style and samples are locked, and no final render before the preview passes.
What kind of videos is it built for?AI-narrated book, history and emotional stories, audiobook-style content, podcast audio with images, and static-image narrative videos needing character consistency, a fixed art style, subtitles and text cards. For a single article, a single image or normal editing, the README says you don't need it.
Why does it guide you stage by stage instead of doing everything in one go?That is the core design: rather than dumping a whole pipeline on you at once, the skill proactively advances the project, does the work it can do itself, and only asks for materials or a confirmation at the moments that matter.
Is the skill's own structure tested anywhere?Yes — automated validation covers the skill structure, all 16 stages, the five-part per-turn guidance, key tutorial requirements, state machine consistency, and the state files needed to initialize and resume a project.
Am I locked into Doubao, Kimi K3 and HyperFrames?No — the README presents them as the tutorial's default route, not hard requirements. As long as a voice, image-generation and rendering capability is available at the matching stages, the pipeline works; the skill verifies availability before each of those stages.
Creator
aaronyi97
Size
<0.1 MB
Stars
357
Updated
CommitSep 15
Age
1mo
Commits · 90 Days