| name | majia-chatcut-koubo |
| description | ChatCut 口播/录屏视频代理剪辑的可验证生产系统——官方 ChatCut skill 之上的增量层。覆盖双画面版式、主题配色、过渡、人脸取景与字幕门禁，以及 Rule Registry、Creator OS IR/Rational Time、SRT 与可解释规划、预览审批、可恢复 fake adapter/证据链、本地 Media QA/导出授权、多平台交付包、反馈治理、capability live gate，并可按需查询 198 份来源剪辑百科或调用受约束的外部镜头配方。触发：ChatCut 剪口播、直播切片、竖版重构、字幕纠错、批量规划、预览审批、恢复执行、媒体 QA、交付审计、口播剪辑技巧检索、外部 Remotion MG。前置：需官方 ChatCut skill / MCP。边界：真实 ChatCut adapter、真实媒体探针/渲染与平台发布须另有当前环境证据，本 skill 不自动执行。 |
| metadata | {"version":"1.5.0"} |
ChatCut口播 · 马甲实战版
ChatCut 口播剪辑的可验证生产系统。它把 ChatCut 当作最终可继续手工调整的非线性编辑器，把规则、内容计划、审批、执行、证据、媒体 QA、交付和反馈放进同一条 fail-closed 流程。
与官方 skill 的分工
ChatCut 插件自带官方 skill（plugin-basics / talking-head-guide / transcription / verification / known-errors / create-motion-graphics 等），工具怎么用一律以官方为准，参数以当前 MCP 工具实时描述为真相源。
本包只写官方没有的：剪成什么样算好（版式、配色、动效节奏、构图标准）、如何安全完成（规则/IR、审批、幂等恢复、证据和发布授权）、实测踩坑护栏（坐标系陷阱、fps 错位、验证方法）、可复用资产与可选外挂资源包。与官方重复处以官方为准；外挂只能扩大候选，不能改变工具真相或硬规则。
当前生产闭环
- 规则与计划：Rule Registry 保护 hard policy；Creator OS IR、Rational Time、SRT sidecar、Explainable Planner 和 Visual Decision Contract 统一内容、时间、owner、revision、候选评分与证据引用。低于自动门槛的视觉候选只转人工复核，不伪装成可执行结论。
- 审批与执行：代表窗口 preview approval 精确绑定 scope/fingerprint；recoverable executor 用 fake adapter 验证幂等、写后回读、补偿、checkpoint/resume 和 evidence 失效传播。
- QA 与交付：Media QA 报告审计最终 artifact、音画/隐私和导出授权；distribution pack 绑定母片/content truth，
publishAction=none。
- 反馈与真实环境：反馈只进入受治理建议队列，不在线改 hard policy；capability profile 缺少当前 build/schema/probe/canary 时保持
liveAllowed=false。
当前边界：离线 Schema、匿名 fixture、fake adapter 和报告审计已验证；真实 ChatCut adapter、真实媒体探针/渲染和平台发布仍需外部环境证据，本 skill 不会自动执行这些动作。
实战经验库读写协议（迭代硬闸）
03-实操迭代与踩坑/ 是案例级、追加式的实战经验库，保存尚未全部晋升为正式规则的现场事实、失败链、产品问题、绕行方案和证据等级。它与 02-剪辑方法手册/ 的分工是：
03-实操迭代与踩坑/ 保留「一次任务实际发生了什么」，允许包含未决问题、相互矛盾的宿主表现和产品反馈。02-剪辑方法手册/ 只收录已跨案例复验、可以指导下一次生产的稳定结论。rules/ 只收录可机器执行、带反例和回滚条件的 hard policy。
每次更新本 skill 或处理命中案例标签的真实 ChatCut 任务时，必须：
- 先完整读取
03-实操迭代与踩坑/README.md 和命中标签的案例；不得只凭摘要引用结论。
- 在
03-实操迭代与踩坑/迭代记录.md 追加读取回执：读了哪些案例、吸收了什么、拒绝了什么、哪些证据仍不足。
- 任务结束后把新事实追加到既有案例或新建案例；原记录不静默改写，纠错用
supersedes 或修订段落说明。
- 只有重复样本、证据和反例齐备时，才把结论晋升到
02-剪辑方法手册/ / rules/；一次事故不得直接变成全局 hard policy。
- 经验可以持续累积而不立即发布正式版本；积累到一批再统一升级版本，但读取回执和案例记录不能等到发版才补。
- 公开仓只写脱敏事实：不提交真实项目 ID、签名下载链接、用户本机路径、字幕正文、私有词表、真实业务敏感数字或人物素材。
五条第一性原则
- 内容真相：成片的实际音频和当前时间线是唯一真相；装修不改写源区间、顺序、速度、主音频或字幕时序。
- 单一合成所有权：同一帧的录屏几何、人物几何和外框只由一个稳定态或一个转场 owner 接管；白块、重复人物、孤儿框、叠加溶解都是所有权冲突。
- 时间原子性：状态用半开区间
[start,end)；录屏、人物、框线同边界提交；媒体跨态先拆分，不按 item 起点猜状态。
- 证据优先：画面变化由「隐私 → 屏幕证据 → 人物强调 → 字幕负载 → 新鲜感」决定；时间只提醒复查，不驱动机械轮播。
- 量化门禁：工具成功不是完成。结构、字幕、音频、像素各有明确结果；无法看或听时标
unverified，不得用结构结果顶替试听或像素证据。
通用工序
- 同步与规格：多机位
multicam_sync；只留一个主音轨（讲解人 anchor，重复轨优先 mute/disable，宿主不支持才 -60dB 降级）；冻结画幅、fps、采样率。
- A-roll 内容：按官方 talking-head-guide，删减增量见
02-剪辑方法手册/01-逐片执行手册.md；一句话原则——删声音比删意思安全，错删信息的代价高于漏留口癖。
- 剪后转写与字幕：删除/重排/变速后必须刷新剪后转写；字幕见
02-剪辑方法手册/07-字幕与术语.md——第一步永远是查字幕源绑定（挂在翻译变体轨上=P0，先切回原文源）。开工先扫素材目录找用户精校逐字稿：有则它是字幕文本唯一真相源，禁止在 ASR 错词上自行猜测修正（数字吞位/繁体/专名是 ASR 三大高发）。
- 样片闸门（渐进交付）：横版先做开头约 18–23 秒、竖版 20–30 秒样片，确认后才批量；长片（>5 分钟）升级为 60 秒预览闸——先把开头 60 秒做成全层完成态（剪辑+状态机+过渡+字幕+包装+隐私），请用户播放验收，通过后才向后推进；批量中每完成一幕渲染抽查帧，不整片铺完才验。**验收单元 = 完整成片体验（画面+动画+字幕+隐私），字幕修正随幕完成，不设整片末尾统一校对环节。**任何一项失败先修样片，不批量复制错误。
- 画面结构：双画面版式与七执行状态见
02-剪辑方法手册/02-双画面版式.md；人脸取景见 02-剪辑方法手册/06-人脸取景与三层合成.md；批量切片与逐片精修先读 02-剪辑方法手册/01-逐片执行手册.md。
- 动效与包装：字幕锁定后才做过渡、B-roll、MG；过渡工程见
02-剪辑方法手册/05-过渡动效.md；配色见 02-剪辑方法手册/03-主题配色.md。需要补充方法候选或外部镜头配方时先读 02-剪辑方法手册/11-外挂知识包与镜头配方.md：百科只作 advisory，Shotcraft 只允许锁定 revision 的白名单卡片，且不得越过唯一合成 owner、证据和回退合同。静态章节卡单调时，可由外部 MG 工具（如 hyperframes）产 MP4 后 import_media 替换；音效/BGM 走 ChatCut 素材库与生成工具，音量不夺 anchor。
- 验收：结构回读 + 合成像素 + 实际试听三证齐才算完成；帧率以 ffprobe 读实际导出文件为准。请用户播放验收时按
02-剪辑方法手册/09-ChatCut宿主实测.md 双端预览路由：本地 ChatCut Mac 客户端优先 → 未装提示一次可下载（不强推）→ 浏览器兜底（明示网页端可能卡顿）；代理自己的像素证据始终 = 云端渲染帧。
成片红线
- 字幕：简体、来自真实语音转写、按完整语义与气口分卡；默认单行，完整语义在安全宽度内确有需要时允许两行，禁止把固定字数或自动换行位置当成时间分段点；用户提供精校逐字稿时，精校稿是文本唯一真相源，禁止在 ASR 错词上自行猜测修正；行尾逗号不显示，句末标点保留；发布硬规则以
rules/policy.json 为准（profile 只能校准不能放宽），发布态跑 scripts/validate-caption-pages.mjs --strict，退出码非 0 = 未完成。
- 内容：重说默认删前保后；重排只搬完整语义单位，不拼出说话人没说过的话；默认自然结束，不加模板片尾。
- 画面：PiP 不拉伸；正圆以裁后可见区判定（
visibleWidth = width × (1−cropLeft−cropRight)），改外框时保留旧 crop = 二次裁切事故；人物层保留完整源画幅，效果顺序 reframe → mask；任一精确帧露黑边即撤销整段动态取景；框线不穿人物；二维码等隐私信息全时间范围不可见，部分遮挡=失败。
- 工程：30fps 时间线可能 60fps 导出，MG 一律按秒或归一化帧率计时；写入宣称成功≠落盘（回读 FX 实例）；素材池有资产≠时间线有实例。
- 协作：用户已验收的设计是受保护基线，删除、降级、明显改变必须先问——连续兜底失败也不例外；同一可见缺陷第二次出现=停止逐片补丁，修共享根因并全量回归。
确认闸门
- 状态表先行（硬闸）：画面结构批量落库前，必须先产出全片状态表（stateId｜[start,end)｜三层参数｜进出过渡｜隐私｜语义理由）并请用户过目；无状态表禁止批量
edit_item。上下文压缩后不凭摘要续做画面结构——先回读状态表与命中分册再动手。
- 高风险删除：批量前确认代表性切点。字幕：样片窗口确认后扩展。视觉方向/配色/包装风格：先出 2–4 个可选方案让用户点选，不给单方案硬推，不代替用户拍板审美。
- 导出：用户开口才导出；短导出授权按本轮措辞记录范围，不外扩、不跨任务。
- 自动修复最多连续三轮，每轮要有新证据；仍失败就停，保留最近可用版本，产出带证据帧的交接文档可请外部 AI 复核。
按需加载路由表
| 任务信号 | 完整读取 |
|---|
| 批量切片、逐片精修、验收门禁、八道硬闸、A-roll 删减细则、多代理调度、生成资产纪律 | 逐片执行手册 |
| 双画面构图、版式选型、七执行状态、状态原子契约、圆窗/分栏/上下屏、小窗腾挪 | 双画面版式系统 |
| 主题配色、字幕底板、对比度、按角色用色、图表色板 | 主题配色系统 + 选定主题的 assets/theme-kit/playbooks/<id>.md |
| MG/设计图形加不加、加哪种、画面任务路由 | 信息块类型与选用 |
| 过渡动画、状态切换、闪烁/黑块排查、fps 归一化 | 过渡动效工程 |
| 人脸居中、内部取景漂移、蒙版参数、黑边排查 | 人脸取景与三层合成 |
| 字幕气口、术语纠错、词表维护、字幕门禁 | 字幕与词表 |
| 信息流切片开头钩子、完播、中段节奏、结尾、四平台路由 | 留存结构剪辑 |
| ChatCut 宿主实测坑：crop 语义、两步提交、编辑器/云端渲染差异、MG 媒体槽失效、窗口 reframe shader、字幕分页引擎、音频层基线、隐私扫描 SOP、双端预览路由 | ChatCut 宿主实测行为档案 |
| 真实项目复盘、ChatCut 产品问题、编辑器与代码/云端画面不一致、外部 MG/Hyperframes、共享模板缓存、导出长任务 | 实战经验库 + 命中标签的案例 |
| 连接报错、OAuth 失效、打开既有项目、转写挂死、上下文压缩恢复 | 故障恢复手册 |
| 查询 198 份来源剪辑百科、检索知识卡/规则/来源、选择或验证 Video Shotcraft/Remotion 外部 MG 配方 | 外挂知识包与镜头配方 + extensions/ |
可复用资产：assets/compositions.json（8 版式坐标快照）、assets/theme-kit/（8 主题 token+SVG 底图+可运行组件）、extensions/cuttips-kb/（198 来源、48 知识卡、14 规则的随包查询层）、extensions/video-shotcraft/（锁定 revision 的外部镜头白名单与检查器）、templates/（词表/实测参数/宿主兼容契约模板 + 本地个人层模板，装进你自己的数字）、rules/policy.json（不可由 profile 放宽的字幕发布策略）、schemas/（source/resolved profile、字幕、视觉决策、词表、兼容、资产与外挂契约）、src/cli/resolve-profile.mjs（profile 继承解析与来源追踪）、scripts/validate-caption-pages.mjs（字幕机械校验）、scripts/validate-visual-decision-plan.mjs（视觉候选评分/证据/审批 gate）、scripts/validate-extensions.mjs（外挂来源、checksum、引用、脱敏和白名单 gate）。发布前统一跑 npm run verify。
让它变成你自己的（本地个人层契约）
本包的数字（22 字/行、330px 圆窗、magnification≈0.30）是作者素材上的实测起点，不是跨素材真理。个人化的正式机制是本地个人层 ~/.config/majia-chatcut-koubo/：
- 探测与叠加：每次开工先探测该目录；存在则把其中内容叠加在本包通用规则之上——
profile/*.json（个人版式与字幕实测数字，覆盖 assets/compositions.json 与模板同名键）、terminology.json（个人词表，validator 用 --terms 指向它）、aesthetics.md（个人审美基线，审美分歧时先读）、local-notes.md（个人补充护栏）。目录不存在就只用包内通用值，不报错。
- 起模：把
templates/local-config-example/ 整体复制为 ~/.config/majia-chatcut-koubo/，在你的素材上做样片，把验证过的数字、品牌词表和审美偏好填进去。
- 边界：品牌实词、真实业务数字、个人路径只进本地层，永不进 git、永不进公开仓；本地 profile 只能校准参数，不能放宽
rules/policy.json 的发布硬规则。数字变了就升版本存新文件，不覆盖旧版。
📋 版本记录
- v1.5.0（2026-07-25）：新增可选外挂层：把 198 份公开来源蒸馏为随包可查询的 48 张知识卡、14 条规则和来源索引；把 Video Shotcraft 接成锁定 commit、Apache-2.0 声明、8 卡白名单、可验证本地 checkout 的外部镜头提供器。外挂只产生 advisory 候选，硬规则、内容真相、证据、唯一合成 owner、审批和回退继续优先；新增专项校验并进入
npm run verify。
- v1.4.1（2026-07-24）：新增 Visual Decision Contract 与 4 条视觉决策规则，低分候选转人工且生成图不得冒充证据；同时新增追加式
03-实操迭代与踩坑/ 实战经验库、迭代前必读和读后留痕协议，首个案例记录 AI Hero 母片精修失败链、三证据面与 7 条 ChatCut 产品问题。
- v1.4.0（2026-07-24）：升级为可验证生产系统；交付 Rule Registry、Creator OS IR/Rational Time、SRT/可解释规划、预览审批、可恢复执行与证据、Media QA/导出授权、受治理交付包、反馈治理和 capability live gate；真实适配器/媒体探针/平台发布仍明确未验证且不自动执行。
- v1.3.1（2026-07-24）：契约止血与可复现发布地基；Node/lockfile/CI、离线 JSON Schema、source/resolved profile、字幕 P0、资产/对比度/版本漂移门禁。
完整变更历史见 CHANGELOG.md 或 GitHub Releases。
👤 作者 / 联系
马甲（@maojiebc） · 超级马甲
如果这份 skill 帮到你，欢迎在以下任意渠道找我交流踩坑实录、提需求、报 bug，也欢迎勾兑用户运营 / 数据中台 / BI 工程的实战经验：
这份 skill 是 14 年用户运营 + 数据中台 + BI 工程实战沉淀出来的，问题/合作随时聊。
