# Majia Chatcut Koubo

> ChatCut 口播/录屏视频代理剪辑的通用技巧包——官方 ChatCut skill 之上的增量层。覆盖：双画面版式（横竖版 8 套坐标）、8 套主题配色与对比度档位、过渡动效工程（四档可靠性链/端点契约/fps 归一化）、人脸居中与内部取景（三层合成/reframe→mask 顺序/坐标系陷阱/overscan 公式）、中文气口字幕与可自维护词表模板、机器化字幕门禁脚本。触发：ChatCut 剪口播、直播切片、画中画/圆窗、主讲人过渡动画、竖版重构、字幕气口、术语纠错、主题配色。

- **Type:** Skill
- **Install:** `agentstack add skill-maojiebc-majia-chatcut-koubo-majia-chatcut-koubo`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [maojiebc](https://agentstack.voostack.com/s/maojiebc)
- **Installs:** 0
- **Category:** [Content & Media](https://agentstack.voostack.com/c/content-and-media)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [maojiebc](https://github.com/maojiebc)
- **Source:** https://github.com/maojiebc/majia-chatcut-koubo

## Install

```sh
agentstack add skill-maojiebc-majia-chatcut-koubo-majia-chatcut-koubo
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# 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](https://github.com/maojiebc) |
| 🪝 ClawHub | [clawhub.ai/p/maojiebc](https://clawhub.ai/p/maojiebc) |
| 🐦 X | [@maojiebc](https://x.com/maojiebc) |
| 📕 小红书 | [超级马甲](https://xhslink.com/m/4fQMJeHHWKC) |
| 📰 微信公众号 | **超级马甲** |

> 这份 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](https://github.com/maojiebc)
- **Source:** [maojiebc/majia-chatcut-koubo](https://github.com/maojiebc/majia-chatcut-koubo)
- **License:** MIT

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

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/skill-maojiebc-majia-chatcut-koubo-majia-chatcut-koubo
- Seller: https://agentstack.voostack.com/s/maojiebc
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.