Communitygithub.com

inkroom-promo-video-skill

审核驱动的 Inkroom 产品视频工作流:证据→脚本/故事板→Seedance 镜头→HyperFrames 组装→音频/字幕 QA→本地 MP4。从不自动发布。

inkroom-promo-video-skill 是什么?

该技能定义了一个完全受审核驱动的 Inkroom 产品视频制作工作流。它强制要求所有进入下一阶段的决策点(门控)都必须获得用户明确确认,不得自动推进或发布。工作流覆盖从项目初始化、事实锁定、脚本与故事板创建、镜头生成(通过 Seedance)、确定性组装(通过 HyperFrames)到最终质量审核与本地下载的完整流程。该技能特别注重区分“已收到”与“已批准”状态,保护已批准的素材不被静默覆盖,并严格管理产品声明(如“已确认”、“用户决策”、“推断”、“待定”)的准确性与真实性。生成的图像可用于解释概念,但严禁冒充 Inkroom 的 UI、目录、API 文档、价格、文件、数据、Logo 或真实证据,确保所有声明均有真实录音支撑。此技能适用于 Claude Code、Cursor 等支持自定义工作流的 AI 编码代理,在设计上注重可审计、可撤销的人工审核环节。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add xiaobai987-sxy/inkroom-promo-video-skill

在你喜欢的 AI 中提问

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

文档

Inkroom 推广视频

构建一个可复用的 Inkroom 产品视频作为配套工作流。默认配方为 XiaoMo 第一人称视角、16:9 横屏、首选 Seedance 画面、使用真实录音作为产品证据、以及使用 HyperFrames 进行确定性组装。该配方可配置;未经当前工件核对,不得直接复制先前项目的时长、镜头数量、措辞或审批状态。

操作契约

  • 将 film_subject=Inkroom product 与 production_workflow=behind-the-scenes production 分开。历史元视频任务不得成为产品副本。
  • 将产品声明分类为 confirmed、user_decision、inference 或 pending。在阅读历史 README 或旧任务文件之前,先读取当前产品事实和活跃的交接文档。
  • 生成的图像可用于解释概念,但不得冒充 Inkroom 的 UI、目录、API 文档、价格、文件、数据、Logo 或真实证据。对于这些声明,请使用真实录音。
  • received 不等于 approved;占位符永远不是批准的镜头;批准的来源不得被静默覆盖。
  • 每个改变方向的门控都需要等待用户明确确认。文件存在性不得推进门控。
  • 默认交付终点为用户批准的预览、渲染的 MP4 以及本地下载。永远不要自动发布。

启动与恢复

  1. 定位项目根目录并读取 BRIEF.md、活跃的交接文档、workflow/state.json、活跃的合成文件以及最新的 QA 报告。对过期文档发出警告,而非将其视为事实。
  2. 如果状态不存在,使用 scripts/init_project.py 进行初始化;不得推断审批状态。
  3. 从记录阶段恢复。不得重复已批准的工作或将已接受的能力作为新功能提供。
  4. 维护一份规范的交接文档,外加机器可读的状态、清单、资产账本和 QA 报告。

状态机与门控

精确使用以下阶段:

intake -> facts_locked -> outline_review -> copy_review -> script_review -> storyboard_review -> frames_review -> seedance_package_ready -> awaiting_external_returns -> per_shot_received -> per_shot_approved|per_shot_rejected -> assembly_preview -> audio_review -> qa_pass -> user_render_approval -> rendered_downloaded -> publish_ready

项目可以从被拒绝的镜头分支回其自身的帧/提示/生成审核。在更改状态前请阅读 references/workflow-state-machine.md 并使用 scripts/state.py 进行状态转换。

阶段路由

  • 事实与大纲: 刷新产品事实;仅将 marketing-skills 作为候选研究辅助工具。在撰写文案之前锁定受众问题和证据缺口。
  • 文案、脚本、故事板: 使用已确认的文案和“每个镜头完整动作”规则。screenwriting-skills 可以提供结构参考,但绝不能导入 Ottermind 特有的内容。阅读 references/product-evidence-policy.md。
  • 帧: 当可用时,使用 imagegen 或 image-2,并配合已批准的角色表和风格锚点。保持帧无文字且为横屏。
  • Seedance: 使用 seedance1 将已批准的故事板单元转化为独立的提示词和一个交接包。如果存在授权的视频模型,只有经过用户批准后才能进行直接生成;否则等待手动外部返回结果。阅读 references/seedance-review-checklist.md。
  • 返回结果: 按 shot_code 和 take 进行匹配;独立检查每个片段;按镜头批准或拒绝。不得使用冻结帧或隐藏裁剪来修复失败的生成。
  • 组装: 使用 hyperframes、hyperframes-core、general-video 和 hyperframes-cli。每个已批准的 Seedance 源从源时间零点开始播放一次;仅覆盖字幕/事实标签并用真实录音替换占位符。阅读 references/hyperframes-assembly-rules.md。
  • 媒体: 使用 media-use 处理语音、背景音乐、音效、字幕和来源。预览 TTS/音乐必须带有许可证状态。
  • 质量审核与交付: 运行项目验证器、hyperframes check --strict、快照以及 FFmpeg/ffprobe 检查。仅在用户批准预览后进行渲染。阅读 references/release-checklist.md。

标准输出

每个项目应根据适用情况生成:BRIEF.md、workflow/state.json、workflow/PRODUCT_FACTS.json、OUTLINE.md、COPY.md、SCRIPT.md、STORYBOARD.md、INKROOM_VIDEO_COMPLETE_HANDOFF.md、seedance/*manifest.json、Seedance ZIP 文件、ASSET_LEDGER.md、QA-REPORT.md、Studio 预览 URL 以及已批准的 MP4 路径。

记录每个阶段的工具、状态(used、candidate 或 blocked)、许可证和边界。在接受包或返回的镜头前,使用 scripts/validate_manifest.py 进行验证。

相关技能