Cs Digital Human Product Video Pipeline

<!-- CS Skills · 陈硕 | portable skill entry | https://github.com/ChenShuo2004/cs-skills -->

CS 数字人产品视频流水线

目标与边界

把“数字人 + 产品证据画面 + 包装 + 成片”变成可恢复、可审批、可验收的生产流程。Codex 统一状态、规格、事实追溯和质量闸门；ChatCut 是剪辑真相源；ComfyUI 与 Fish/TTS 负责本地生成；Remotion 负责确定性包装和最终渲染。

本 Skill 借鉴分阶段管线、预检、审批关卡和最终验收的做法，但不复制任何多供应商编排系统。不要猜测本机接口、凭据、模型、工作流文件或项目路径；缺少配置时如实标记状态。

只处理有明确产品包的数字人产品介绍视频。它不是通用“把一堆素材自动剪成 MP4”的入口，也不替代 $cs-chatcut-video-blueprint 的内容策划。

默认规格

除非产品包明确覆盖，采用以下当前基线：

风格参数与生产逻辑分离。V1 只内置“产品讲解样片”风格；后续更换背景、模板、人物动作或包装时，扩展 product-pack 的风格参数和本地模板，不重写七阶段管线。

输入与输出

开始前读取 产品包合同。产品包使用 product-pack.json：其中必须区分可证明的产品事实、禁用断言、证据素材、目标平台与时长、CTA、数字人/声音配置、风格、音乐政策和审批模式。

每次运行在产品工作区创建或恢复一个可追溯的运行目录，不把它散落在临时目录中。最少保留：

brief.md
decision-log.md
asset-manifest.json
script-and-timeline.md
sample-review.md
qa-report.md

在同一个运行目录中记录现有项目定位结果、生成物引用、素材来源、审批结论和残余风险。不得把私密凭据、绝对机器路径或本地接口令牌写入这些文档。

运行模式

用户确认样片前，禁止批量生成数字人、批量渲染或对外发布。

用户只说“做一条样片”时使用 sample。用户只想评估环境、内容或方案时使用 plan。用户要求多个风格或多个成片时，仍先完成一个 sample，随后才允许 batch。

启动预检

预检先于本阶段的内容生成、时间线修改或渲染。先核对现有产物的输入版本；已提供且验证有效的原声、数字人或产品镜头直接复用，不要求启动生成这些产物的服务。只检查本阶段真正依赖的工具；未使用工具标为不适用并说明原因，不把它当作 blocked。按以下顺序检查并写入 decision-log.md：

1. 产品包与已有状态。 校验 product-pack.json，定位同产品已有运行目录、ChatCut 项目和审批记录；优先恢复正确项目，不重复导入同一素材。
2. 事实与素材。 为每个产品断言找到产品 UI、原声、用户确认或其他可追溯证据；未证实的能力只能标为待确认，禁止写进口播、字幕或 CTA。
3. 工具可用性。 实际检查 ChatCut、ffmpeg/ffprobe、ComfyUI、Fish/TTS、Remotion 的项目/配置是否可用。没有有效的本地配置、模型或工作流时，不构造替代接口。 模型需求从 ComfyUI 工作流加载节点、Fish/TTS 配置与实际对齐后端提取，不把工具名当作模型型号。先查共用缓存或已配置模型目录的版本、文件大小和哈希；有效时直接复用，只准备已确定且缺失的文件。损坏时报告具体文件，修复须沿用用户授权；云端服务不下载本地权重。
4. 状态结论。 每项标为 passed、degraded 或 blocked，写明证据、影响、可继续的范围和下一项最小修复。

状态含义：

• passed：实际命令、项目或配置检查通过，可用于本次阶段。
• degraded：可继续有限工作，但必须写清不做什么；例如只能完成 ChatCut 样片方案，不能生成新的数字人。
• blocked：缺少本阶段不可替代的能力或事实；停止到不依赖它的上一个阶段，不伪造结果。

plan 可以在 degraded 或 blocked 时交付。sample 和 batch 只能在其所依赖工具全部 passed 后启动。

七阶段编排

详细输入、输出和闸门见 阶段合同。始终按以下顺序执行，只有同一阶段内的无依赖检查可以并行：

1. 选题与事实。 分离产品事实、用户观点、禁止断言、已确认 CTA 和证据素材；参考视频只分析节奏、信息密度、镜头与字幕结构，不复刻脚本、镜头或素材。
2. 口播。 使用已确认的脚本或 $cs-chatcut-video-blueprint 交接的事实包；将每段话映射到产品证据画面，保留未确认项。
3. 配音。 使用用户授权的声音与本地 Fish/TTS 配置，或用户提供的原声。完成最终音频后，优先使用 $cs-narration-phrase-timeline 生成真实字幕时间，不允许按字数伪造时间轴。
4. 数字人。 仅调用已通过预检的 ComfyUI 工作流，记录背景、动作、输入脚本版本和生成结果；没有可用工作流时停止，不用无关替代品冒充本地数字人。
5. 产品场景。 依据真实 UI、屏录、组件视频和产品素材安排证据型 B-roll；先保证每句口播有可见依据，再添加少量信息图形。
6. ChatCut 编辑。 以主口播为锚点，去重导入素材、转写和逐句校正字幕，建立证据画面、转场与必要 SFX。ChatCut 时间线是剪辑真相源。
7. Remotion 包装与成片。 接收已锁定的剪辑基底和真实时间信息，统一章节、产品介绍页、进度视觉和 CTA；最终渲染前后执行合成帧、音频和编码 QA。

不要将阶段 6 的剪辑责任转移给 Remotion，也不要让 ChatCut 的临时效果成为没有验收的最终包装真相。

ChatCut 与 Remotion 的协作

ChatCut 负责素材去重、主口播、字幕、产品 B-roll、转场和必要 SFX。先检查已有媒体和轨道，再导入缺失素材；组件原声可作为事实证据，但成片口播以锁定主口播为准。

Remotion 只接收锁定的剪辑基底、明确的章节边界和真实时码，用于可重复的产品页、包装、进度和 CTA。任何包装文字都必须回链到 product-pack.json 的事实或已确认口播。禁止借 Remotion 擅自补写产品能力。

圆形讲解人物是标准组件：默认放在左下安全区。若 ChatCut 的原生圆角、遮罩或嵌套层在合成预览中出现空层，立即删除测试层，改为 FFmpeg 预合成的透明通道人像，再重新导入；不保留不可见的试验轨。必须在两个独立时段的合成帧中验证人物可见、圆形边缘正确、字幕与产品 UI 没有被遮挡。详细检查见 ChatCut 与 Remotion 验收。

样片审批与批量边界

sample 不是缩短版的全片批量任务。它必须覆盖目标成片的关键风险：至少一段主口播、一个数字人镜头、一个产品证据镜头、字幕、一次转场、圆形 PIP（如产品包启用）和收束/CTA 的风格验证。

交付样片时，提供：

• 样片文件或受控预览；
• 与样片对应的口播、事实和素材清单；
• 时间线结构和至少两个关键合成帧；
• 是否通过、需要修改什么、以及允许进入 batch 的明确用户确认入口。

只有用户明确确认样片，才能把审批记录写为 approved 并启动 batch。已确认的同一产品包/样片版本不重复索要审批；修改产品事实、声音/人物、风格或批量范围时重新核对受影响审批。未确认、要求修改、只说“看看”或没有回复，都不是批量授权。

最终验收

导出成功不等于完成。用 验收清单 同时检查：

1. ChatCut 时间线的主口播、证据 B-roll、字幕、PIP、SFX 和无 BGM 政策；
2. Remotion 的合成预览帧、包装文字、章节和 CTA；
3. ffprobe 输出的分辨率、帧率、编码、时长与音轨是否符合 product-pack；未覆盖的字段使用默认规格；
4. 口播可懂度、无削波、无 BGM 干扰、字幕正确和静音理解性；
5. 每个产品断言、UI、字幕、PIP、SFX 和审批记录的可追溯性。

长任务恢复时核对产品包、脚本、音频、素材和样片审批的版本；只重跑失效阶段及依赖它的后续阶段。生成/渲染超时先检查原任务 ID 与输出，不直接重复提交。

发现任何关键问题时，返回对应阶段修复并重新验收；不要只因为文件存在就标记完成。

与其他 Skill 的交接

• 内容想法、视频主题、口播稿和制作蓝图尚未确认：使用 $cs-chatcut-video-blueprint。它只做策划，并输出可交接的产品包摘要。
• 已有确认蓝图、产品包、素材或成片需求，要导入 ChatCut、调用本地数字人/配音、制作样片、包装和验收：使用本 Skill。
• 最终音频和实际朗读稿已经就绪、只需要真实短语时间：使用 $cs-narration-phrase-timeline，然后把结果交回本 Skill。
• 电商对标复刻、九宫格分镜和 Seedance/Flow/Veo 生成包：使用 $cs-auto-videl。

授权与停止规则

• 不提交、推送或发布。
• 不在用户确认样片前进入批量生产，也不对外发布。
• 不编造本地服务状态、产品能力、音色授权、用户肖像授权、素材版权或完成状态。
• 只在用户授权且预检通过的本地项目范围内创建/修改媒体、时间线或渲染产物。
• 对缺失的产品事实、私密配置、声音/人物授权或批量范围，报告最小阻塞项并等待用户补充。