name: chaojifeng-video-content-creator description: "端到端中文视频内容创作 Skill，适用于真人或授权数字人的口播、教程、产品发布、Skill 分享、B站/视频号/YouTube 横版或竖版视频。支持选题调研、口播稿、A/B-Roll 分镜、数字人 A-Roll 生成与验真、特效库绑定、素材审计、真实时间戳清洗、Hyperframes/GSAP 动效、字幕、封面、MP4/SRT/ASS 发布包，以及可编辑剪映草稿的分层交付与实机验收。可从任意已有阶段进入；“全自动剪辑”“这个视频，走自动模式”会自动完成剪辑、标题正文标签、封面图片与发布材料。"

Chaojifeng Video Content Creator（视频内容创作）

把这个 skill 当作视频创作的统一入口。它覆盖从选题到发布包的完整链路：

• 规划层：选题调研、BRIEF、SCRIPT、STORYBOARD、制作经验、镜头语法、素材门禁。
• 制作层：内置 B-Roll 特效库、B-Roll 模式绑定、三层特效规划、Hyperframes 叠加轨（overlay）、视觉终检。
• 剪辑层：ASR、A-Roll 清洗、口水词/重复/停顿规则、字幕校正、封面模式、发布包契约。

新视频项目直接从这个入口开始，按用户当前所处的阶段进入。

资料检索与作者证据（必做）

内容构想、选题或实质创作前，先梳理可用的资料来源：作者提供的文稿、过往作品、课件、产品资料和素材库，以及主题相关的公开资料。宿主环境提供资料检索类 Skill 或知识库工具时优先使用，并复用同一份资料包；新增事实、案例、数字、承诺、素材需求或时效缺口时再定点补查。

• 构想与调研：先找作者与主题的具体连接，再确定切入点。为作者本人创作时，查相关观点、实践、课件、活动分享、历史作品及素材；为其他作者创作时，只按该作者授权的资料检索，不混入他人的个人事实。把“作者贡献、来源依据、准备兑现的位置”写入现有计划或素材记录，再进行作者关联与读者价值自查。
• 创作与补查：只有已读且可支撑的材料才能写入事实。观点整理可以作为有依据的作者贡献，不能写成亲测，也不为了制造关联硬塞产品或第一人称。
• 成稿与交接：核对主张、作者贡献及图文在实际段落、镜头或卡片中的依据。证据不足时先调整角度、缩小承诺或保留待补，不编造通过自查。
• 范围：用户限定来源时遵从。纯排版、格式转换、剪辑或已充分支持的局部修改复用已有资料，不强行补跑策划；纯质检不自动改稿。

本 Skill 的阶段接入：新创作在阶段 0–2、BRIEF 与作者关联自查前接入，复用明细 research.md；SCRIPT、STORYBOARD 与素材清单按需引用来源、页码或时间码。阶段 3–5 只补新增缺口，后续由现有分镜和真实时间轴管理制作，不另建事实源；已有录制稿不因检索而擅自改口播。

作者关联与读者价值自查（必做）

这里的“作者”指内容作者本人，不是执行任务的 Agent。新写与实质改写须在选题/规划时检查一次，成稿后对照最终内容再检查一次；两项都成立才通过，不新增主观分数，也不以已有高分抵消缺项。

创作前：回答两项问题

1. 这个内容跟作者有什么关系？ 写明与主题的具体连接：作者做的产品、Skill、项目、实践案例、遇到的问题、身边观察，或持续研究形成的判断；指出支持它的材料，并说明作者贡献的做法、结果、踩坑、取舍、观察或独立判断。“话题热门”“作者关注 AI”“符合账号定位”不能单独作为通过依据。
2. 这个内容跟读者有什么关系？ 写明目标读者及具体场景，以及看完能获得什么：完成动作、少走弯路、做出判断、得到资源，或感到被理解。规划中指出准备如何兑现；成稿后必须定位到实际段落、步骤、例子或画面。“有帮助”“有共鸣”“提升效率”不能单独作为通过依据。

引用他人案例须保留归属，资料整理形成的判断可以作为作者贡献，但不得写成亲测经历。不从作者署名、账号风格或项目文件的存在推断个人经历、产品所有权、成绩或情感。只使用当前材料与有效作者事实；不为满足自查编造事实。情绪价值可以独立成立，但须对应具体处境，不要求每条内容都有教程、清单或行动号召。

成稿后：对照实际内容复查

• 如果换一个作者来讲，这篇内容会失去什么具体贡献？
• 如果删掉产品介绍、宣传话术和情绪渲染，读者还留下什么收获？

以上两问用于发现空泛搬运与自说自话；有依据的组织、解释、判断和真实情感表达也属于贡献，不要求观点独家，不强迫正文反复写“我”，不要求每篇推广作者产品。情绪类内容核对具体处境与理解是否成立，不把情绪价值一并删掉。自查结论必须有材料依据和内容位置，不能只勾选“通过”。

记录、返工与任务边界

复用现有创作计划、素材笔记或检查报告记录，避免另起一套事实源；没有工作区的短文任务可在内部完成检查，不为自查新建工作区。模板仅用于过程记录，不进入可发布正文：

检查阶段：创作前 / 成稿后
作者关联：
依据：
作者的具体贡献：
目标读者与场景：
读者获得的价值：
兑现方式或正文位置：
结论：通过 / 需修改 / 待补材料

• 不通过时先利用已有材料调整切入点、补现有证据或缩小承诺，再复查；仍缺关键依据时列明缺口，保留未通过状态，不把草稿称为完成稿，不继续依赖它的交付或发布。自动模式不因此新增问答，不能靠编造通过。
• 局部改稿只复查受影响内容，保留用户原稿、逐字锁与已确认事实；纯质检只报告问题，不自动改稿。仅剪辑、排版、封面或格式转换时核对受影响的内容承诺，未检查的上游内容明确标为未验证，不强行重跑创作流程。
• 标题、核心观点、作者事实、受众或承诺变化后更新自查；同一内容跨平台可复用有效作者证据，读者价值须按新平台及实际成稿复查。通过自查不授予发布、发送消息或扩大写入范围的权限。

本 Skill 的检查重点：口播、教程与产品视频：作者关联须由口播案例、真实产品或演示材料支撑；脚本承诺必须在实际讲解和画面中兑现。新创作在选题/BRIEF 阶段检查，SCRIPT 成稿后复查；已有视频只核对受影响的内容，不强行重跑策划。

第一步

先判断用户当前从哪个阶段进入（见下方入口表）。用户已经具备后续阶段所需输入时，不要强行补跑前期。新视频工程需要判断屏录、视觉、剪辑或归档默认值时，按需读 data/experience-log.md；它只记录制作经验，和用户当次明确指令冲突时，以当次指令为准。

用户给出视频并说“全自动剪辑”“这个视频，走自动模式”“自动处理这个视频”，或明确要求“剪辑、封面、发布材料”时，进入 auto-package，先读 references/auto-package.md。该模式依次完成：剪辑与字幕 → 标题、正文与逐平台标签 → 封面图片 → 汇总发布材料。默认交付成片、成片同级 SRT 逐字稿、3:4 / 4:3 / 16:9 封面图片，以及含公共标题、正文和逐平台标题标签的发布文案；环境里有发布工作台时再生成 HTML 工作台。AI 自动选定默认方案并记录来源，不等待用户挑选候选，质量检查照常完成。用户明确说“只剪辑”等限定步骤、比例或平台时，遵从用户范围。自动模式本身不含对外发布，只有用户另行明确要求发布，才进入发布交接。

封面图片、标题正文和标签由宿主环境里的对应能力完成，可选搭配公开仓库 video-publish-workbench。本 Skill 不内置封面生成器与发布工作台，缺少能力时按 auto-package 的降级规则交付，并写明缺口。

生成或更新发布标签时（包括 auto-package、阶段 8 和已有材料的局部修改），每次先读取用户配置的标签来源，没有配置时使用目标平台公开的话题或活动页；同一任务已有本次获取结果时复用。按目标平台与本片内容筛选最适合的进行中或长期有效标签，核对起止日期、更新时间和参与条件，优先默认选中并保留核心产品标签。把来源链接、获取日期与时区、入选与排除的依据记录到项目 视频剪辑明细/tag-research/，同步已有的工作台和交接数据后校验平台容量。无对应平台条目、无匹配的有效活动或来源不可访问时，记录缺口并使用有内容依据的普通相关标签；不跨平台移植活动，不用缓存代替本次获取，不把话题热度或使用情况说成已获得流量或奖励资格。自动模式或仅更新标签时也要执行这些核对。

只要素材或现有成片含屏录，即使用户没有提打码或精剪，也要在阶段 5–8 主动读取 references/screen-recording-qa.md 和 data/screen-recording-cases.yaml：逐段找偶然露出的 HTTP/HTTPS、URL、域名、路径、悬停地址与其他地址信息，同时找无新信息的往返滚动、等待和重复演示。先核实画面与讲解，再按最小范围裁剪或遮盖；交付前在导出成片上同时查漏遮和误遮。已有粗剪或只做局部修改，也不能跳过受影响区间及相邻剪口。

自动限流与风控风险自检（每次必跑）

读取本 Skill 自带的 references/distribution-risk-knowledge.md 和 references/distribution-risk-review.md。完整风险知识本地内置，音频、字幕与屏录为审查重点；本职责自检不依赖封面或发布 Skill。分发时携带整个 Skill 目录，后续按视频案例独立维护本地规则与版本。

• 口播稿完成后对拟录制文字预检；阶段 6–8 对真实音频、最终时间轴 SRT/ASS、烧录字幕及演示画面复检，已有视频或局部修改也适用。复用本次 ASR、屏录审计与检查帧，不为自检重复启动转写、模型或编码。全文字幕检查不能代替听查真实音频或目检实际画面；只抽样时明确范围。
• 检查本地 R01/R02/R04，记录原句、字幕序号、实际成片时间段与画面位置；字幕、音频及画面各自的覆盖状态必须分开记录。未知时间戳不估算冒充定位。稿件通过预检不等于成片已检查。
• 自检自动运行，无风险静默继续，不向用户索要自检确认。有命中才主动给出风险表及具体改法；经验提示不能表述为官方禁词或已限流。对已确认口播语义／真实证据的变更，等待用户针对风险选择；不受影响的制作继续。
• 不只把字幕中的软件名换成代称而保留原音频。用户选择调整已录制口播后同步处理音视频、完整 SRT/ASS、烧录字幕与时间轴，不能无授权克隆声音；改画面标识遵循既有局部遮盖与漏遮／误遮检查。
• 项目报告写入 process_root/checks/distribution-risk-video.md，包括无命中、检查缺口、已接受与未处理风险。阶段 8 与 auto-package 继承封面及发布文案报告引用，按相同输入、规则与目标平台复用结果；任何受影响内容改变后复查，不因自动模式省略。

内容边界

• 核心观点、人物口吻、第一人称经历和表达习惯都属于上游内容输入。本 skill 不根据历史视频或制作日志推断作者声纹。
• 调用方已提供内容契约或人物风格约束时，保持其语义与口吻，只做口播可录性、时长、镜头和平台呈现适配。
• 不得为了制造共鸣补写未经材料支持的经历、数字、产品使用结论或观众私密细节。
• 开场、问题段和 CTA 都按视频类型与发布目标选择，不作为固定人格模板。

用户要求完整工作流时，按阶段顺序推进。用户只要求局部任务时，只产出必要文件，并说明哪些上游假设没有验证。

工程契约

每条视频复用一个项目目录。默认把制作过程集中到 视频剪辑明细/，最终封面与工作台作为根目录交付，通过质量检查的成片放在项目根目录，命名为 【成片】<主题名>.mp4；同时在根目录交付 【逐字稿】<主题名>.srt。已有项目沿用项目名和位置；原片与原始录制工程保留原有位置，不为了套用目录样例改名或移动。

<项目目录>/
├── 【原片】<主题名>.mp4           # 已有原片按原名保留
├── <原始录制工程>                # 如已有 .screenstudio
├── 【成片】<主题名>.mp4           # 面向用户的最终交付
├── 【逐字稿】<主题名>.srt         # 对应最终成片时间轴的完整口播文本
├── 封面图/                      # 已确认封面：<主题名>_3x4.png / _4x3.png / _16x9.png
├── <主题名>-视频预发布工作台.html   # 可选：使用发布工作台时
├── 【发布文案】<主题名>.md        # 当前公共标题、正文及逐平台标题和标签
└── 视频剪辑明细/
    ├── topic-brief.md / research.md / BRIEF.md
    ├── SCRIPT.md / STORYBOARD.md / BROLL-STYLE.md
    ├── ASSET-LIST.md / EFFECT-BEATS.md
    ├── assets/ASSET-AUDIT.md
    ├── avatar-aroll/             # 可选：生成源片、来源与验收
    ├── aroll/                    # 转写、字幕、剪辑决策与清洗视频
    ├── broll-overlay/
    ├── rough-cut/
    ├── work/封面制作/            # 未定稿候选与制作记录
    ├── tag-research/
    ├── auto-package-state.json
    ├── checks/                   # 项目级检查与目录迁移记录
    └── publish/v00N/             # 发布包、工作台、回执与交付版本

以下阶段路径均相对于 视频剪辑明细/；原片路径与根目录交付路径除外。开始执行时记录 project_root、process_root、主题名、final_video_path 、final_transcript_path、final_cover_dir 、workbench_path 和 publish_copy_path；调用封面、发布或剪辑模块时显式传递这组路径，主题名仍取实际视频主题，不能误用“视频剪辑明细”作主题。模块默认目录与本契约冲突时，按本项目契约指定输出位置。

主题名优先用用户指定名称，否则沿用原片主体名称，去除扩展名及 【原片】 / 【成片】 前缀。只在确实交付多个比例或有声/无声版本时追加能区分版本的后缀，扩展名必须与实际格式一致。版本包通过检查后，复制成片到根目录并核对 SHA-256；不为改名重新编码。同名同指纹直接复用；不同指纹先保留旧版到版本目录并记录来源，再更新根目录交付。

每次剪辑完成都要交付与成片同主题名的 SRT 逐字稿。优先复用经校正、对应最终成片时间轴的完整字幕；不得直接复制尚未映射剪辑时间轴的原片 SRT，也不得用脚本稿或摘要冒充逐字稿。缺失时按 references/cleanup-and-subtitles.md 使用现有本地转写工具、模型缓存和运行环境对成片转写，校正专名并记录不确定内容。逐字稿涵盖保留在成片中的实际口播，不受封面标题或重点字幕筛选影响；校对修改不得改写口播事实。原始转写、校正与验收记录留在明细目录。交付前检查 SRT 编号、非空文本、有效时间区间、条目顺序、时长范围及副本指纹；原片逐字稿如需保留，另放明细并明确来源。成片时间轴变更时同步更新根目录逐字稿，复用同名文件处理规则。

最终封面交付到项目根目录 封面图/，使用 <主题名>_3x4.png、<主题名>_4x3.png、<主题名>_16x9.png 命名，扩展名与真实格式一致。只保留本次实际需要且用户已确认的最终图片，默认每个比例一张；auto-package 按其默认或用户指定比例执行，允许 AI 质检并选定后直接交付，记录 ai_checked，不得冒充 user_approved。其他局部任务比例缺省或用户未要求时不为凑三张补生成。候选、返修和制作记录先存明细 work/封面制作/。用户确认最终图片后，先核对指纹、更新工作台及当前交接引用，再将未采用的中间图片移入废纸篓并记录清单；不可清空整个项目、原始人物素材、已沉淀的封面模板、验收截图或历史发布回执。仍用于当前交接的图片不能清理。

使用发布工作台时，工作台交付为项目根目录 <主题名>-视频预发布工作台.html，最终封面引用根目录 封面图/，成片引用根目录交付视频。输入 JSON、状态、调研、检查和回执仍留在明细内。构建器产生的预览与回退图片收拢到明细 publish/v00N/work/ 并同步真实路径；独立回退图片若被用户确认为最终封面，则按最终封面规范交付。移动已有 HTML 保留原有选择和草稿存储标识；核验全部当前本地引用、图片元信息、JavaScript 语法和发布包。页面实看验收单独记录，文件校验不能代替页面实看。

根目录同时交付 【发布文案】<主题名>.md。使用当前最终发布选择生成公共标题、正文和每个目标平台的实际标题与标签（包括视频号短标题），标签按当前已选项整理；没有最终选择时使用当前工作台默认已选内容并明确标记待确认。不得以旧候选替代最新确认选择。正文保留原始段落，不把不同平台标签混成一组。每次标题、正文、标签变更同步更新 Markdown、工作台输入与当前选择并逐项核对；原始用户选择和已执行请求作为历史证据保留。Markdown 是发布文案汇总，不替代最终 selection JSON，也不触发发布。

整理已有项目时同步更新工作台、预览 URL、发布选择、状态文件及未执行交接任务的路径，保留工作台已有选择与存储标识。已经执行的回执、原始请求及历史记录保留原文，用目录迁移记录说明新旧路径；移动文件不触发重复上传或重新发布。

阶段 4 之后，STORYBOARD.md 是单一事实源。后续阶段要把素材文件名、真实时间戳、B-Roll 模式 id 和状态回填进去，不要另起一个互相冲突的分镜文档。录后加特效时，EFFECT-BEATS.md 是从 STORYBOARD.md 和真实字幕派生出来的执行表，用来驱动 snippet 内容填充和 overlay 制作。

阶段文件夹顶层只放阶段交付物和契约文件；执行中间材料进该阶段 work/，验收证据进该阶段 checks/，交付版本进 publish/v00N/。每个执行阶段开始前先声明预期产物，结束时逐项核对（阶段产物预期表见 references/workflow.md）。

阶段 6 的清洗必须早于阶段 7 的特效节拍。不要用未清洗的口水词、重复句或失败重录去生成 EFFECT-BEATS.md。

内置特效库

这个 skill 自带 B-Roll 特效库。做分镜、素材清单、节拍表或 Hyperframes 叠加轨时，优先使用本 skill 内的这些文件：

• assets/style_library/narrative-index.md：按叙事意图反查模式，写稿和分镜时先读。
• assets/style_library/catalog.md：模式说明、三层结构、转场和片尾规则。
• assets/style_library/recipe-system.md：统一配方卡、引擎选择、运行状态和来源边界。
• assets/style_library/registry.json：本地原生模式的事实源；registry.js 由脚本生成，用来确认 id、snippet 和预览是否存在。
• assets/style_library/recipes/video-shotcraft/recipes.js：Remotion 配方卡与动效样式的固定上游快照，来源与许可见 THIRD_PARTY_NOTICES.md。
• assets/style_library/snippets/：可复用 HTML/GSAP 片段。
• assets/style_library/previews/：真实预览页。
• assets/style_library/gallery.html：原生、Hyperframes 与 Remotion 的统一可视化挑选入口。
• assets/style_library/scripts/build_effects_gallery.py：新增或修改模式后重建预览、刷新缓存并校验。
• examples/clean-then-effects/：样例工程，含阶段 0 到 4 的产物和阶段 6 的清洗数据。
• data/filler_rules.yaml：口水词、重复重说、长停顿、X 的话、剪后空白和词边界保护规则。
• data/corrections.yaml：ASR 错词、专名、热词和首选写法。
• data/subtitle_styles.yaml：字幕样式预设。
• data/asr_providers.yaml：ASR 提供方配置。
• data/experience-log.md：目录归档、屏录、视觉和剪辑制作经验；不得用于推断人物口吻。
• data/memory.md 和 data/brand-profile.yaml：特效项目经验记录与品牌配置模板，使用前换成自己的信息。

选择配方时先定叙事意图，再定引擎。native 配方有本地 snippet，可直接进入 HTML/GSAP + Hyperframes overlay；remotion 配方使用帧驱动 TSX 源码，必须进入 Remotion 工程实现。Gallery 中的上游视频只证明该配方有公开预览，不等于本机已经渲染。未经本地实现和抽帧验证，不要把 Remotion 配方标成 local-ready。

阶段地图

门禁纪律

• 偏好门禁：风格、时长、镜头数、配乐、节奏等。用户说“你定”时可以由 AI 决策，但要在产物里标注。
• 质量门禁：逐字稿口述状态、分镜评审、素材审计、字幕/音频一致性、特效抽帧检查、发布包验证、未验证披露。任何模式下都不要跳过。

质量门禁

• 新创作在选题/BRIEF 时完成双项自查，SCRIPT 成稿后定位到讲解和分镜复查；后续剪辑改变观点或承诺时对受影响段落复查，通过后进入相应交付。

• 选题必须通过一句话测试：“给【受众】看的关于【主题】的【类型】视频，看完记住【一件事】。”

• 口播稿必须标明 AI初稿、口述校准中 或 本人已口述定稿；不要把 AI 初稿说成已经口述验证。

• 昂贵的素材生成或剪辑前，必须先完成分镜评审。

• 分镜必须使用镜头语言，不要写成页面布局；B-Roll 行要有景别、运动、素材策略、B-Roll 模式和本镜目的。

• 每个项目要生成或更新 BROLL-STYLE.md。可以覆写色彩和元素，但屏录工艺、证据真实性和字幕可读性不可降级。

• B-Roll 覆盖率目标至少 40%；最长连续 A-Roll 默认不超过 20 秒，除非明确说明理由。

• 证据、数据、产品操作类镜头必须用真实屏录或真实截图，不能用 AI 生成图冒充证据。

• 有语义风险的剪辑需要评审；长静音和完全重复的重录片段可以自动处理。

• 屏录地址信息默认主动查找并只在实际出现的帧与位置遮盖；无信息片段优先裁剪。遮罩不能长期覆盖已无地址的页面，也不能盖住演示关键内容。处理决策和正反两类验收见 references/screen-recording-qa.md。

• 无新信息、无有效口播的往返滚动或重复操作要主动识别并精剪；有独有操作或讲解时保留必要过程，语义不确定时进入评审，不按静音时长盲剪。

• 录后先清洗再绑定特效。删除真实说出口的口水词、重复词、X 的话 或残句时，必须写入 subtitle_plan.json 的 word_cut_ranges 并同步剪音视频。

• 数字人源片必须能在本地或目标剪辑器作为独立素材读取，具有实际视频和音频流；只有生成任务、网页预览或下载按钮不能进入后续剪辑。本人形象授权与声音克隆授权分开记录；预设音色不可标作本人声纹。遇到套餐或权限阻断，记录原状态，可用真人 A-Roll 独立验证下游，但不得把它冒充数字人试片。

• 录后加特效必须用真实字幕/ASR 时间戳生成或更新 EFFECT-BEATS.md；snippet 里的演示文案每次都要替换为本条视频的字幕、关键词、数字、步骤、可选 CTA 或素材内容。

• 特效要按骨架层、节拍层、容器层、转场和片尾/产品卡规划。节拍密度默认每 10-20 秒一个；开场、算账/对比和总结通常是优先节拍，CTA 仅在发布目标需要时安排。

• Hyperframes 实现后要先逐节拍 snapshot 抽 2-3 个关键时刻目检，全部通过后再全片渲染和合成。

• 从字幕里删掉的真实口播词，也必须用词级时间戳从音视频里删掉；只有 ASR 错字、标点、大小写、空格和专名校正可以只改字幕。

• 默认字幕使用 orange_rounded_black_white_outline：橙色 #FF8920 圆角底、#101820 黑字、3.25px 白色圆润描边、设计画布 50px 字号、8px 字距、25% 圆角率和垂直居中。字距必须按描边后的视觉净空验收，不能只确认参数存在；已有 SRT 重建 ASS 时必须使用 render_from_transcript.py --srt-input ... --ass-output ...，禁止复制渲染逻辑写一次性脚本；原有白字重描边、黄字重描边和屏录紧凑样式只作为 --style 可选切换项。

• 默认清理每条字幕及最终显示行末尾的 ，。！？；：、… 和英文对应符号（,.!?;:），句中必要标点保留；不得改动口播文字或时间轴。转写导出、已有 SRT 导入和自动换行均须经正式脚本处理；交付前全量检查 SRT/ASS 行尾，并抽查 MP4 烧录结果，发现残留不得交付。

• 发布目录必须按契约包含最终 MP4、SRT/ASS、剪辑决策、隐藏口播检查、必要检查截图和发布说明；没发现问题也要保留检查记录。

• 含屏录的发布包还要保留地址与冗余动作审计，导出后抽查遮罩开始、结束及无地址负样本；剪辑改变时间轴后重新核对遮罩与字幕。

• 最终汇报必须包含“我没有验证的部分”，例如口播稿未本人朗读、时长仍是估算、AI 视频未生成、封面附件未检查、最终 MP4 未播放抽查。

输出风格

写视频文案时面向普通观众，不面向开发者。除非视频明确是技术开发者教程，否则不要把 API、SDK、数据库、错误码、内部模块等实现细节写进用户可见口播。

交付时用简短状态汇报：完成了哪些阶段、产物路径、门禁状态、未验证部分。

按需读取

只读取当前入口需要的参考文件：

• references/workflow.md：完整阶段契约和交接规则。
• references/planning-and-research.md：选题、调研、BRIEF。
• references/script-and-storyboard.md：口播稿、STORYBOARD、评审摘要。
• references/shot-grammar.md：写 B-Roll 景别、镜头运动和画面描述前读取。
• references/aroll-script-guide.md：需要更细的口播适配、叙事模式、事实边界和 B-Roll 预绑定规则时读取。
• references/broll-style-standard.md：生成 BROLL-STYLE.md、规划屏录工艺、AI 图风格和衍生精剪版时读取。
• references/assets-and-effects.md：素材清单、项目级 B-Roll 风格、内置 B-Roll 特效库、模式绑定、Hyperframes 叠加轨、特效库成长。
• references/pipeline.md、references/gsap-best-practices.md、references/hyperframes-lessons.md：实现 Hyperframes 叠加轨前按需读取。
• references/cleanup-and-subtitles.md：ASR、可配置口水词清洗、subtitle_plan.json、A-Roll 清洗、字幕一致性。
• references/screen-recording-qa.md：含屏录时必读；地址候选与局部遮盖、多余画面动作、漏遮/误遮双向验收、案例迭代。案例注册表为 data/screen-recording-cases.yaml。
• references/publish-export.md：封面、发布包、最终验证。
• references/auto-package.md：已有视频的自动模式（剪辑、标题正文标签、封面、发布材料）。
• references/distribution-risk-knowledge.md、references/distribution-risk-review.md：限流与风控风险自检的规则和报告格式。
• references/digital-human-aroll.md：本人数字人 A-Roll 的来源、授权、下载验真、时间轴衔接与剪映草稿状态边界。

模板在 templates/ 目录。创建新产物时优先使用模板。

Chaojifeng Video Content Creator

中文视频内容创作 Skill：选题、口播稿、分镜、口播清洗、特效叠层、字幕和发布包，一条流水线。

简体中文 | English

快速开始 · 能做什么 · 工作流程 · 特效库 · 样例工程 · 要求与边界

能做什么

装进支持 Agent Skills 的编码 Agent 后，用自然语言说出视频需求。Agent 按阶段产出文件，每个阶段有门禁产物，可以从任意阶段进入。

Skill 本身不含视频生成模型、封面生成器和发布工作台。封面、标题和标签由宿主环境里的能力完成，缺失时按降级规则交付并写明缺口。自动模式不含对外发布。

快速开始

npx skills add mileson/chaojifeng-video-content-creator

装好后直接对 Agent 说：

用 chaojifeng-video-content-creator 帮我做一条 3 分钟的产品介绍视频：先出选题句和调研清单，再写口播稿和分镜。

这是录好的口播 ~/Videos/raw.mp4。转写后清掉口水词和重复句，再按字幕时间排特效节拍。

~/Videos/raw.mp4 这个视频，走自动模式。

自动模式依次完成剪辑与字幕、标题正文标签、封面图片、发布材料汇总。

手里已有的内容决定从哪一步开始：

完整入口表见 SKILL.md。

手动安装：

git clone https://github.com/mileson/chaojifeng-video-content-creator.git

把目录放进 Agent 的 skills 目录，目录名保持 chaojifeng-video-content-creator。

工作流程

flowchart LR
    P["0-3 规划<br/>选题 · 调研<br/>BRIEF · 口播稿"] --> S["4-5 分镜与素材<br/>A/B-Roll 分镜<br/>素材清单与审计"]
    S --> C["6 A-Roll 清洗<br/>转写 · 去口水词<br/>剪口音轨质检"]
    S -.-> D["5.5 数字人 A-Roll<br/>可选"] -.-> C
    C --> E["7 特效粗剪<br/>字幕驱动节拍<br/>Hyperframes 叠加轨"]
    E --> F["8 发布包<br/>成片 · 字幕<br/>发布文案"]

内置的门禁：

• 先清洗再加特效，节拍表只用清洗后的真实字幕时间戳生成。
• 渲染前逐个剪口检查是否切到语音，默认在剪口音轨质检通过后才渲染。
• 证据、数据和产品操作类镜头使用真实屏录或截图。
• 屏录里的地址信息按实际出现的帧遮盖，导出后复核漏遮与误遮。
• 口播、字幕与画面自动做限流与风控风险自检，有命中才提示。

特效库

assets/style_library/ 收录 148 个本地原生特效，每个都是可直接放进 Hyperframes 叠加轨的 HTML/GSAP 片段：

另有 152 张 Remotion 配方卡（209 个样式），来自 video-shotcraft 的固定快照。统一挑选页 gallery.html 汇总 300 张配方卡、357 个样式，可按类别和关键词检索。

用浏览器打开 assets/style_library/gallery.html 即可浏览。预览页从 jsDelivr 加载 GSAP，需要联网。新增或修改特效后运行：

python3 assets/style_library/scripts/build_effects_gallery.py build
python3 assets/style_library/scripts/build_effects_gallery.py refresh
python3 assets/style_library/scripts/build_effects_gallery.py validate

Remotion 配方卡是配方描述加上游预览。在 Remotion 工程里实现并抽帧验证之前，它们不标为本地可用。

样例工程

examples/clean-then-effects/ 是一条约 43 秒教程视频的阶段产物：选题、调研、BRIEF、口播稿、12 镜分镜，以及一段 15 秒口播的词级转写、清洗决策和清洗后的字幕。

用任意一段 15 秒视频（只读取时长）复现阶段 6 的字幕：

python3 scripts/render_from_transcript.py \
  --video /path/to/any-15s-video.mp4 \
  --transcript examples/clean-then-effects/transcript.json \
  --subtitle-plan examples/clean-then-effects/subtitle_plan.json \
  --work-dir /tmp/clean-then-effects \
  --output /tmp/clean-then-effects/out.mp4 \
  --window 0:15:full \
  --skip-render

生成的 /tmp/clean-then-effects/edited.srt 与样例目录里的 edited.srt 一致。

脚本

剪口音轨质检可单独运行：

python3 scripts/spoken_audio_qc.py analyze \
  --input raw.mp4 \
  --timeline aroll/edit_decisions.json \
  --transcript aroll/transcript.normalized.json \
  --output-dir checks/spoken-audio-qc

输出 audio-qc.json、waveform-report.html 和 review-template.json。人工复听标出的剪口后，把结论填进 review-template.json，再加上 --review review-template.json 重新运行一次。render_from_transcript.py 在标准和激进清洗模式下会自动调用这套检查，参数说明见 references/cleanup-and-subtitles.md。

要求与边界

• Python 3，所有脚本只用标准库。脚本在 macOS 和 Python 3.12 上测试。
• FFmpeg 与 ffprobe 在 PATH 中：渲染和音轨质检需要。
• 视频编码器：macOS 默认 h264_videotoolbox，其他系统默认 libx264，用 --video-encoder 指定。
• Hyperframes（Node.js 22+）用于叠加轨渲染，按其文档安装。没有它时，规划、清洗和字幕仍可完成。
• 云端转写可选。脚本只读取环境变量 VOLCENGINE_API_KEY，也可使用 VOLCENGINE_ARK_API_KEY 或 ARK_API_KEY，不会自动加载 .env 文件。可参照 .env.example 写好后用 set -a; source .env; set +a 导入。vc-url 模式需要公网可访问的音频地址，bigmodel-flash 模式可直接上传本地文件。
• 口水词、重复句和 X 的话 等清洗规则针对中文口播，规则文件是 data/filler_rules.yaml，可按需修改。
• 封面图片、标题标签和发布工作台由宿主环境提供，可搭配 video-publish-workbench。
• 特效库预览依赖 jsDelivr 上的 GSAP，Remotion 配方卡的预览视频按需读取上游远程文件。

目录结构

SKILL.md                 入口：阶段地图、门禁、工程契约
references/              分阶段操作指南
templates/               BRIEF、SCRIPT、STORYBOARD 等产物模板
data/                    清洗规则、热词、字幕样式、识别服务配置、屏录案例
scripts/                 转写、剪辑渲染、音轨质检
assets/style_library/    特效库：registry.json、snippets/、previews/、gallery.html
examples/                样例工程
docs/images/             README 配图

相关项目

• Hyperframes：HTML 渲染成视频的框架，叠加轨渲染使用。
• video-shotcraft：Remotion 配方卡的来源。
• video-publish-workbench：本地视频预发布工作台。
• skills：npx skills 命令行工具。

参与贡献

欢迎提交 Issue 和 Pull Request，约定见 CONTRIBUTING.md。安全问题请按 SECURITY.md 私下报告。

许可与致谢

本仓库使用 MIT 许可。特效库中部分文件复制或改写自 Hyperframes 官方目录中的示例和组件，Remotion 配方卡来自 video-shotcraft，二者均为 Apache-2.0，署名和改动说明见 THIRD_PARTY_NOTICES.md。GSAP 通过 CDN 加载，适用 GSAP 标准许可。