Communitygithub.com

chengfeng-videocut-skills

完成口播视频剪辑后,为每个语段自动配画面:在录屏上叠加 HTML 层(圈重点、全屏动画、推近等),层绑定字幕片段,由播放器逐帧驱动,直接在预览中查看效果。用户说“做分镜”、“配画面”、“加动画”、“圈重点”、“B-roll”或“做 storyboard”时触发。不可用于删词、字幕编辑、物理剪切或成片渲染。

chengfeng-videocut-skills とは?

这个技能专为口播视频的后期“配画面”阶段设计,解决从粗剪完成到添加视觉辅助(标注、动画、B-roll)之间的自动化问题。它不负责剪辑或渲染,而是专注于在已有字幕和账本的基础上,为每段话智能判断并生成覆盖在录屏上的 HTML 层。技能覆盖了完整的四步工作流:文字语义分段、抽帧视觉判断、运动窗口量化分析、模块生成与叠加。支持通过 CLI 命令与桌面级 Runtime(Desktop-Managed)协作,所有模块按序号命名便于审阅修改,且严格遵守“不存秒数、不目测坐标”等纪律以避免常见错误。输出结果为 `visuals.json` 及每个模块的独立 HTML 文件,用户可在预览中逐层核对。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Agentchengfeng/chengfeng-videocut-skills/tree/HEAD/plugins/chengfeng-videocut/skills/chengfeng-visual

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

画面(分镜)

这是一件事,不是流程的一段。 用户什么时候喊它就什么时候做,改完剪辑可以回来再做。

前提只有两个:账本和字幕已经存在(层按字幕屏放、时间从账本算)。

需要   edit-list.json、transcript.json、subtitles.json
产出   visuals.json + modules/<序号-名字>/index.html

干完就停,不指挥用户下一步。

先读取并执行 业务 Skill 的阶段合同。 模块写法的硬规矩见 模块契约, 判断规则见 画面判断。

0. 就绪

先执行 检查更新 的「就绪检查」——skills 是否 最新、Runtime 是否配套;插件根也在那里定位(本文命令里的 <插件根> 都代入 那个字面路径)。只有「就绪」才继续;「需新会话」或「停」按它的处置执行 (含「禁止自制替代界面」禁令),业务 Skill 不自带环境逻辑。

若就绪结果为 runtime.kind=desktop-managed,直接复用桌面 App 已安装的稳定 CLI 与 同一 launchd/windows-task 服务;不要解析 Electron 路径、另装依赖或起第二个 Runtime。

命令

node "<插件根>/scripts/ensure-running.cjs" --json
node "<插件根>/scripts/videocut-cli.cjs" visual get   <project> --json
node "<插件根>/scripts/videocut-cli.cjs" visual frame <project> --cues sub-0004,sub-0005 --count 12 --out <dir> --json
node "<插件根>/scripts/videocut-cli.cjs" visual add   <project> --module modules/01-xx/index.html --cues sub-0004,sub-0005 [--zoom x,y,w,h] [--id vis-0001] --json
node "<插件根>/scripts/videocut-cli.cjs" visual remove <project> --id vis-0001 --json

ensure-running 必须先证明 canonical 5190 属于当前平台的托管服务;失败就透传并 停止,不回退 foreground 或自选端口。

层绑字幕屏(--cues),产品自己换算成词 id——层永远不可能绑上没人说的词, 剪辑变了层自己跟着挪。不存秒数。

四步,一步不跳

① 文字定任务    读 subtitles.json,按语义分段,每段回答:
               教程/演示/证明,还是概念/逻辑/过渡?
② 抽帧看画面    visual frame 抽 8-12 帧,真的用眼睛看。
               实测 12 段里有 2 段被画面推翻文字预判 —— 这步不是走形式
③ 量运动窗口    相邻帧做像素差,找出滚动/切换/操作的时刻。
               层只盖稳定窗口,圈在画面开始动之前退场
④ 做层放层     写模块 → visual add → 在预览里逐层核对

② 的判断规则

画面正是他说的东西     → 标注:圈住、说到哪个词圈哪里。真证据不许盖
画面弱相关/空白       → 小黑动画:整屏白底,从风格库做
画面自身足够清楚      → 不动。这是最常见的正确答案(实测 13 段里 4 段不动)

③ 的产出物是数字,不是感觉

圈的坐标      像素统计量出来(灰度扫描找文字行),不许目测 —— 目测差过 50px
互动时刻      逐帧像素差找突变(实测一次从 4 跳到 335),圈在它之前 0.2s 退完
稳定窗口      开头常有滚动(他在找内容),层从停稳那屏的 cue 开始绑

推近(zoom)用之前先想

默认不推近。   960x720 的录屏放大就糊,用户会立刻看出来
非推不可时     ≤1.6 倍、区域取 62.5% 见方居中 —— 构图完整 > 读清小字
字太小读不清   用圈引导视线就够了;真要读清,答案是高分辨率重录,不是放大

审阅循环

模块目录用序号命名(01-daily-report、05-anim-task-split), 时间线轨道上显示目录名,用户报号你改那一层,别的不动。

两条改层纪律,各对应一次真事故:

改层必查模块     层收窄/延长后,模块里写死的相对时刻不会跟着变 ——
                圈的出场时刻可能落到层结束之后,永远不出现
验收看像素      截图看画面,不查 DOM 属性。「可见性翻转正确」的 iframe
                曾经物理上不在画面里 —— 属性全对、屏幕全空

不许做什么

  • 不许跳过抽帧和运动窗口直接做(两种错各犯过一次:盖掉真证据、圈悬在滚动上)
  • 不许把每段都做点什么——铺满不是目标,不动是常见答案
  • 不许存秒数、不许目测坐标、不许在白底页面上加压暗
  • 没有真实内容不许拿占位图充数
  • 风格从注册表选,不得凭空发明
  • 品牌图标用官方字形,不许手画替身(X 用两笔交叉线画过,被用户抓了)。 本地索引没有的,从 simple-icons 取单色官方 glyph(黑白风格正好配), 原 svg 存进模块目录备查;同一条片里同一品牌只能长一个样

Individual skills in this repo

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

Agentchengfeng/chengfeng-videocut-skills

剪辑环境的唯一管理者:就绪检查(skills 是否最新 → Runtime 是否配套)、Skills 更新激活、Runtime 安装与体检。用户说检查更新、安装剪辑环境、装播放器、检查剪辑环境、剪辑环境就绪了吗、配置转录凭证时使用;业务 Skill(剪口播/字幕/画面/导出)第 0 步也引用本 Skill 的就绪检查。不用于剪辑、字幕、画面、导出本身或项目数据迁移。

Agentchengfeng/chengfeng-videocut-skills

剪辑中文口播原素材:逐词转录、词典修字出修字表、五轮扫描找口误与重复、汇总表与重复句子表、打开 Studio 让用户复核、复盘沉淀用户偏好与词典。只产出一份已复核的删词账本,不切媒体、不做字幕、不做分镜动画。用户说剪口播、处理口误、生成口播基础素材、继续剪口播,或确认卡回传 action=return_cut_review 时使用。不要用于执行物理剪切、导出剪后视频、单独安装、单独打开工作台或口播分镜成片。

Agentchengfeng/chengfeng-videocut-skills

把剪好的口播烧成一个成片文件:账本切片段、推近、字幕、HTML 画面层,一次全部烧进 mp4。用户说导出、出成片、烧字幕、渲染、导出视频、生成最终文件时使用。不要用于生成删词候选、写字幕、做画面动画。

Agentchengfeng/chengfeng-videocut-skills

整理、脱敏并上报 chengfeng-videocut 的 GitHub Bug。用户说上报 Bug、反馈剪口播问题、提交 GitHub Issue、这个问题告诉开发者,或要求继续提交已预览的 Bug 草稿时使用。不要用于功能建议、普通排错、代码提交或未获用户确认的自动上报。

Agentchengfeng/chengfeng-videocut-skills

给剪好的口播做字幕:直接用已有的逐词稿加账本算出剪后时间(不必导出、不必重新转录)、用词典和作者文稿改写听错的专名、按句子分屏、在 Studio 里逐屏复核。用户说做字幕、加字幕、改字幕、重新分屏、字幕不对时使用。不要用于删词剪辑、物理剪切、分镜动画或成片渲染。

Agentchengfeng/chengfeng-videocut-skills

操作 chengfeng-videocut 剪辑工作台的已有工程,通过 Runtime CLI 查工程与词句位置、添加或替换画面覆盖层、移除画面、删除明确指定的词句或片段、拆分裁剪移动已有片段、调整画布比例并回读核验。用户说插入片段、删掉这句、移除动画、换个画面、调整顺序或管理时间线时使用;先区分画面覆盖与主轨顺延插入,不负责自动判断口误、创作动画、制作字幕、导出或排查安装故障。

Agentchengfeng/chengfeng-videocut-skills

Create Ian Xiaohei-style HTML/SVG motion illustrations for Chinese articles, scripts, storyboard scenes, workflow explanations, concept metaphors, and short video visual aids. Use when the user asks for 小黑 SVG、漫画感 HTML、分层 SVG 动效、把小黑生图做成 HTML/SVG、可编辑矢量动效、口播流程动画、手绘漫画动效、正文配图动画, or wants a Xiaohei illustration style adapted into controllable HTML/SVG/GSAP output instead of raster image generation.

関連スキル