Jc koubo shuping

jc-koubo-shuping

Boundary

只处理 竖屏口播 mp4 + srt -> Remotion 透明 overlay -> ffmpeg preserve-source 成片。

不要用于横屏剪辑、纯转码、参考视频拉片、剪映工程或无口播主体的视频。参考风格分析先用 video-style-replicator。

Hard Rules

• 先选模式：首次看效果用 fast_preview，人工通过后用 production，局部修改用 repair。
• fast_preview：一个写入 Agent、4–6 张检样、最多渲染 2 次和自动修复 1 次，然后 WAIT_USER。
• production 执行静态图、10–15 秒样片、全片、技术终检和人工验收；未过前一闸门不得继续。
• repair 只使受影响的依赖失效，旧产物保留，新产物写入新 attempt；更换源视频必须新建 case。
• 先校对 SRT 错别字、专有名词和重叠时间，不静默改写原意；保存修订稿和差异记录。
• Remotion 只渲透明 UI、字幕和 chrome；ffmpeg 只合成、编码和封装，源视频不得在 Remotion 重绘。
• 禁止默认使用 -shortest；原音频在未改时序时必须 stream copy。
• 一个 beat 只允许一个可阅读 hero；字幕是跟读层，不是总结卡。
• 中英字幕各单行、各用独立黑色半透明圆角底板；长句先拆 cue，不用换行、小字、黄色高亮或粗描边掩盖。
• motion map 是语义与 MG 文案唯一真源；draftNodes 不可渲染，manifest.nodes 只能由 compile-motion-map.mjs 生成。
• canonical workflow 只接受 schema v3；旧 case 先运行 migrate-case-v3.mjs。
• 用户纠正、QA 缺陷或返工先查错题集；新类型本轮补入并回归。
• ASR 只在字幕存在明确语义疑点时按片段启用；快速检样不做默认全片 ASR，不因一两个词并行调用多模型。
• 技术通过不等于发布通过；发布必须有用户明确验收。

Mode Router

• 用户说「先看看效果、检样、快速出一版」：读 references/fast-preview.md。
• 用户确认静态图或样片并要求继续成片：读 references/production.md 和既有发布合同。
• 用户说「字太大、卡片挡脸、只改某处」：读 references/repair.md，先运行 repair-case.mjs。

Canonical Commands

1. 创建 case：node scripts/create-case.mjs --video /abs/in.mp4 --srt /abs/in.srt --out /abs/case。
2. 编译 caption plan，再按 semantic-copy-contract.md 写 motion map 并运行 compile-motion-map.mjs。
3. 到 motion_map_ready 后运行 node scripts/run-fast-preview.mjs /abs/case/case_manifest.json。
4. 返修运行 node scripts/repair-case.mjs /abs/case/case_manifest.json --target caption --apply，只执行失效节点。
5. 人工通过检样后按 references/production.md 生成样片、全片并执行发布门。
6. 修改 Skill 后运行 verify-fast-preview.mjs 和 verify-install.mjs。

Resource Routing

• 输入与字幕：references/input-contract.md
• 全流程与状态机：references/workflow-contract.md
• 极速检样：references/fast-preview.md
• 正式成片：references/production.md
• 局部返修：references/repair.md
• 语义分段与 MG 文案：references/semantic-copy-contract.md
• 固定画质工艺：references/preserve-source-quality.md
• 视觉、布局与字幕：references/visual-contract.md
• 渲染与合成：references/render-contract.md
• QA 与人工验收：references/qa-contract.md
• 错题登记与关闭：references/error-bank.md
• 发布门：references/release-gates.md
• 机器错题集：evals/error-cases.json
• Remotion 运行模板：assets/remotion-template/
• 默认公开基线锁：assets/baselines/default-single-line-bilingual/baseline-lock.json

Completion Contract

缺 motion map、两次人工闸门、Remotion provenance、QA、preserve-source 证据或用户明确验收，不得报告「剪辑完成」。验收 JSON 不能证明填写者身份。