Majia Chatcut Koubo

majia-chatcut-koubo · 马甲实战版

ChatCut 口播剪辑的通用技巧包。把 ChatCut 当作最终可继续手工调整的非线性编辑器：所有剪辑交付留在项目和时间线上，以可见画面、可听声音和可读字幕为验收对象。

与官方 skill 的分工

ChatCut 插件自带官方 skill（plugin-basics / talking-head-guide / transcription / verification / known-errors / create-motion-graphics 等），工具怎么用一律以官方为准，参数以当前 MCP 工具实时描述为真相源。

本包只写官方没有的：剪成什么样算好（版式、配色、动效节奏、构图标准）、实测踩坑护栏（坐标系陷阱、fps 错位、验证方法）、可复用资产（8 版式坐标、8 主题色板、字幕校验脚本、词表模板）。与官方重复处以官方为准。

五条第一性原则

1. 内容真相：成片的实际音频和当前时间线是唯一真相；装修不改写源区间、顺序、速度、主音频或字幕时序。
2. 单一合成所有权：同一帧的录屏几何、人物几何和外框只由一个稳定态或一个转场 owner 接管；白块、重复人物、孤儿框、叠加溶解都是所有权冲突。
3. 时间原子性：状态用半开区间 [start,end)；录屏、人物、框线同边界提交；媒体跨态先拆分，不按 item 起点猜状态。
4. 证据优先：画面变化由「隐私 → 屏幕证据 → 人物强调 → 字幕负载 → 新鲜感」决定；时间只提醒复查，不驱动机械轮播。
5. 量化门禁：工具成功不是完成。结构、字幕、音频、像素各有明确结果；无法看或听时标 unverified，不得用结构结果顶替试听或像素证据。

通用工序

1. 同步与规格：多机位 multicam_sync；只留一个主音轨（讲解人 anchor，录屏副本 -60dB）；冻结画幅、fps、采样率。
2. A-roll 内容：按官方 talking-head-guide；一句话原则——删声音比删意思安全，错删信息的代价高于漏留口癖。
3. 剪后转写与字幕：删除/重排/变速后必须刷新剪后转写；字幕见 references/captions-terminology.md——第一步永远是查字幕源绑定（挂在翻译变体轨上=P0，先切回原文源）。
4. 样片闸门：横版先做开头约 18–23 秒、竖版 20–30 秒样片，确认后才批量；任何一项失败先修样片，不批量复制错误。
5. 画面结构：双画面版式选型见 references/dual-frame-layouts.md；人脸取景见 references/face-reframe.md。
6. 动效与包装：字幕锁定后才做过渡、B-roll、MG；过渡工程见 references/motion-transitions.md；配色见 references/theme-palettes.md。
7. 验收：结构回读 + 合成像素 + 实际试听三证齐才算完成；帧率以 ffprobe 读实际导出文件为准。

成片红线

• 字幕：简体、始终单行、来自真实语音转写、按完整气口分卡；行尾逗号不显示，句末标点保留；跑 scripts/validate-caption-pages.mjs，退出码非 0 = 未完成。
• 内容：重说默认删前保后；重排只搬完整语义单位，不拼出说话人没说过的话；默认自然结束，不加模板片尾。
• 画面：PiP 不拉伸；正圆以裁后可见区判定（visibleWidth = width × (1−cropLeft−cropRight)），改外框时保留旧 crop = 二次裁切事故；人物层保留完整源画幅，效果顺序 reframe → mask；任一精确帧露黑边即撤销整段动态取景；框线不穿人物；二维码等隐私信息全时间范围不可见，部分遮挡=失败。
• 工程：30fps 时间线可能 60fps 导出，MG 一律按秒或归一化帧率计时；写入宣称成功≠落盘（回读 FX 实例）；素材池有资产≠时间线有实例。
• 协作：用户已验收的设计是受保护基线，删除、降级、明显改变必须先问——连续兜底失败也不例外；同一可见缺陷第二次出现=停止逐片补丁，修共享根因并全量回归。

按需加载路由表

| 任务信号 | 完整读取 | | --- | --- | | 双画面构图、版式选型、圆窗/分栏/上下屏、小窗腾挪 | [双画面版式系统](references/dual-frame-layouts.md) | | 主题配色、字幕底板、对比度、按角色用色 | [主题配色系统](references/theme-palettes.md) + 选定主题的 assets/theme-kit/playbooks/.md | | MG/设计图形加不加、加哪种、怎么选 | [信息块类型与选用](references/graphics-blocks.md) | | 过渡动画、状态切换、闪烁/黑块排查、fps 归一化 | [过渡动效工程](references/motion-transitions.md) | | 人脸居中、内部取景漂移、蒙版参数、黑边排查 | [人脸取景与三层合成](references/face-reframe.md) | | 字幕气口、术语纠错、词表维护、字幕门禁 | [字幕与词表](references/captions-terminology.md) |

可复用资产：assets/compositions.json（8 版式坐标快照）、assets/theme-kit/（8 主题 token+SVG 底图+可运行组件）、templates/（词表/实测参数模板，装进你自己的数字）、scripts/validate-caption-pages.mjs（字幕机械校验）。

让它变成你自己的

本包的数字（22 字/行、330px 圆窗、magnification≈0.30）是作者素材上的实测起点，不是跨素材真理。使用方法：

1. 复制 templates/operating-profile.template.json，在你的素材上做一个样片，把验证过的数字填进去。
2. 复制 templates/terminology.template.json，把你的品牌、产品、行业词和 ASR 常见误听填进去。
3. 每次剪辑让代理先读你的 profile 和词表；数字变了就升版本存新文件，不覆盖旧版。

版本记录见 [CHANGELOG.md](CHANGELOG.md)。

👤 作者 / 联系

马甲（@maojiebc） · 超级马甲

如果这份 skill 帮到你，欢迎在以下任意渠道找我交流踩坑实录、提需求、报 bug，也欢迎勾兑用户运营 / 数据中台 / BI 工程的实战经验：

| 渠道 | 链接 | |---|---| | 📧 Email | [m9224@163.com](mailto:m9224@163.com) | | 🐙 GitHub | github.com/maojiebc | | 🪝 ClawHub | clawhub.ai/p/maojiebc | | 🐦 X | @maojiebc | | 📕 小红书 | 超级马甲 | | 📰 微信公众号 | 超级马甲 |

> 这份 skill 是 14 年用户运营 + 数据中台 + BI 工程实战沉淀出来的，问题/合作随时聊。

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: maojiebc
• Source: maojiebc/majia-chatcut-koubo
• License: MIT

Install and usage instructions live in the source repository linked above.