腳本化影片 (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.md | leads.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>.mjs | node 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 階段:研究
在研究主題之前,先研究如何研究它:進行兩到三次搜尋,了解人們如何學習和調查這個領域,並往上提升一層(例如,對於債券市場:「如何了解債券市場」,然後「如何了解經濟」)。它們會告訴你哪些來源重要、哪些數字重要,以及初學者常在哪裡出錯。然後進行三輪研究:
- 大綱。每個主題一則筆記,頂部附有摘要:附帶來源的事實、真實事件(每個事件在記錄前都先經過案例測試)、日常生活中的比喻,以及最強烈的反對觀點與迷思,其研究程度應與主線一樣仔細。
- 細節。列出筆記中提到但未解釋的每個人名、地名、日期、數字、術語、機制、原因和引文,存在
research/leads.md中。研究那些與主要主題相關的項目,一次,達到細節的深度。相鄰的主題放入next-videos.md;其餘的則標記為離題。 - 雙重檢查。沒有新的主題。在其來源處再次閱讀影片將要說的一切內容;為令人驚訝的主張、顯示故事規模的數字、引文以及任何對指名人物有負面影響的內容,尋找第二個獨立來源。
在開始之前計劃好搜尋,並保留三分之一給第三輪。如果你可以啟動其他代理,請將每個真實事件交給其專屬代理,並將雙重檢查交給一個未撰寫該筆記的代理。
完成的影片必須能夠運用的兩項內容:
- 真實事件,已知細節深度。 一個虛構的人物可以使概念易於理解;一個真實事件則能讓觀眾相信並記住它。對於有歷史的主題(市場、技術、機構),至少研究兩個事件。如果其中一個顯示某人獲勝,請研究它如何可能失敗,並找一個有人失敗的例子:僅有勝利會傳達錯誤的教訓。對於自然機制或方法(天空為何是藍色、如何打繩結),一個真實的觀察、測量或發現就足夠了,或者完全不需要:在簡報中寫下「無,因為……」。
- 請求者記得的內容,經過驗證。 它是一個線索,而且常常有一部分是錯的。驗證每個部分,使用成立的內容,並告訴他們你修正了什麼以及原因;永遠不要因為「請求者是這麼說的」而重複一個主張,也永遠不要默默地忽略它。
詳細資訊: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 階段:分鏡腳本
一個表格,每個節拍一行:觀眾看到的內容、語音說明的要旨、哪個元件繪製它、是否有新詞出現,以及除了語音之外還能聽到什麼(對於更多詳細資訊,請參閱以下說明……)