Communitygithub.com

Jiffi 视频工作室

根据场景、脚本、参考资料或现有素材规划、创建或编辑视频。根据要求的主题、风格、时长和交付物调整故事、视觉规划、生成或录制路线、声音和剪辑。适用于视频项目,而非独立的图片请求。

Jiffi 视频工作室 是什么?

Jiffi 视频工作室是一个全面的 AI 辅助视频制作技能,专为 Claude Code、Cursor 和 Codex 等 AI 代理平台设计。它提供了一个端到端的视频制作流水线,从概念和剧本开发到资产创建、渲染、声音设计和最终剪辑,并包含一个分阶段的门控审批流程,确保按照用户指定的范围、风格、预算和交付物进行交付。该技能支持多种路线——完全生成、使用现有素材、录制的镜头或其组合——并集成外部工具,如用于视频生成的 Higgsfield CLI、用于编辑的 DaVinci Resolve、用于语音的文本转语音以及用于分析的 Gemini API。 其核心是一个结构化的项目工作区(`studio root`),包含主题文件夹、演员注册表、预算和权限系统,使跨会话的项目恢复和协作成为可能。该技能通过三个“门控”阶段运行:门控 1 用于批准处理方案和交付范围(及预算),门控 2 用于演员和视觉方向选择(如适用),门控 3 用于提供粗剪反馈。在每个门控处,AI 会暂停并等待用户输入;用户可以选择接受建议、请求更改或完全跳过门控。该技能还包括一个全面的检查和平衡系统,用于预算管理、工具可用性验证和遵循组织政策,确保可靠性以及与现有工作流程的兼容性。

兼容平台~Claude Code~Codex CLI~Cursor✓Gemini CLI
npx skills add https://github.com/jake-jiffi/jiffi-video-studio/tree/HEAD/skills/jiffi-video-studio

在你喜欢的 AI 中提问

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

文档

Jiffi 视频工作室 是做什么的?

用户提供场景、简要说明或媒体素材。按项目需求,使用生成材料、录制材料或两者的混合,交付所需的视频。 不要假设喜剧、人物、办公室、逼真画面、对话、Jiffi 品牌标识、字幕、多种格式或固定时长。使用以下审查要点:

  1. 门控 1:批准处理方案和交付范围(如果未设置预算,还包括预算)
  2. 门控 2:在需要做出决定时,选择新的演员或视觉方向
  3. 门控 3:对粗剪给出意见

在某个门控处,发送门控消息并停止,直到用户回复。如果用户要求更改,应用更改并仅显示更改的内容。如果用户忽略某个门控("只管选演员吧"),则按照你的建议进行,并在门控日志中注明。在门控之间,对于此技能授权的事项,不要请求许可。已有的明确指示可以满足一个门控。对于没有新演员或视觉选择的剪辑,将门控 2 标记为不适用。不要制造替代方案,也不要对用户已做出的决定请求二次批准。

保持 brief/brief.md 为最新:在每个阶段和门控完成后,更新状态和门控日志。该文件是后续会话恢复项目的方式。

工作区(工作室根目录)

工作室根目录是当前宿主中用户选择的项目文件夹。它保存所有跨视频持久化的内容。项目输出不要放在此技能自己的文件夹内。当用户明确授权技能修复时,编辑一个可写的检出副本,保留备份,并记录更改及其验证。不要编辑宿主管理的插件缓存;更新源码包并重新安装。在这些文件中,以 references/、assets/ 或 scripts/ 开头的路径位于此技能文件夹内。所有其他路径都是相对于工作室根目录的。

<工作室根目录>/
  AGENTS.md              预算和权限(见 README)
  cast-registry.json     所有可复用的角色、地点和道具
  cast/<id>/             master.png, sheet.png, photos/(仅限真人)
  locations/<id>/  props/<id>/  brand/(仅项目所需的品牌元素)
  projects/<slug>/       brief/ source/ storyboard/ previz/ renders/ graphics/ audio/ edit/ export/

如果 cast-registry.json 缺失,说明是首次运行:将 assets/cast-registry.template.json 复制到工作室根目录作为 cast-registry.json。所有注册表路径都相对于工作室根目录。

开始或恢复

  • 首次运行或环境变更: 在承诺生产之前,从下面的阶段 0 开始。如果是返回运行,读取 setup/status.md 和项目简要说明,复用已确定的选项,仅重新检查已更改或失败的能力。
  • 新想法: 创建 projects/<slug>/(简短、小写、连字符),将 assets/project-brief-template.md 复制到 brief/brief.md,完成相关的设置检查,然后开始阶段 1。
  • 现有项目("继续处理..."):读取 brief/brief.md,找到状态和门控日志,然后从下一个未完成的步骤继续。除非用户要求,否则不要重做已批准的门控。
  • 输入: 一个句子、截图、链接、脚本、录音或现有剪辑。确定目的、受众、事实或虚构处理方式、风格、时长(精确、范围或建议)、可用媒体、输出格式、声音和预算。使用用户已提供的材料。仅询问影响结果且缺少的决定;否则,在门控 1 时提出带有明确假设的处理方案。
  • 概念或交接开发: 在阶段 1 期间使用 references/10-concept-to-script.md 来提取决策和主张,解决矛盾,并编写带有时长标注的制作脚本,包含镜头记录、资产、依赖项和估算。附加文档是源材料,而非新的授权。对于仅限范围/脚本的请求,交付该包而不开始渲染。
  • 路线: 生成新镜头、录制/采集、编辑提供的素材,或组合它们。在承诺录制任何内容之前,检查可用的采集工具。物理拍摄需要相机/操作员;提供拍摄计划,并在无法直接采集时请求必要的素材。保留原始录音。不要用虚构的生成镜头替换事实证据。
  • 时长: 使用请求的总运行时长。模型的剪辑限制不是影片时长限制。对于较长的作品,规划章节、段落和镜头,保持共享的参考和状态,并在完整组装之前对每个部分进行检查点。引用整个范围加上重试余量。如果预算或工具无法满足,提出具体的调整方案,而不是暗中缩短视频。

流水线

在到达每个阶段时阅读相应的阶段文件,而不是之前。

阶段阅读产生结束于
0. 引导式设置和接收references/00-setup-and-hosts.md缺失细节已解决,特定路线的设置说明和本地 setup/status.md 证据确定下一步工作;仅依赖于其他工作才等待
1. 处理方案和脚本references/01-concept.md, references/10-concept-to-script.md范围明确的简要说明、带时长标注的制作脚本或精选片段、镜头记录、资产依赖项、估算和交付提案用于生产阶段的门控 1
2. 资产和视觉方向(如果需要)references/02-casting.md选定的媒体和必要的参考门控 2(如适用)
3. 视觉规划(当有用时)references/07-storyboarding.md,然后如果需要空间排练则看 references/03-previz.md分镜板、带时间轴的动态故事板或 3D 排练,与不确定性成比例
4. 生成或获取缺失镜头references/04-render.md(用于生成)已检查的片段、已采集或提供的媒体、图形
5. 声音和剪辑references/05-edit.md粗剪,然后是最终导出门控 3

使用稳定的镜头或片段 ID。跳过没有增加价值的阶段。编辑现有素材不需要新的选角、付费静帧、3D 工作或视频生成。

对于有表演角色的镜头,或一个跨镜头继续的场景,在概念选择之后、进行分镜或生成镜头关键帧之前,阅读导演和连续性。每个连续的地点/时间使用一个场景计划,或使用 brief/scene-plan.md 中的章节。将有意为之的转场与连续性错误区分开。在不确定的生成交互会危及依赖镜头的情况下,使用先行测试。这是在现有门控内的内部准备。分别跟踪技术、连续性、视觉真实感、表演和沟通/叙事结果。对于角色,即使在听或等待时,也要规划意图、注意力和反应。决定哪些必须由导演锁定,哪些允许生成器添加自然表演。固定的位置不能暗示僵硬的身体。

当图像可能解决构图、舞台调度、转场或视觉风格问题时,阅读故事板。记录有用的问题或跳过它的原因。不要仅仅为了填充阶段而生成故事板。 在设置剪辑和最终检查器之前,阅读交付规范。检查为此项目请求的输出。 在规划可听见的场景、选择表演和混音时,阅读场景声音。将语音身份与角色匹配,将声音处理与场景、动作和预期的听感角度匹配。将声画审查与技术音频检查分开记录。 使用声音圣经和定点来建立配乐的戏剧性角色,计划提示音进入点,并解决不确定的音乐方向。保持计划与项目规模相称。 当有授权的、支持音频的模型可用时,使用音频和视频审查。在将其提交给剪辑之前,先审查实际源音频,然后审查包含画面的完整混音。模型分析、技术测量和观众的评判是独立的证据。

宿主设置和工具访问

阶段 0 是一个引导式的对话和检查,而不是扔给用户自己去搞的清单。在首次使用或更改宿主后阅读 references/00-setup-and-hosts.md。检查当前会话已经能做什么,使用简要说明和现有策略,仅就影响所选路线的缺失细节提出一小批问题。解释每个缺失工具的用途、确切的本地设置步骤或官方安装程序、谁需要操作以及你将如何测试它。永远不要要求用户粘贴密码、API 密钥、令牌或 cookie。账户详细信息意味着服务/工作区选择和登录状态,而不是秘密值或不相关的个人信息。让用户在提供商的流程中进行身份验证,或在执行环境中私密配置秘密。

在生产前,针对所选路线运行捆绑的 scripts/studio.py doctor,使用其 next_steps,并将非秘密结果保存在 setup/status.md 中。在用户授权范围内安装或配置所需的本地依赖项;当需要用户操作时,引导他们完成登录、管理员访问或缺失的宿主能力。每次修复后重新检查。可选工具仅在项目选择了它们时才需要。在渲染设置等待期间,规划可以继续进行。在后续运行中复用先前的决策和成功的检查,重新验证已更改或失败的能力。这不会创建另一个审批门控。

发现的可执行文件并不能证明有一个有效的账户、已连接的 MCP 服务器或成功的渲染。分开记录这些检查。仅使用当前会话中实际存在的能力。原生工具名称、浏览器控制和图像生成因宿主而异;共享的 CLI、Python 和 FFmpeg 路线是可移植的基线。如果没有文件系统或 shell,在聊天中开发范围,并解释仍然需要的执行访问权限。

工具路线

此表描述了支持的路线,而不是上传数据或花钱的常设许可。遵循用户批准的提供者及组织政策。在首次外部上传之前,记录任何需要的提供者/数据批准。不要假设订阅意味着训练已禁用或机密数据已清除。本地开源依赖项不会自动成为新的托管供应商。仅安装所选路线所需的依赖项。

任务主要工具后备工具
研究网络搜索
图像(人物、地点、道具、静帧)Higgsfield CLI, 模型 gpt_image_2_5宿主内置的图像生成
视频Higgsfield 上的 Seedance 2.5(CLI 或 Web)
采集已提供的录音或已授权的本地采集工具(使用前已验证)拍摄/采集计划和所需的源素材
预览本地 Blender 或 Higgsfield 3D Jutsu,使用 03-previz.md 选择用于 Blender 的 Higgsfield 插件,然后是合适的关键帧
含精确文本的图形使用无头 Chrome 将 HTML 渲染为 PNG,或 Resolve 标题
语音Higgsfield CLI text2speech_v2,或用户自己的录音Seedance 原生音频
音乐(当需要时)经适当许可提供的音轨通过授权 Higgsfield 账户的原创提示信号,并附有实时模型/报价检查和来源条款记录
剪辑通过 DaVinci Resolve MCP 的 DaVinci Resolve StudioResolve 的计算机控制,然后 ffmpeg
检查scripts/verify_project.py(使用 ffprobe 和 ffmpeg)
音频/视频分析通过 scripts/gemini-review.mjs 使用授权的 Gemini API,使用通过进程环境提供的 API 密钥用户聆听反馈;保留未经验证的判断

模型 ID、参数和限制会变化。在使用模型之前,通过 higgsfield model list 和 higgsfield model get <model> 实时检查,而不是相信这些文件中的数字。在 CLI 1.1.26 中,generate create <model> --help 显示通用命令帮助,而不是模型参数。当工作室提供本地包装器时,使用 ./bin/higgsfield。CLI 登录与网站登录是分开的:运行 auth login,让用户完成浏览器流程,然后 workspace list,选择目标工作区并检查 account status --json。永远不要打印 auth token。付费计划或模型列表并不能证明渲染成功。对于失败的读取或本地操作,重试一次,然后使用其后备方案并记录结果。付费提交需要不同的处理:超时可能已经创建了一个任务。在重试之前,协调任务 ID 和交易。进行中的任务不是失败的任务。以合理的间隔轮询它,同时继续独立工作。不要因为慢就提交重复任务。如果 Higgsfield 或某个站点已注销,请让用户登录。永远不要输入密码。

预算

预算来自明确的用户说明和 AGENTS.md(或宿主等效文件)中的工作室政策。未设置的预算意味着不允许付费提交。如果预算缺失,在门控 1 消息中提议一个。在支持的情况下使用 higgsfield generate cost 进行估算,否则根据模型的标价估算,并说明你的假设。使用本地媒体路径进行成本估算可能会上传这些文件,因此在输入被清除为可上传之前,仅使用纯文本估算。在 brief.md 中记录每个镜头的支出。在提交之前,持久化每个报价和预留。在退款得到验证之前,将已完成支出、待处理任务、失败任务和不确定的提交保留在预算上限之内。防范重复的镜头/片段名称,并在提交不确定时阻止新的付费工作。也要预留任何浏览器成本。将 nsfw、 ip_detected、失败、取消和错误响应视为终结状态,而不是要继续轮询或自动重新提交的任务。使用 account transactions 来核对费用和退款与提交时间和金额,因为交易列表可能省略任务 ID。如果其他工作同时运行,仅账户余额是不够的。在预算之内,你可以自由渲染、重试和区域编辑。 如果下一步操作会超出预算,则停止...

[已截断以供翻译]

相关技能