Communitygithub.com

Agentchengfeng/chengfeng-videocut-skills

為中文文章、腳本、分鏡場景、工作流程說明、概念隱喻與短影片視覺輔助,創建 Ian 小黑風格的 HTML/SVG 動態插圖。

chengfeng-videocut-skills 是什麼?

這個技能專為需要將 Ian 小黑(Xiaohei)漫畫風格整合到 HTML、SVG 與 GSAP 動畫中的開發者與內容創作者設計。它將靜態的 PNG 生成流程轉變為可編輯的分層向量動畫,特別適合口播影片、文章配圖與分鏡腳本。技能支援 Claude Code、Cursor 等 AI 編碼工具,並提供一套完整的結構化工作流程:從文章提取認知錨點、選擇物理隱喻、設計分層 SVG 場景,到使用 GSAP 時間軸進行動畫。輸出結果包含可播放的 HTML 頁面、靜態預覽截圖與可選的字幕對齊地圖。關鍵規則包括:避免直接將 PNG 向量化,而是以語義化的 SVG 群組重建場景;確保小黑(Xiaohei)始終參與核心動作;以及嚴格的品質檢查流程,以確保動畫順暢、文字與元素不重疊,且故事節奏正確。技能還整合了可重複使用的圖示資產庫與模板,以維持 Ian 小黑風格的視覺一致性。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Agentchengfeng/chengfeng-videocut-skills/tree/HEAD/plugins/chengfeng-videocut/skills/chengfeng-visual/animation-styles/ian-xiaohei-svg-motion

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

Ian Xiaohei SVG Motion

把 Ian 小黑正文配圖的原則,改造成可控的 HTML + SVG + GSAP timeline 動效。目標不是復刻生圖像素,而是把文章裡的一個認知動作重建成分層漫畫舞台,方便錄影片、按字幕 cue 對齊、後續改文案和元素。

核心規則

不要將 PNG 自動向量化並對產生的路徑碎片進行動畫。僅將點陣圖作為構圖參考。將場景重建為語義化的 SVG 群組:

概念 -> 分鏡計劃 -> SVG 圖層計劃 -> HTML/SVG 模板 -> GSAP 時間軸 -> 靜態 + 動態審查

工作流程

  1. 從文章、腳本、截圖或分鏡場景中提取一個認知錨點。
  2. 選擇一個物理隱喻:分類、搬運、橋接、洩漏、捕捉、折疊、稱重、打開、改道或墜落。
  3. 讓小黑執行動作核心。如果移除小黑不會改變意義,則重新設計。
  4. 設計一個 16:9 的白色畫布,包含一個主要場景,35% 以上的留白,以及最多 3-5 個簡短的手寫註解。
  5. 為每個移動的物體建立語義化的 SVG 群組。
  6. 使用 GSAP 時間軸進行動畫。使用 x、y、rotation、scale、opacity 以及 SVG 描邊繪製。避免版面動畫。
  7. 同時儲存可播放的 HTML 頁面與靜態審查截圖。
  8. 如果是「口播成片」專案,在最終渲染前將時間軸片段對應到字幕/提示時間點。

需要時閱讀

  • 在設計新場景或判斷結果是否仍像 Ian 小黑風格之前,先閱讀 references/style-rules.md。
  • 在編寫或編輯 SVG 結構之前,先閱讀 references/svg-layering.md。
  • 在編寫 GSAP 動畫之前,先閱讀 references/motion-rules.md。

輸出約定

預設輸出資料夾:

output/<slug>-xiaohei-svg-motion/

必要檔案:

index.html
README.md
preview.png
vendor/gsap.min.js

可選檔案:

source.png        # 參考圖片,如果由使用者提供
cue-map.md        # 當需要對齊口播腳本或字幕時

可重用素材

AI 模型與介面圖示存放於:

assets/icons/

使用 assets/icons/index.json 作為唯一資料來源。將原始 SVG 檔案保留在子資料夾中,並在生成時將完整的 SVG 內容內嵌到場景 SVG 中,以便保留漸層、描邊與品牌顏色。

圖示規則:

  • 如果 index.json 已包含確切的模型、提供者或語意圖示,請使用該圖示。不要將 ChatGPT、Claude、閃電、Step、DeepSeek、Qwen、錯誤、表格、圖表、資料庫或網頁圖示替換為通用方塊、星星、火花或抽象標記。
  • 當使用者提供新的 SVG 圖示時,將原始 SVG 儲存在 assets/icons/<category>/ 下,在 index.json 中新增一個條目,然後在場景計劃中透過 id 引用它。
  • 對於比較場景,圖示的選擇本身即具有意義。保持模型圖示在大小與位置上視覺一致,以便觀眾在小黑開始移動物體之前就能辨識參與者。

模板

當請求類似於包含移動物體、箭頭、註解或小黑動作的手繪漫畫場景時,使用 assets/templates/xiaohei-comic-motion/ 作為起始模板。

當請求要求多個變體、可重複使用的系列,或為口播解釋場景提供更廣泛的參考集時,使用 assets/templates/xiaohei-series-reference/。

將模板複製到專案輸出資料夾中,然後編輯:

  • SVG 群組名稱。
  • 手寫標籤。
  • 物體位置。
  • 時間軸標籤與持續時間。
  • README 中關於該場景特定隱喻的說明。

品質檢查

在最終回應之前:

  • 在本機伺服器中開啟 HTML。
  • 檢查主控台是否有錯誤。
  • 使用 ?static=1 擷取靜態截圖。
  • 當場景包含多個節拍時,至少擷取一個播放中幀。如果可行,使用 ?frame=mid 來獲取確定的審查幀。
  • 目視檢查文字、箭頭、小黑、道具、腰帶、坑洞、卡片以及最終撞擊點是否重疊。
  • 確認動畫有可見的進展:先呈現背景,再是動作,接著是問題/結果,最後是總結。
  • 確認註解僅在它們說明的物體/動作出現之後才顯示。
  • 如果物體移動已顯示方向,則移除裝飾性或半透明的引導箭頭。
  • 確認小黑是動作的一部分。
  • 確認頁面不僅僅是 <img> 標籤中的 PNG,除非使用者明確要求僅做 PNG 的鏡頭移動。

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

给剪好的口播配画面:在录屏上盖 HTML 层(圈重点标注 / 小黑整屏动画 / 推近),层绑字幕屏、由播放器逐帧驱动、直接在预览里看。用户说做分镜、配画面、加动画、圈重点、B-roll、做 storyboard 时使用。不要用于删词剪辑、字幕、物理剪切或成片渲染。

相關技能