教學影片提示的作用與一般影片提示不同。當電影剪輯能夠傳達一種動作或情緒時，它就能成功。只有當查看者可以識別操作、查看結果狀態並在預期狀態未出現時恢復時，教程才會成功。
我們分析了 TapVid 策劃的 Good Case 庫中的 16 教學Brief。Prompt 中位數僅包含 242 字符，遠短於同一語料庫中的解釋器和長格式切片。視覺方向出現在簡報的62.5%中，場景結構出現在56.3％中。源素材出現在25%中，固定事實出現在25%中，明確互動指令出現在25%中。
這項發現並不意味著簡短的提示是不好的。它表明許多教程提示的行為類似於主題請求而不是教學規範。對於客戶教育、入職或功能培訓，缺少的單元通常不是另一種風格的形容詞。這是行動-觀察-恢復循環。
01
我們如何分析教學影片提示
TapVid 的 Good Case 庫於 2026 年 9 月 1 日被凍結。我們透過要求完整提示、公共共享 URL、產生 URL 和 MP4 附件創建了嚴格的 64 記錄語料庫。本文涵蓋標記為教學課程的 16 記錄。標籤是多標籤的，因此切片可以與解釋者、社交影片和較長的作品重疊。
我們使用確定性關鍵字字典對提示文字中的十個欄位進行編碼：受眾、持續時間、源素材、場景結構、固定事實、視覺系統、音訊、CTA、寬高比以及場景或螢幕元素之間的互動。
這是明確性分析，而不是輸出品質分數。創建者可以在介面中選擇寬高比，在單獨的欄位中上傳螢幕截圖，或在提示之外討論觀眾。策劃的樣本也無法告訴我們所有教程世代成功的百分比。它展示了選定的簡報如何表達製作決策。
我們僅報告總量。文章後面的案例已經公開，不再轉載私人使用者提示。
02
教學影片提示基準測試結果
| 顯式字段 | 16 份 Brief 中占比 | 計數 |
|---|---|---|
| 視覺系統 | 62.5% | 10 |
| 場景結構 | 56.3% | 9 |
| 持續時間 | 43.8% | 7 |
| 音訊 | 43.8% | 7 |
| CTA | 31.3% | 5 |
| 源素材 | 25.0% | 4 |
| 固定事實 | 25.0% | 4 |
| 互動 | 25.0% | 4 |
| 觀眾 | 18.8% | 3 |
| 縱橫比 | 12.5% | 2 |
242字元的中位數是語料庫描述，而不是推薦。有些簡報可能很短，因為主題很熟悉，或者因為結構化的設定存在於其他地方。當希望透過簡短的提示來教導真實的產品工作流程時，就會出現風險。像 `make a tutorial about exporting reports` 這樣的主題留下了未解答的問題：
- 目前的產品版本和螢幕狀態是什麼？
- 誰在出口？為什麼？
- 觀眾應該採取什麼具體行動？
- 點擊後應該會出現什麼？
- 如果該選項已停用或遺失會發生什麼？
- 哪些標籤、值或警告必須保持字面意思？
如果沒有這些答案，產生的教程可能看起來很有指導意義，但教授的路徑並不存在。
03
教學提示需要一個動作-觀察-恢復單元
公共提示指南通常會教導主題、動作、背景、相機、燈光和風格。該結構對於單一生成的鏡頭有效。這對於軟體入門或產品教育來說是不夠的，因為查看者需要狀態變更。
將這個由三個部分組成的單元用於每個教學步驟：
- 操作： 使用者使用精確的可見控制項執行的操作。
- 觀察：螢幕上發生了什麼變化以及使用者如何知道該步驟有效。
- 恢復：沒有出現預期狀態時要檢查什麼。
對於虛構的報導工具：
| 單位 | 教程指導 |
|---|---|
| 行動 | 開啟報告，選擇 `Export`，然後選擇 `CSV`。 |
| 觀察 | 下載開始，報告名稱出現在檔案名稱中。 |
| 恢復 | 如果 `Export` 不可用，請驗證檢視者是否具有匯出權限以及報表是否已完成載入。 |
這種結構將影片從敘述的點擊路徑更改為可用的指令。恢復不需要很長的故障排除部分。一個誠實的分支通常足以防止觀眾假設他們犯了錯誤。
04
將演示證據與生成的裝飾分開
16 教學Brief中只有四個明確指定了源素材。這個數字值得仔細解釋，因為上傳可能會在提示之外到達。儘管如此，教程製作簡介應該清楚地區分證據通道和裝飾通道。
演示證據包括當前的螢幕錄製、螢幕截圖、實體產品鏡頭、圖表、標籤、按鈕、設定、錯誤狀態和批准的文件。這些資產教導工作流程，不應重新繪製為合理的替代品。
生成的裝飾可以包括中性開口、抽象過渡、連接運動圖形、背景紋理或非產品隱喻。這些視覺效果可以使課程更容易理解，但它們不應該假裝是介面或產品狀態。
對於資產主導的教程，為每個腳本步驟分配一個演示來源：
| 步驟 | 腳本行 | 證據資產 | 允許編輯 | 通過條件 |
|---|---|---|---|---|
| 1 | `Open Settings` | `settings-entry.mp4` | 裁剪和遊標突出顯示 | 目前標籤可讀 |
| 2 | `Choose Team Access` | `team-access-panel.png` | 縮放和註釋 | 出現正確的面板和權限 |
| 3 | `Invite a teammate` | `invite-flow.mp4` | 修剪死区时间 | 電子郵件欄位和確認狀態匹配 |
| 恢復 | `If Invite is disabled...` | `permission-warning.png` | 突出显示警告 | 確切的警告和所需的角色是可見的 |
源表也使得更新成本更低。當產品 UI 發生變化時，團隊可以識別受影響的步驟，而無需審查每個抽象指令。
05
如何編寫教學影片提示
定義檢視器的起始狀態
觀眾標籤是不夠的。 `New users` 可能表示已建立帳戶的人、已匯入資料的人或從未開啟過產品的人。說明先決條件和期望的最終狀態。
查看者從一個已批准的帳戶、一份現有報告和匯出權限開始。最後，檢視者已將目前篩選的視圖下載為 CSV 格式，並且可以識別該檔案。
範例中只有三個提示明確指定了受眾。明確起始狀態可以防止跳過先決條件和無法解釋的畫面。
將任務分解為可驗證的步驟
場景的變化應該對應於教學的變化。每個步驟使用一個主要操作。如果一個步驟包含五次單擊，請將其拆分，除非所有五次單擊都發生在穩定的螢幕狀態下。
每個場景記錄可以包含：
- 步骤编号和目的
- 準確的敘述
- 所需的源素材
- 螢幕上的動作
- 預期觀察
- 一種恢復路徑
- 文字必須保持字面意思
- 大概時間
結果類似於一個輕量級測試案例。那是故意的。當觀看者可以重現某個狀態時，而不是每次過渡都感覺不同時，教學就成功了。
保護標籤和值不被重寫
固定事實明確出現在四個 16 教學簡介中。對產品教育來說，介面標籤和價值觀就是事實。當大小寫、標點符號、數字、單位、計劃名稱、模型名稱和警告文字影響任務時，將其鎖定。
請勿要求型號為 `clean up` 認可的 UI 副本。旁白中更優雅的標籤可以將觀眾引向不存在的控制項。
使用音訊來減少而不是重複認知負荷
音訊出現在七個簡報中。當畫面顯示動作時，旁白應該解釋目的和結果。當觀眾已經可以看到每個可見標籤時，避免大聲朗讀它。
一個有用的模式是：
- 旁白：為什麼這一步很重要。
- 螢幕上的操作：點選或執行什麼操作。
- 標題：精確的控製或值。
- 暫停：有足夠的時間觀察變化的狀態。
以完成狀態結束
五份簡報包括 CTA。對於教程，最佳關閉作業通常會繼續學習的工作流程：`Export your own report`、`Invite one teammate` 或 `Try the recovery check with a test account`。通用的 `learn more` 關閉會浪費觀看者剛剛達到的狀態。
06
可複製的教學影片提示模板
為[觀看者和開始狀態]建立一個[持續時間]的教學影片。
學習成果：
最後，查看者可以[可觀察的任務]並驗證[已完成的狀態]。
使用這些提供的來源作為產品真相：
- [螢幕錄影或影像] 步驟 1
- [螢幕錄影或影像] 步驟 2
- [文件或核准的措詞]用於恢復條件
保留這些標籤和值的字面意思：
- [按鈕、選單、欄位、編號、計劃、型號、警告]
教學場景：
1. 操作：[一個使用者操作]
觀察：【可見成功狀態】
恢復：【一檢查是否出現該狀態】
來源：[資產名稱]
2. 操作：[一個使用者操作]
觀察：【可見成功狀態】
恢復：[一項檢查]
來源：[資產名稱]
3. 完成狀態：[觀看者現在應該看到或擁有的內容]
視覺和聽覺規則：
- 保持提供的產品螢幕完好無損；僅裁剪、縮放和註釋
- 僅將生成的視覺效果用於[開場、過渡或上下文]
- 敘述解釋目的；標題保留精確的控制項和值
- 不要發明螢幕、步驟、標籤、權限或結果
出貨前審核：
- 每個操作都存在於提供的產品證據中
- 每個觀察都遵循顯示的動作
- 目前文件支援恢復建議
- 觀看者可以辨識完成的狀態如果產品單獨控制運行時間、寬高比或語音，請將這些選擇儲存在其結構化欄位中。此模板側重於課程的真相和順序。
07
案例：按可見階段組織的流程教程
公開的TapVid案例像素藝術指南：從花蜜到蜂蜜使用清晰的階段進行過程解釋。它在這裡很有用，因為觀看者可以透過可見的步驟來追蹤轉換，而不是聽到主題的一般描述。
此案例說明了階段結構。並不能證明所描述的過程是完整的科學或操作教程。領域指導仍需要權威來源。
08
教程品質檢查只需五分鐘
交付前，將視訊靜音並詢問操作和結果狀態是否仍然可見。然後隱藏視覺效果並只閱讀旁白。敘述應該解釋目的，而不是發明步驟。最後，根據最新的產品證據審查行動-觀察-恢復表。
當滿足以下任一條件時拒絕場景：
- 遊標點選不可讀或不存在的控制項。
- 旁白命名了螢幕未顯示的狀態。
- 產生的模型將取代目前的產品螢幕。
- 警告、編號、許可或標籤已重寫。
- 教程在觀看者驗證完成之前就結束了。
09
常見問題
教學影片提示應該多詳細？
足夠詳細，可以識別查看者的起始狀態、每個操作、預期觀察、一個復原路徑、正確的源素材和文字標籤。基準測試的中位數是 242 字符，但語料庫無法確定短提示更好。
教學應該使用生成的 UI 嗎？
當影片聲稱教授真實的產品工作流程時，情況並非如此。使用目前的螢幕截圖或錄音作為產品證據。如果生成的視覺效果不作為介面呈現，則它們可以支援上下文和轉換。
教學和解釋器有什麼區別？
解釋者幫助觀眾理解概念、產品或機制。教程可協助觀眾執行和驗證任務。格式可以重疊，但教程需要可操作的狀態變更和恢復指導。
我可以引用這個基準嗎？
是的。引用為：TapVid Prompt Lab，對來自 64 記錄策劃的 Good Case 語料庫的 16 教程Brief的分析，於 2026 年 9 月 9 月凍結。聲明它測量選定輸出中的顯式提示字段，並且不估計總體成功。
