Communitygithub.com

scripted-video

規劃、研究、撰寫、審查並匯出影片,這些影片以腳本形式撰寫(數據與程式碼,而非時間軸編輯),並渲染成 mp4 格式。每當使用者想要製作影片、教學、解說、課程、課程模組、產品導覽、操作指南、動畫簡報、YouTube 影片、短直式短片或應用程式內教學,或是要求「為了影片」研究某個主題、撰寫或審查影片腳本、加入旁白、字幕、章節、配音、音效、音樂或翻譯,改善或修正以此方式製作的影片,或將文件、課程或簡報轉換成影片時,請使用此技能。它涵蓋了整個工作流程(研究方法、透過幾輪檢查進行研究,深入程度比影片敘述更深一層,並為後續影片尋找主題、反對觀點與真實案例、心智圖、分鏡腳本、核心長度腳本與依要求提供的較長版本、準確性與理解度審查、逐幀視覺審查、語音、產生的音效與音樂、匯出)。

scripted-video 是什麼?

`scripted-video` 是一項功能強大的 AI 代理技能,專為自動化從研究到匯出的整個影片製作流程而設計。它將影片視為一個「腳本」——一個純文字與資料的檔案——然後透過一個小巧的渲染引擎將其轉換為帶有語音、字幕和章節的 MP4 影片。這項技能的核心哲學在於,製作教學影片最困難的部分並非技術實現,而是敘事本身:找到一個真實、結構清晰且易於理解的故事。因此,它會引導代理依序通過 14 個階段,從撰寫簡報、進行深度研究(包含反對觀點與真實案例)、繪製心智圖、建立分鏡腳本、撰寫核心長度腳本,到執行嚴格的準確性、理解度和視覺審查,最後才進行配音、音效、音樂和最終匯出。這項技能特別強調研究深度要比影片敘述的內容更深一層,以便能做出明智的取捨,並自動為未來影片產生主題。它支援 Node.js(Chrome/Edge 和 ffmpeg),最終目標是交付一個無需請求者費心修正的成品。

相容平台~Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/utoappia/skill-tutorial_video_creation/tree/HEAD/skills/scripted-video

在你喜歡的 AI 中提問

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

說明文件

腳本化影片 (Scripted Video)

此處的影片是一個腳本:一個說明說話內容、畫面上顯示內容及其時間的檔案。一個小型引擎(位於 starter/)會將其轉換為瀏覽器中的圖片,以及附帶聲音、字幕和章節的 .mp4 檔案。由於影片是文字,你可以撰寫它、檢查它、逐行審查、查看每一幀、翻譯它,並修正一個詞而無需重新編輯任何內容。

引擎是簡單的那一半。一個具有教學意義的影片需要一個真實的故事,以觀眾能理解的順序講述,使用他們熟悉的詞彙,並配上指向語音所提及內容的圖片。這項技能的大部分內容都與那一半有關。請依序執行各個階段;每個階段都會產生一個檔案供下一個階段讀取,因此工作能在長時間的會話中存續,並且第二個代理可以接手。

目標是交付一個請求者無需修正的影片。 他們的時間是你正在節省的成本。因此:決定你能決定的並寫下決定;使用他們提供的每一個服務、金鑰和事實;在交付之前,以他們的角度觀看影片(請參閱「交付之前」)。請求者最先注意到的幾乎從來不是檢查工具能找到的違規事項。它們是影片從未回答的猜測、一個沒有任何真實內容的主題,以及聽起來未完待續的影片。

對於關於世界的每部影片,有三項原則。此處各說明一次;下方的階段以及 references/research.md 會應用它們並提供方法。

  • 以核心深度敘述;研究深度則更深一層。 你交付的影片是核心:在保持承諾、真實且公平的前提下最短的敘述:對於有真實故事的主題大約 10 到 20 分鐘,對於單一機制則更短。請求者指定的長度是限制並優先採用;研究深度會隨之縮減。研究則深入一層,達到細節的深度(人物、關鍵日子、確切手段、競爭對手、調查發現的內容),以便在知情的情況下選擇核心,並讓相鄰主題浮現:一個事件、一個機構或一個與主要主題相關且本身有故事的想法。每個相鄰主題都會成為 research/next-videos.md 中的一行,包含已知資訊,並且不會進一步研究。在細節之下(每個人的後半生、每份完整文件、機構的完整歷史)是另一部影片的研究範疇:在一個專案中,擴展到那裡使影片長達六小時,而 18 分鐘的核心才是請求者想要的。僅在要求時才製作較長版本。
  • 每個真實案例都應展示主要主題的運作。 一個真實故事只有當影片所講述的內容在其中實際發生,且如同資料來源所述時,才會被放入影片中:例如,關於期貨市場的影片,其中應包含在交易所交易的期貨合約、追繳保證金、合約結算等。一個僅有相關性(同一時代、一個著名名字、看似相似但以其他方式進行的賭注)的故事,無論多麼著名,即使請求者建議使用,都應排除。在第一輪研究中,在花費任何深度之前,先在資料來源處檢查這一點。在一個專案中,為期貨影片提供的最著名故事,結果竟是透過與銀行的私下交易進行的賭注;它在兩個版本都講述了這個故事後被移除。不過,簡短並非單薄:在核心中,每個真實案例都應包含人物、日期、確切手段、數額、事情可能如何走向另一種結果、如何結束,以及它顯示了關於主要主題的什麼。
  • 研究有邊界且有終點。 每個線索在花費搜尋資源之前,都必須與主要主題進行比對;失敗的線索則寫成一行並擱置(「有趣」不足以開啟它)。計劃進行三輪研究(大綱、細節,以及在資料來源處對影片將要說的所有內容進行雙重檢查),以及一輪簡短的第四輪研究,僅針對核心需要的已命名項目。更多輪次則由請求者決定。

預設觀眾: 初次接觸該主題的人。寫作時要讓 8 歲的孩子也能理解,但使用成人不會覺得幼稚的冷靜、專業措辭。簡單不等於幼稚:使用簡短的句子、日常用語、一次一個想法,不要用兒語。僅在簡報指定不同觀眾時才更改此設定。

設定

將此技能的 starter/ 資料夾複製到使用者的專案中(例如作為 video/),然後執行:

cd video
npm install            # 一個小型依賴項;它使用機器上已有的 Chrome
node tools/check.mjs   # 範例影片應能通過檢查

需求:Node 18 或更新版本;Chrome、Edge 或 Chromium(用於繪製圖片);ffmpeg(用於錄製語音和匯出)。如果缺少任何一項,請參閱 references/troubleshooting.md。請勿在技能資料夾本身內部工作;請在複製的資料夾中工作。

該複製資料夾包含一個範例 videos/hello.json:十五秒的純資料,帶有翻譯和垂直佈局,用於檢查設定是否正常運作。每個階段應產生的內容都定義在 node tools/new.mjs 建立的檔案中:每個階段都以自己的檢查清單開頭。當使用者自己的影片開始進行時,請刪除此範例。

階段

每個影片都從執行 node tools/new.mjs <id> "<Title>" 開始。它會建立 notes/<id>/(下面命名的檔案,包含其檢查清單)以及 videos/<id>.mjs 中的腳本骨架。

#階段你產生的內容完成條件閱讀資料
0簡報notes/<id>/brief.md觀眾、承諾(「觀看後,觀眾可以……」)、長度、形式與語言都已寫下,包含請求者明確要求的每一項內容。下方說明
1研究方法research/00-how-to-research.md你了解熟悉此領域的人如何發現事情,以及初學者常在哪裡出錯。references/research.md
2研究,三輪research/NN-name.md、research/leads.md、research/next-videos.md、research/index.mdleads.md 中的每個線索都已關閉(已研究、未找到、下一部影片、離題或待處理);每個真實案例都通過了案例測試,並且已知其細節深度;其他觀點和迷思已研究;第三輪已在其來源處重新閱讀了將要放入影片的每一個主張,且每個主張都有來源和信心標籤;請求者記得的內容已有結論。完整清單:references/research.md,第 11 節。references/research.md
3心智圖mindmap.json每個已研究的想法都是 core(在影片中)、support(已研究且為真,但不放入核心)或 cut(未確認、不公平或離題);僅 core 想法就能維持承諾;node tools/mindmap.mjs <id> 回報無錯誤。references/planning.md
4分鏡腳本storyboard.md、assets.md每個節拍都有圖片、要旨、元件和聲音(通常為無);底部的檢查項目已勾選。references/planning.md
5腳本videos/<id>.mjsnode tools/check.mjs <id> 回報無錯誤,且你已閱讀每個警告。腳本長度為核心長度。references/authoring-kit.md、references/components.md
6準確性審查review/accuracy.md、research/index.md(僅在完整說明時需要 review/coverage.md)dump --claims 的每一行都有結論和來源;對於每個真實故事,未撰寫該故事的審查員已比對腳本、筆記和來源(或者,若無第二位代理,則由你進行比對,並在檔案中註明「非獨立」);研究已對照腳本重新閱讀,且核心需要但缺少的內容現在已包含在內;修正已寫回筆記中。references/script-review.md
7理解度審查review/WhatIHaveLearned.md、review/lost-points.md日記能無間隙地達成承諾,且每個可能迷失方向的地方都有修正方法或理由。references/script-review.md
8視覺審查review/visual.md你已查看每一張靜止圖片,沒有任何內容被切斷、遮蓋、空白或無法閱讀。references/visual-review.md
9語音與聲音out/tts/ 中的錄製行、assets/<id>/ 中的聲音腳本已通過第 6 至第 8 階段,且語音已錄製完成;時間點現在跟隨真實語音。事件音效已設定;如有音樂,僅放置在故事部分之下。references/voice-and-assets.md
10匯出與最終觀看out/<id>.mp4、.srt、.vtt、.chapters.txt你已查看匯出檔案本身的影格,並檢查其聲音。references/export-and-publish.md
11其他語言與格式(如有要求)videos/i18n/<id>.<lang>.json每種語言都能通過 check 檢查,且其靜止圖片已被查看。references/localization.md
12發布工具包publish.md標題、描述、章節、字幕、縮圖、來源與致謝已準備就緒。references/export-and-publish.md
13交付給請求者的訊息已完成以請求者視角的檢查;訊息說明了已決定的事項、已修正的事項以及仍待解決的事項。references/finishing-and-revising.md

從第 4 階段開始適用的寫作規則,位於 references/writing-for-everyone.md(詞彙與句子)和 references/teaching-techniques.md(如何讓概念鮮明)。references/visual-design.md 涵蓋佈局、色彩與動態。在撰寫第一個腳本之前,請先閱讀這三份文件。

第 0 階段:簡報

根據使用者所述內容填寫 brief.md。對於其他所有內容,寫下你最佳假設,並標記為「(assumed)」;不要停下來詢問(請參閱「決定、記錄、繼續」)。最重要的一行是承諾:以「觀看後,觀眾可以……」開頭的句子。每個後續的決定(要研究什麼、要刪減什麼、影片何時完成)都將以此為依據。同時記錄觀眾已知的內容,因為那是影片的起點。

在簡報中以請求者自己的措辭複製他們明確要求的每一項內容:要使用的服務、金鑰及其位置、要包含的範例或事件、他們記得的某個事實、他們覺得困惑的部分、一個限制(「大部分內容不要有音樂」)。每一項都是交付前需要勾選的項目。現在就檢查已命名的服務是否可及,而不是等到第 9 階段;他們記住的事實會作為需要驗證的內容傳遞給研究,而不是作為需要重複的內容。

在此處決定是否需要研究。僅當內容已完全給定(使用者自己的產品、他們撰寫的腳本、他們描述的流程)且你未添加任何自己的事實時,才跳過第 1 和第 2 階段。如果你要添加任何一個數字、日期、名稱或「因為」,請進行研究。

第 1 和第 2 階段:研究

在研究主題之前,先研究如何研究它:進行兩到三次搜尋,了解人們如何學習和調查這個領域,並往上提升一層(例如,對於債券市場:「如何了解債券市場」,然後「如何了解經濟」)。它們會告訴你哪些來源重要、哪些數字重要,以及初學者常在哪裡出錯。然後進行三輪研究:

  1. 大綱。每個主題一則筆記,頂部附有摘要:附帶來源的事實、真實事件(每個事件在記錄前都先經過案例測試)、日常生活中的比喻,以及最強烈的反對觀點與迷思,其研究程度應與主線一樣仔細。
  2. 細節。列出筆記中提到但未解釋的每個人名、地名、日期、數字、術語、機制、原因和引文,存在 research/leads.md 中。研究那些與主要主題相關的項目,一次,達到細節的深度。相鄰的主題放入 next-videos.md;其餘的則標記為離題。
  3. 雙重檢查。沒有新的主題。在其來源處再次閱讀影片將要說的一切內容;為令人驚訝的主張、顯示故事規模的數字、引文以及任何對指名人物有負面影響的內容,尋找第二個獨立來源。

在開始之前計劃好搜尋,並保留三分之一給第三輪。如果你可以啟動其他代理,請將每個真實事件交給其專屬代理,並將雙重檢查交給一個未撰寫該筆記的代理。

完成的影片必須能夠運用的兩項內容:

  • 真實事件,已知細節深度。 一個虛構的人物可以使概念易於理解;一個真實事件則能讓觀眾相信並記住它。對於有歷史的主題(市場、技術、機構),至少研究兩個事件。如果其中一個顯示某人獲勝,請研究它如何可能失敗,並找一個有人失敗的例子:僅有勝利會傳達錯誤的教訓。對於自然機制或方法(天空為何是藍色、如何打繩結),一個真實的觀察、測量或發現就足夠了,或者完全不需要:在簡報中寫下「無,因為……」。
  • 請求者記得的內容,經過驗證。 它是一個線索,而且常常有一部分是錯的。驗證每個部分,使用成立的內容,並告訴他們你修正了什麼以及原因;永遠不要因為「請求者是這麼說的」而重複一個主張,也永遠不要默默地忽略它。

詳細資訊:references/research.md。

第 3 階段:心智圖

mindmap.json 是一個簡短的樹狀結構,包含影片可能包含的每個想法(節點類型列於 references/planning.md 第 1 節;當某個節點錯誤時,node tools/mindmap.mjs 會指出該名稱)。每個節點用幾個字說明該想法是什麼、其詳細資訊在研究中的位置("file.md#Heading")、觀眾需要先了解哪些想法,以及它與其他地方哪些想法相關。每個想法是 core(在影片中:承諾需要它、沒有它無法講述真實故事、或公平性需要它)、support(已研究且為真,但不放入核心:作為描述的素材,如果請求者要求則作為較長版本,或作為下一部影片的主題)或 cut(未確認、無法公平地講述、或與主要主題無關;一個未通過案例測試的真實故事是 cut)。該工具會檢查每個指標是否指向某處,以及是否在學到必要知識之前就進行教學。詳細資訊:references/planning.md。

第 4 階段:分鏡腳本

一個表格,每個節拍一行:觀眾看到的內容、語音說明的要旨、哪個元件繪製它、是否有新詞出現,以及除了語音之外還能聽到什麼(對於更多詳細資訊,請參閱以下說明……)

相關技能