Communitygithub.com

zyyzyy860-netizen/my-book-video-workflow

引导Codex通过研究驱动的方式制作书籍短视频,使用Bookflow剧集文件和检查工具。适用于创作者计划、制作或审查基于此仓库的书籍视频时使用。

my-book-video-workflow 是什么?

此技能是一个完整的书籍短视频创作工作流,专为与Codex等AI代理配合使用而设计。它通过结构化的七步流程,引导创作者完成从选题研究、脚本撰写到最终视频导出的全过程。工作流的核心是严格的质量控制和版本管理,要求在每个关键环节(如脚本定稿、故事板确认)获得创作者明确批准后才进入下一步。该技能支持广泛的操作系统和环境,但强调所有媒体生成和编辑需依赖创作者环境中实际可用的工具(如HyperFrames、CapCut),而非仓库自带的CLI功能。仓库CLI主要负责任务初始化、文件结构检查、SRT字幕导出等辅助任务。此外,技能要求AI代理严格区分已实现功能和计划中的功能,不得夸大自动化程度,确保透明度和可信度。

兼容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/zyyzyy860-netizen/my-book-video-workflow/tree/HEAD/skills/bookflow

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Bookflow Studio

当创作者想要演示或执行一个真实的书籍短视频项目时,请使用此技能。首先,阅读仓库中的 AGENTS.md 和 docs/workflow.md;在填写或排障剧集文件时,请参考 docs/project-format.md。

执行剧集

在创作者选择的剧集文件夹内工作。如果不存在剧集文件夹,请询问创作者想覆盖哪本书,或是否需要推荐;不要自行选择要推广的产品。对于新剧集,请使用 npm run bookflow -- init <episode-folder>,并保留任何现有文件。

引导创作者完成以下交付物,并在适用时使用CLI:

  1. 确认确切的标题、作者、版本和目标受众。从适当的公开来源研究事实细节;将URL以及每个来源支持的内容保存到 sources.md 和 claims.csv 中。如果创作者已连接阅读笔记服务并授权使用,仅使用他们可访问的笔记作为主题信号;不要复制长篇段落,也不要把高亮当作公开事实。
  2. 在 script.md 中起草原创旁白。将经过验证的事实与个人解读和体验分开。如果创作者提供了参考视频,分析其结构、节奏和大致时长;但不要复用它的台词。如果无法访问参考视频,请说明这一情况并明确告知限制。
  3. 展示完整的脚本,并在准备制作媒体之前等待创作者明确批准。每个口语节拍保持一个稳定的片段ID。如果创作者仅要求编写或修改脚本,则在此审核环节结束。
  4. 脚本批准后,构建 storyboard.csv,精确匹配每个口语片段,并指定相关的视觉元素、来源/版权、屏幕文字、动作和时长。展示故事板,并在获取或生成制作素材之前等待批准。
  5. 故事板批准后,仅使用当前环境中实际可用的媒体工具。记录素材来源和版权。旁白请使用创作者的录音或明确批准的声音源。如果ASR工具(如Whisper)可用,以其时间戳为起点,并对照实际语音轨道进行核查。确保中文字幕准确;可选的英文字幕应在手机上保持可读。使用 npm run bookflow -- export-srt <episode-folder> 导出SRT。
  6. 仅当存在合适的编辑器或渲染器(例如HyperFrames或CapCut)时,才进行视频组装和预览。不要声称此仓库的CLI可以生成图像、语音或视频:它负责准备剧集文件、检查结构/对齐并导出字幕。此处提到的工具名称是可选的集成,而非捆绑的依赖;详见 docs/integrations.md。
  7. 运行 npm test 和 npm run bookflow -- check <episode-folder> --release 以生成发布候选。解释自动化检查能做什么和不能做什么。创作者仍需自行审查事实准确性、版权、移动端可读性以及渲染后的视频。

对于介绍Bookflow Studio本身的视频,仅描述此仓库中存在的功能,并通过实际运行验证其有效性。将Codex引导的工作流与CLI的具体功能区分开来;切勿将计划中的或依赖工具的媒体生成描述为已由代码自动完成。

保持剧集素材和私人工作内容在公共仓库之外。不要提交凭据、原始语音、账户数据、未经授权的封面、音乐、截图或客户媒体。

相关技能