Communitygithub.com

geniusdapeng-collab/WorkLoom-video-edit

开场钩子官方套件(开场钩子设计师专业套件):8 类钩子类型库与判据、前 3 秒首镜模板(画面/首句/音效三线同拍)、钩子音效清单(0–0.6s 窗口)、承诺兑现与反标题党纪律、平台窗口口径;含决策原则 7 条(阈值与失败关闭)、四种素材形态打法、五步 SOP(触发/回执/失败路径)、关键指标与失败模式表。安装后被开场钩子设计师调用;绑定围栏 G6/G7,卸载即撤销。

WorkLoom-video-edit란 무엇인가요?

WorkLoom-video-edit is a Claude Code agent skill that 开场钩子官方套件(开场钩子设计师专业套件):8 类钩子类型库与判据、前 3 秒首镜模板(画面/首句/音效三线同拍)、钩子音效清单(0–0.6s 窗口)、承诺兑现与反标题党纪律、平台窗口口径;含决策原则 7 条(阈值与失败关闭)、四种素材形态打法、五步 SOP(触发/回执/失败路径)、关键指标与失败模式表。安装后被开场钩子设计师调用;绑定围栏 G6/G7,卸载即撤销。.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/geniusdapeng-collab/WorkLoom-video-edit/tree/HEAD/bundles/ai-video/skills/opening-hook-craft

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

开场钩子(前 3 秒)

短平台上,完播率的分水岭在前 3 秒:第 1 秒听不懂、不相关、没冲突,观众就走了。 但"开头要抓人"这类形容词无法评审、无法回归、无法沉淀。本套件把钩子做成可校验的产物:

钩子卡 = { type, promise, payoffShotId, firstShotTemplate{visual,line,lineSec}, sfx{kind,atSec,gainDb}, rationale }

写进 shotlist.json 顶层 hook,由管线做确定性判据(packages/video-studio/src/opening-hook.ts): 类型在库内、承诺有兑现镜、首镜够长、承诺在首镜说出口、钩子音落在 0–0.6s。

适用场景

  • 短视频/信息流开场 3 秒的设计与评审(8 类钩子选型 + 首镜三线同拍)
  • 已有成片但完播掉头严重,需要判定"是不是钩子的问题"
  • 同一支片子派生多平台版本时的开场窗口适配

触发条件

  • 管线进入片头设计(opening.design),或监制/连贯审查官对开场提出打回意见
  • 开场被判定为口号型、慢热型、标题党或音效抢戏(见失败模式表)
  • 平台窗口或首镜时长与钩子冲突时,必须先改钩子再进渲染,不得带病出片

决策原则(含阈值与失败关闭)

  1. 一镜一类型:type 取 8 类之一且唯一;叠两个类型等于没有钩子(观众只记得住一个)——命中即回退重选。
  2. 首句 ≤18 字、≤3.5 字/秒:超过阈值即念不完;首句说完之前不许换镜(画面与配音同拍)。
  3. 首镜 ≥2.5s(短平台):低于阈值钩子会被切在两镜之间 → 硬失败,先改镜头时长再谈钩子。
  4. 钩子音落在 0–0.6s:越窗直接抛错(sfx-synth.ts#planHookSfx);与剪辑点音效冲突时钩子音优先,被挤掉的音效记进证据(不静默丢)。
  5. 承诺必须可兑现:promise 与 payoffShotId 缺一不可;兑现镜不存在属硬失败,"与承诺字面不重叠"只作软提示(疑问型靠回应兑现)。
  6. 反标题党一票否决:数字必须可验证、承诺必须讲完;"效率提升 100 倍"这类不可验证数字直接打回,不协商。
  7. 失败关闭:类型不在库内 / 无兑现镜 / 首镜过短 / 音效越窗,任一命中即视为未完成——不产出钩子卡,也不许用近似类型或后期字幕补救。

打法库(场景 → 动作序列 → 判据)

  • 主线(有可视素材):选出可指认的画面事实 → 定钩子类型 → 写首镜三线(画面/台词/声音)→ 绑兑现镜 → 出钩子卡。判据:类型在库内、首句合规、兑现镜存在。
  • 分支 1(只有口播、无强视觉):以 question / benefit / number 为主,首镜用人物半身 + 一个具体数字或问题;禁用 scene-shock(没有强现场硬凑会假)。判据:不听画面也能听懂首句。
  • 分支 2(有结果素材:数据/成品/现场):优先 result-first,先给结果再回述过程。判据:结果画面与正片主线相关(不相关的"漂亮空镜"判失败)。
  • 分支 3(产品/带货):以 benefit 或 counterintuitive 开场,卖点只留 1 个进首镜,其余留给正片。判据:承诺可被正片兑现、无绝对化用语(合规预检通过)。

SOP(每步带触发/回执/失败路径)

  1. 触发:片头设计任务到达 → 动作:盘点可用素材(人物/场所/结果/数据)→ 回执:素材清单 + 候选钩子类型 → 失败:无可用素材 → 退回补拍或改走分支 1,不得硬编钩子。
  2. 触发:类型确定 → 动作:写首镜三线并按阈值自检(≤18 字、≥2.5s、0–0.6s)→ 回执:首镜模板 + 自检结果 → 失败:任一阈值不过 → 改稿重写,不带病进下一镜。
  3. 触发:首镜定稿 → 动作:指定兑现镜并与承诺逐字/语义对照 → 回执:承诺—兑现映射(promise ↔ payoffShotId)→ 失败:找不到兑现镜 → 换钩子(禁止改成正片做不到的承诺)。
  4. 触发:兑现闭环 → 动作:出钩子卡 + rationale(为什么这个类型匹配这批素材)→ 回执:shotlist.json.hook + 评审结论 → 失败:rationale 写不清 → 视为选型未完成,回到第 1 步。
  5. 触发:钩子卡入片 → 动作:钩子音落地并检查是否盖住首句 → 回执:音效落点/增益 + 是否挤占剪辑点音效的证据 → 失败:盖住首句 → 降增益或移后,重出该镜。

关键指标(含基准与护栏)

指标基准/参考值阈值/护栏来源
首句字数≤18 字超过即重写本套件决策原则 2;opening-hook.ts
首句语速≤3.5 字/秒超过即念不完(配音实测)本套件决策原则 2;配音时长实测
首镜时长≥2.5s(短平台)低于即硬失败本套件决策原则 3;真机打回记录
钩子音窗口0–0.6s(默认 0.08s / −11dB)越窗抛错sfx-synth.ts#planHookSfx
兑现镜1 个且与承诺语义一致缺失=硬失败本套件决策原则 5;钩子审计
类型唯一性1 个类型叠加视为无钩子本套件决策原则 1
钩子相关打回≤1 次/片超限复盘选型监制/连贯审查官回执

失败模式(症状 → 检测器 → 处置)

症状检测器处置
口号型开场("家人们,今天这个太炸了")钩子卡无 promise / 类型不在库内换类型(多为 question/benefit)并重写首句
慢热型(前 3 秒空镜,人物第 5 秒才出场)首镜时长与人物入画时间检查把人物与场所提到首帧,重出首镜
标题党(承诺三个方法只讲一个)承诺—兑现映射核对换钩子或补兑现;禁止改成正片做不到的承诺
数字编造("效率提升 100 倍")数字可验证性检查换成有出处的真实数字,否则删掉
音效抢戏(开场音盖住首句)增益与首句窗口比对降增益或移后,重出该镜
首镜被切在两镜之间首镜时长 <2.5s 检查延到 ≥2.5s 或把钩子并入下一镜重写

8 类钩子类型库(选一个,不叠类型;判据见 opening-hook.ts)

类型结构适配素材判据(不合格长什么样)
question 疑问把观众心里的话先说出口有痛点、有共识话题"今天给大家分享…"这种没有问题的疑问
conflict 冲突当场呈现一个对立/矛盾有对比素材(前后、正反)只描述现状、没有对立面
counterintuitive 反常识先否定一个共识,再给依据有反直觉结论与证据否定了却不给依据(等于标题党)
benefit 利益点先说观众能拿走什么工具/方法类内容承诺"改变命运"这类兑现不了的
result-first 结果前置先给结果画面,再回述过程有可视结果(数据/成品/现场)结果画面与正片无关
suspense 悬念给出未完成的信息缺口有过程性悬念悬念到片尾也没解答
number 数字一个可验证的数字立信有真实数据编数字、用"100 倍"这类无法验证的
scene-shock 画面冲击先给最有辨识度的画面事实有强视觉现场只有空镜好看、与人无关

纪律:一镜一类型。叠两个钩子等于没有钩子(观众只记得住一个)。

前 3 秒首镜模板(三线同拍)

0–3 秒必须同时完成三件事,任何一条缺席都会掉完播:

线内容口径
画面线一个人 + 一个可指认的真实场所 + 一个动作不用空镜开场;人物第 1 秒入画;环境按场景圣经给实指(见 docs/environment-realism.md)
台词线首句 = 钩子的原话(≤18 字,≤3.5 字/秒)疑问型就以问句开场;利益型先给"你能拿走什么"
声音线钩子音效 impact(-11dB 量级)落在 0.08s 附近与画面同拍;不盖首句;不是"音效秀"

首镜时长:短平台 ≥2.5s(否则钩子会被切在两镜之间);首句说完之前不许换镜。

承诺兑现(反标题党)

钩子卡里的 promise 必须在正片被回应:

  • question / suspense:正片有一镜用台词正面回应("别再买工具,你缺的是一支班组");
  • 其余类型:兑现镜要真的出现承诺里的事物(数字、结果画面、对比)。

兑现不了就换钩子,不许改成正片做不到的承诺。真机口径:钩子审计里"兑现镜不存在"是硬失败, "兑现镜与承诺字面不重叠"只作软提示(疑问型钩子靠回应兑现,不靠字面重复)。

钩子音效(0–0.6s 窗口)

平台默认音色起点增益说明
抖音 / 快手 / 视频号 / 小红书impact0.08s−11 dB一记低频冲击,把注意力"钉"在第一帧
B 站 / YouTube / 线下投屏whoosh0.12s−13 dB长视频不需要抢拍,气流声更自然

规则(sfx-synth.ts#planHookSfx):越出 0–0.6s 窗口直接抛错;与剪辑点音效冲突时钩子音优先, 被挤掉的剪辑点音效记进证据(不静默丢)。音效全部由 ffmpeg 合成,无第三方采样。

交付前自检清单

  1. 类型是什么?为什么这个类型匹配这批素材?(写进 rationale)
  2. promise 一句话说得清吗?正片哪一镜兑现、怎么兑现?
  3. 首句多少字、多少秒念完?与首镜画面同拍吗?
  4. 钩子音落点(秒)与增益?会不会盖住首句?
  5. 首镜时长够吗?钩子会不会被切在两镜之间?
  6. 把钩子拿掉,前 3 秒还剩什么?(如果什么都不剩,说明钩子就是唯一的价值点,别删)

常见反例(真机/评审打回)

  • 口号型:"家人们,今天这个太炸了"——无信息量,不算钩子;
  • 慢热型:前 3 秒空镜 + 环境交待,人物第 5 秒才出场;
  • 标题党:承诺"三个方法",正片只讲一个;
  • 数字编造:用"效率提升 100 倍"这类无法验证的数字;
  • 音效抢戏:开场音盖住首句台词(监制会以"听不清台词"打回)。

输出契约

  • 输出:shotlist.json 顶层 hook 钩子卡(type / promise / payoffShotId / firstShotTemplate / sfx / rationale)。
  • 随交付附:兑现镜 ID、首镜三线与阈值自检结果、钩子音落点与增益。
  • 判据由 opening-hook.ts 确定性执行;工具未跑或判据数据缺失时按失败关闭处理,不得宣称钩子合格(无回执=未核实)。

边界

  • 不改叙事与脚本内容(属剧本师/创意策划);本技能只负责"前 3 秒怎么开口"。
  • 不替监制做人审结论:钩子卡是评审材料,不是放行结果。
  • 不做字幕与封面(属字幕工位/封面设计);平台窗口差异只影响开场呈现,不改画面事实。

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

geniusdapeng-collab/WorkLoom-video-edit

配乐交付规范官方套件:原节目默认来源、显式独立分轨授权、单次实际混音、曲目许可与字节证据,完整平台/电平/选段工艺参数和用户返修归因。成功源镜不经声音品质复检,不按余量/可闻度/卡点分数自动重试或降级;绑定 G-BGM0..G-BGM5,卸载即撤销。

geniusdapeng-collab/WorkLoom-video-edit

曲库与许可合规官方套件(随 bundles/ai-video 分发):无版权曲库怎么接、许可白名单与商用红线、TASL 署名怎么出、AI 生成音乐的许可陷阱(MusicGen 权重 CC-BY-NC)、自算作曲为什么是默认路径。安装后被 BGM 配乐师调用;绑定围栏 G-BGM0..G-BGM5,卸载即撤销。

geniusdapeng-collab/WorkLoom-video-edit

配乐定调官方套件(随 bundles/ai-video 分发):题材×场景×情绪→调式/调性/BPM/和弦/配器/结构的选型法,含 32 个题材配方(16 既有 + T-15 新增 16)、速度决策(配方 BPM vs 剪辑点反推)、禁忌清单与"允许不配"。安装后被 BGM 配乐师调用;绑定围栏 G-BGM0..G-BGM5,卸载即撤销。

geniusdapeng-collab/WorkLoom-video-edit

人声分离纪律官方套件(随 bundles/ai-video 分发):什么时候真需要分轨、两档引擎链(demucs/audio-separator → ffmpeg 中心声道近似)、质量等级与诚实标注、单声道与失败处理、与 UVR/Spleeter 的关系。安装后被 BGM 配乐师调用;绑定围栏 G-BGM0..G-BGM5,卸载即撤销。

geniusdapeng-collab/WorkLoom-video-edit

SRT/ASS、字体解析、实际烧录与文字扩展轨的完整执行纪律;默认一次处理、原片原声保持,核对时间轴和真实产物,不抽帧评审可现度或循环选优;遵守 G-SUB 围栏的原片、字体、权限和执行回执约束。

geniusdapeng-collab/WorkLoom-video-edit

摄影知识库调用技能(随 bundles/ai-video 分发):19 篇九章式摄影知识(光学/景别/运镜/光线/色彩/材质/天气/风格/情绪),每篇第六章是「意图→提示词」核心调用区。用于写镜头提示词前定光圈/焦距/景别/光位/色调/材质,把参数意图翻译成画面语言。绑定制片与摄影指导岗位及围栏 G-KB0–G-KB4;卸载即撤销。

geniusdapeng-collab/WorkLoom-video-edit

调色交付规范官方套件:Rec.709 本地加工、平台派生、滤镜和来源证据、真实产物哈希、版本回滚与用户反馈归因。成功渲染素材默认接受,保留完整参数与工艺参考,未测画面品质如实为空,实际缺件、授权或加工失败保持阻断;绑定 G-COL0..G-COL4,卸载即撤销。

geniusdapeng-collab/WorkLoom-video-edit

调色执行纪律官方套件(随 bundles/ai-video 分发):规格读取、明确校正与风格配方、单次请求加工、多镜参考匹配、来源和输出字节留痕,保留目标值与 profile 工艺知识。成功源镜默认接受,独立诊断不接入品质否决或自动重做;绑定 G-COL0..G-COL4,卸载即撤销。

geniusdapeng-collab/WorkLoom-video-edit

题材、场景、情绪与平台到单次调色配方的选型方法;保留题材表、参数建议、操作流程与失败诊断,成功渲染素材默认进入后期,不以画面评分复核或重做。

geniusdapeng-collab/WorkLoom-video-edit

多镜色彩一致性官方套件:指定参考镜、逐镜派生曝光和色度校正、完整批次结果、原片只读与当前字节证据。保留参考选择与诊断残差的工艺知识,成功源镜默认接受,成片不以残差、肤色或主观跳变自动拒绝重做;绑定 G-COL0..G-COL4,卸载即撤销。

geniusdapeng-collab/WorkLoom-video-edit

评论三级分流 SOP 官方套件(随 bundles/ai-video 分发,F8.1 官方套件级):评论采集→意图分类→三级分流(夸赞 auto/咨询 review/负面 review+告警/敏感 block)、投诉维权关键词必审+告警、外发回执落账。安装后被评论区运营调用;绑定围栏 G10,卸载即撤销(F8.2/L8.3)。

geniusdapeng-collab/WorkLoom-video-edit

封面设计官方套件:按明确标题、主视觉镜号/时刻、平台与账号字体色板一次本地合成,保留字号、安全区、人物布局和标题工艺知识。成功源镜默认接受,不调用模型选帧或整图质量评审,不做 PSNR/墨迹投票自动重做;实际来源、字体、请求和产物失败明确,绑定 G-MAT1/G-SUB3。

geniusdapeng-collab/WorkLoom-video-edit

封面设计知识库(cover-kb)调用技能。为封面设计师岗位提供「平台规范 / 账号定位 / 题材映射 / 钩子公式 / 构图工艺」的结构化检索与注入纪律(14 篇九章式,确定性检索,无向量库)。绑定围栏 G-SUB2/G-SUB3/G-MAT1;卸载即撤销封面 know-how 注入能力。

geniusdapeng-collab/WorkLoom-video-edit

母版、旁挂字幕、软轨、封面、变体、工程与清单的完整交付纪律;含产物表、变体设计、执行参数、来源哈希与逐层失败 SOP。按声明配方实际执行,保留来源与真实错误,不以差异评分、声音质量或默认增强模型再次拒收素材;绑定 G-DLV0..G-DLV9,供后期交付与封面岗位调用。

geniusdapeng-collab/WorkLoom-video-edit

返修闭环官方套件:反馈归因、层影响分析、基础工程版本/SHA 前置条件、独占版本认领、本地增量重合成与复用证据。保留完整反馈表、并发冲突和存储失败 SOP;成功镜头默认接受,组件或旧品质失败不重新生成,点名新生成保持 G8/G-DLV5,绑定 G-DLV4..G-DLV7。

geniusdapeng-collab/WorkLoom-video-edit

导演评审官方套件(随 bundles/ai-video 分发,F8.1 官方套件级):6 问评审 + 5 维评分 + 硬阻断打回、事实红线一票否决、跨集连贯性校验,含硬阻断优先级/平均分不得掩盖短板/事实红线以 confirmed 字段为准等决策原则、四种评审形态打法、五步 SOP 与失败模式表。安装后被连贯审查官调用;绑定围栏 G6,卸载即撤销(F8.2/L8.3)。

geniusdapeng-collab/WorkLoom-video-edit

字体许可合规官方套件(字幕师专业套件):OFL-1.1/Apache-2.0/厂商免费商用三类白名单判定、OFL 四条义务(可商用/禁单售/改后改名/保留声明)、不做子集化的理由、客户自备商用字体的登记口径、证据留痕与围栏 G-SUB5 对应关系。安装后被字幕师调用;绑定围栏 G-SUB1/G-SUB5,卸载即撤销。

geniusdapeng-collab/WorkLoom-video-edit

字体选型官方套件(字幕师专业套件):场景×语言硬过滤、五维加权打分(作品类型/BGM节奏/粗细/艺术气息/气质关键词)、账号视觉锤锁定、中英混排搭配、上位提示词气质命中、否决项与"允许报告无合适字体"。安装后被字幕师调用;绑定围栏 G-SUB0/G-SUB1/G-SUB3/G-SUB5,卸载即撤销。

geniusdapeng-collab/WorkLoom-video-edit

情报五站方法论官方套件(随 bundles/ai-video 分发,F8.1 官方套件级):采集/评价/竞品/核验/装订五站流水,含决策原则(无源不入库/置信度三级/域名去重/冲突不仲裁)、实物 8 路与服务 6 路两套打法、五步 SOP(每步带回执与失败路径)、关键指标护栏与失败模式表。安装后被情报科五站与调研员调用;绑定围栏 G1,卸载即撤销(F8.2/L8.3)。

geniusdapeng-collab/WorkLoom-video-edit

原声 program、显式签章分轨与配乐的来源、策略、时间轴和一次混流方法;默认保留原声,不自动分离或测声音品质,真实非法分轨与混流失败明确停止。

관련 스킬