Reels(卡片格式)
将说话录制视频转换成竖屏短视频,其中每个要点都以一张卡片形式显示在屏幕上方。 工作流程如下:
- 工具 负责测量音频并进行剪切(
yatay-kurgu技能的转写/剪辑工具)、绘制卡片和字幕、平衡音频,并对最终结果进行测量。 - 你(Claude) 阅读转写稿,选择要删除的部分,确定每张卡片在哪个词汇处出现并写入
senaryo.json,然后检查控制图像。
你无需输入秒数:卡片绑定到所说的词汇;即使剪辑发生变化,卡片也会保持原位。
准备工作
ffmpeg在 PATH 中,Python 依赖通过仓库根目录下的kur.sh安装。命令中使用.venv/bin/python作为 Python 解释器(Windows 使用.venv\Scripts\python)。不需要支持 libass 的 ffmpeg:字幕使用 Pillow 绘制。- 使用同一仓库中其他两个技能的工具,不修改它们:
yatay-kurgu(精确的转写 + 音频剪辑)和x-animasyon(whoosh 和键盘音效合成)。 - Whisper 模型在首次运行时下载(large-v3 ≈ 3 GB);下载前告知用户。
- 字体仅使用仓库根目录下的
fontlar/(OFL 协议):Inter、Newsreader、IBM Plex Mono。 - 每个任务位于自己的文件夹中:
calisma/reels/<名称>/。原始录制文件为只读权限。
以下 R = .venv/bin/python .claude/skills/reels/araclar/reels.py,P = calisma/reels/<名称>。
循环
1. 转写。
R dokum P --video kayit.mp4 [--bas 56 --sure 42] [--terimler "视频专属术语"]
如果录制较长而 Reels 只截取其中一部分,使用 --bas/--sure 指定窗口(片段将输出为 P/kaynak.mov,原始文件不变)。目标:35-45 秒的输出。
2. 阅读转写稿,进行剪辑。 从头到尾阅读 P/dokum.md(遵循 yatay-kurgu SKILL.md 中的规则)。停顿和连续重复已自动删除;你需要将以下内容写入 P/atilacak.json,每行附上理由:
- 重新开始(保留最后一次尝试)、剪辑注释(“我将删除这一段”)、说错并纠正的数字;
- 听不清的词语:在两个版本中都模糊不清的部分不添加到字幕中,直接删除(使用
.venv/bin/python .claude/skills/yatay-kurgu/araclar/kurgu.py pencere P <秒>重新解析); - 对 Reels 来说多余的离题内容:属于内容决策,询问用户。
根据音频确定剪辑点:按 dokum.md 的行边界写出区间,工具会将该点对齐到 ±0.2 秒内的最静音帧。然后运行:
R kurgu P # 重新构建剪辑计划
R kelimeler P # 剪辑中保留的词汇及其输出时间(从此处选择锚点)
3. 剧本:P/senaryo.json。 示例:ornekler/reels/senaryo.ornek.json。字段列表和卡片类型见:references/kartlar.md。
{"vurgu": ["effort"], "kuyruk": 2.0, "vuruslar": [
{"duzen": "yuz"},
{"kelime": "Önce", "kart": {"tur": "liste", "baslik": "Sıra", "isaret": "sayi",
"maddeler": [{"yazi": "Modeli seç", "kelime": "modeli"}, {"yazi": "Effort'u seç", "kelime": "effort"}]}},
{"kelime": "oynattım", "ofs": 0.5, "duzen": "grafik", "kart": {"tur": "soru", "soru": "Sen hangisini kullanıyorsun?"}}
]}
- 拍(Vuruş) = 屏幕的一种状态。
kelime锚点指向词汇的起始位置(例如 "effort" -> "effort'unu"),并从前一个拍之后查找;可以有多个词汇(如 "plan modu"),kac表示第几次出现,ofs为偏移秒数。第一个拍从 0 开始。卡片中的项目/行/消息也通过各自的kelime进入。 - 布局:
bol(卡片在上,面部在下;这是有卡片的拍的默认布局)、yuz(全屏面部;无卡片时的默认布局)、grafik(全屏卡片,无面部)。 - 节奏: 每个拍 1.5-4 秒;40 秒的 Reels 中约 10-15 个拍。钩子(前 1-2 秒) 以面部开场。
- 面部仅出现在说话人看向摄像头的位置。 如果说话人看着屏幕或文字说话,则该拍使用
grafik布局。 - 禁止虚构: 卡片仅显示真实说的内容或真实发生的事件。不要写未测量的数字、不存在的命令、虚构的屏幕文字。屏幕截图必须使用用户的真实文件(
gorsel)。 - 结尾: 最后一个拍应使用
soru卡片(提出一个问题,提示用户在评论区写下答案);说话结束后,屏幕保持kuyruk(秒)时长(因此选择grafik布局,这样在结尾停留期间画面静止)。 - 字幕中听错的词:使用
"altyazi_duzelt": {"aranaya": "arenaya"}。vurgu列表中的词汇在字幕中以斜体+强调颜色显示(提供词根即可,如 "effort")。
查看解析后的时间:运行 R vuruslar P(每个拍的开始/结束时间、元素时间;如果某个元素在不可见的情况下切换卡片,会发出警告)。
4. 取景框。
R yuz P # 面部框估计 -> P/kadraj.json + P/kontrol/kadraj.jpg
使用 Read 打开 kontrol/kadraj.jpg:绿色方框应包围面部(从前额到下巴);蓝色为 bol 布局的裁切框,橙色为 yuz 布局的裁切框。该估计不基于模型(肤色 + 中心优先);背景中接近肤色的表面、多个人物或彩色灯光可能导致错误。如果错误,请根据标尺上的原始像素手动修正 kadraj.json 中的 kutu,然后运行 R yuz P 更新图像(不会覆盖已有的 kadraj.json)。如果人物在移动,则添加 anahtarlar(带时间戳的方框)。
5. 预览,然后渲染。
R kare P # 每个拍抽取一帧 -> P/kontrol/kareler.jpg(检查)
R kare P 2.3,31.4 # 特定时刻(入场动画、正在输入的终端)
R render P # -> P/cikti/<名称>.mp4,渲染结束后自动运行测量
6. 测量(你无法观看,通过测量数据检查)。 R olc P(渲染结束时自动运行)-> P/kontrol/olcum.md + P/kontrol/temas.jpg:
- 时长: 视频和音频长度相同,帧数与预期一致。
- 安全区域: 每隔 5 帧测量一次字幕、卡片和面部的像素框。Instagram 界面覆盖顶部 y<220 区域、底部 20%(y>1536)区域和右侧点赞/评论列(x>940, y 1000-1536);字幕和卡片不得进入这些区域,面部保持在底部 20% 以上。如果出现违规行,则修正剧本(卡片内容、布局)或
kadraj.json。 - 音频: 最终文件达到 -14 LUFS,真实峰值 <= -1 dBTP;音效轨道比语音低约 15 dB;whoosh 峰值是否对齐到剪辑点。
- 接触页: 每个拍的卡片填充状态(切换前瞬间)。打开并检查:是否有文字溢出、元素重叠、头部被切、卡片空白。
- 拼接检查(可选):
.venv/bin/python .claude/skills/yatay-kurgu/araclar/kurgu.py dogrula P重新解析剪辑音频,报告不连贯或泄漏的词汇(P/dogrula.md)。
修正后只需运行 R render P(从头开始渲染音视频,在 M1 Pro 上 40 秒视频约需 35 秒)。
7. 交付。 向用户提供简短的数字报告:输出路径、时长(原始 -> 剪辑)、拍/卡片数量、删除的内容及其理由、安全区域结果、LUFS/峰值、接触页路径。对于无法测量的内容(音频的悦耳度、卡片的清晰度),明确交给用户判断。
已知限制
- 面部框为无模型估计;每个录制都必须检查
kadraj.jpg。不提供逐帧面部追踪:仅使用固定框或关键帧之间的线性过渡。 - 从横屏录制中提取的全屏面部(
yuz布局)受限于源的高度:4K 视频中面部可能过大,字幕会自动下移到下巴下方。在bol布局中,面部卡片的高度会根据面部下方源图像中剩余的内容缩短(以防止下巴进入底部 20% 区域)。 - 无背景音乐;音效为合成(whoosh、键盘、嘭、刮擦声)。
- 卡片类型固定(见 references/kartlar.md)。要添加新类型:在
araclar/kartlar.py中添加绘制和音效函数,并注册到CIZ和OLAY字典中。 - 界面区域(顶部 220 像素、底部 20%、右侧列 x>940)是针对 Instagram Reels 的近似保守值(定义于
araclar/cizim.py开头);对于 Shorts/TikTok 类似但不完全相同。