氛圍剪輯：剪輯
將原始片段轉換為保留原意的剪輯，然後交給引擎處理圖形。 代理提議並編寫；渲染器計算幀；作者決定並接受。 在設計之前先核准故事：每次意義的變更都會強制重新建構。
- 依素材選擇路徑與工具：
references/routes.md - EDL 與兩個時鐘：
references/edl-format.md - 轉錄與辨識器：
references/transcripts.md - 剪輯語音：
references/cutting.md - 字幕：
references/captions.md - 音效：
references/audio.md - 插入片段、版面、9:16、其他語言：
references/inserts-and-layouts.md - 螢幕錄影：
references/screen-recordings.md - 資料夾、簡報與
project.md：references/project-memory.md - 作者提供的筆記：
references/edit-requests.md - 資料、授權與費用：
references/data-and-licences.md - 計畫格式：
references/plan-format.md - 此儲存庫的測量結果：
references/measured-behavior.md - 版本與日期：
references/versions.md - 引用來源：
references/sources.md
契約
- 階段 1 為唯讀。 工具鏈報告、媒體盤點、讀取現有轉錄稿以及撰寫計畫，都不會變更任何內容，也不會傳送任何資料。
- 未經項目 ID 核准，不得進行剪輯、渲染、上傳、安裝或付費呼叫
(
references/plan-format.md)。 在計畫存在之前，「縮短它」是對計畫的請求。 - 原始檔案絕不變更。
工作複本放入
work/，渲染結果放入renders/，交付檔案放入exports/。edl.py render除非加上--force，否則拒絕覆蓋來源檔案或現有檔案。 - 兩個時鐘。
來源時間用於片段，輸出時間用於檢視者看到的一切；
使用
edl.py map和edl.py retime進行轉換，絕不手動。 - 引用或標示。
關於工具的聲明須引用
references/sources.md或 已測量 章節； 版本與價格來自references/versions.md及其日期； 品味或意義的判斷須標示為判斷。 - 誠實報告驗證結果。 幀檢查會遺漏節奏；腳本檢查會遺漏意義。 說明已觀看、聆聽、掃描了哪些內容——以及哪些尚未檢查。
1. 預檢
python3 scripts/toolchain_report.py --format markdown
python3 scripts/media_probe.py originals/ --format markdown
- 工具鏈報告說明此機器能夠執行哪些操作： 幀精確渲染、燒錄字幕（許多 FFmpeg 建置版本無法做到，請見 已測量 M7）、 響度測量、本地語音辨識、HyperFrames、Remotion； 以及設定了哪些 API 金鑰名稱（絕不顯示其值）。
- 媒體盤點會標記會影響剪輯的特性：
可變幀率 (
MED001)、旋轉 (MED002)、HDR (MED010)、 混合幀率或音訊格式 (MED004、MED005)；規則位於此技能儲存庫的CHECKS.md中。 - 閱讀專案本身的說明和
project.md（如果存在的話）。 - 撰寫簡報，或詢問欠缺的資訊：觀眾與重點、交付格式、必須保留的內容、不可出現的內容、雲端 (
references/project-memory.md)。
2. 路徑
根據素材和交付格式選擇路徑 (references/routes.md)。
此技能負責剪輯：片段、連接處、EDL、渲染、新時間軸上的字幕和音效。
圖形屬於引擎的其他技能：HyperFrames (hyperframes、general-video、hyperframes-core)
或 Remotion (remotion-best-practices)。
在必須保持不變的片段上的字幕或疊加，屬於 embedded-captions 或 talking-head-recut。
3. 轉錄
- 每個來源的字詞時間戳記，建立一次，保存在
transcripts/中 (references/transcripts.md)。 - 雲端辨識會將音訊傳送出去並產生費用；本地辨識則需要安裝。 兩者都需等待核准，並在計畫中註明提供者、費用和資料。
- 在規劃任何剪輯之前，請根據詞彙表更正名稱和數字。
4. 規劃故事
- 素材表格：來源、進出點、逐字片語、音效、可見內容、可能的作用。
- 三個開場，每個都說明觀眾在前幾秒鐘會理解到什麼。
- 候選項目：
python3 scripts/edl.py candidates --words transcripts/<take>.json— 需要考慮的停頓、重複和填充詞，絕不自動剪除 (references/cutting.md)。 - 以節拍敘述故事，然後建立
edit/edl.json：每個片段都附帶理由 (references/edl-format.md)。 python3 scripts/edl.py check edit/edl.json --probe、table和cuts --probe： 顯示包含兩個時鐘的片段，以及每個被移除的區間，供作者閱讀。- 有疑慮的剪輯放入
edit/edl_b.json，而非版本 A。
5. 渲染草稿
python3 scripts/edl.py render edit/edl.json -o renders/draft_v1.mp4 --size 640x360 --preset veryfast
- 每個片段都會在幀邊界上重新編碼，並有 10 毫秒的音訊淡入淡出，縮放到統一尺寸 (已測量 M1、M3、M4)。串流複製的剪輯絕不會是幀精確的 (已測量 M2)。
- 第一版草稿沒有音樂、字幕或特效：僅包含語音和畫面。
- 使用耳機聆聽每個連接處；檢查兩側的幀。
使用精簡的筆記 (
references/edit-requests.md) 和新的 EDL 版本進行修正。
6. 字幕、音效、插入片段
- 字幕：
edl.py retime將字詞時間移至輸出時間軸；captions.py build將其分組；captions.py check套用限制 (references/captions.md)。 - 音效： 先處理語音，然後是帶有閃避效果的音樂，最後是特效；
根據簡報的目標測量響度，並明確設定
loudnorm目標 (references/audio.md)。 - 插入片段： 在輸出時間軸上標記它們 (
edl.py map)，核准一個靜止幀， 然後在引擎中建立它們；edl.py hyperframes和edl.py remotion交出剪輯 (references/inserts-and-layouts.md)。 - 其他格式： 9:16 版本是新的版面，而非中央裁切。
7. 交接
- 在宣布影片完成之前，執行審查：
vibe-editing-review技能，或至少使用python3 scripts/qa_scan.py搭配簡報、EDL 和字幕。 - 更新
project.md：已核准的 EDL 版本、最後一次成功的渲染、指令、資產與授權、未解決的缺陷。
工作流程
階段 1 — 建議
- 預檢： 工具鏈報告、媒體盤點、簡報、專案說明。
- 規劃 使用
references/plan-format.md： 來源與轉換；故事與 EDL v1；移除的區間；有疑慮的剪輯； 字幕、音效與插入片段；資料、費用與授權；此處無法驗證的內容。 - 詢問 要套用哪些項目 ID。
階段 2 — 套用與驗證
- 僅套用已核准的項目，一次一個層級：故事、節奏、文字、畫面、音效。
- 每次變更後，使用前後各一秒的上下文渲染或預覽相同範圍，並聆聽。
- 重新執行
edl.py check和captions.py check；對每個交給作者的草稿執行qa_scan.py。 - 更新項目狀態和
project.md；報告尚未驗證的內容。
防護措施
- 在階段 1 中，不得剪輯、渲染、上傳、雲端轉錄或安裝任何內容。
- 不得變更或重新編碼
originals/中的檔案。 - 不得對需要幀精確的剪輯使用串流複製。
- 不得依據來源時間放置字幕或插入片段。
- 不得使用單一閾值移除所有停頓，或在未經作者決定的情況下合成缺失的字詞。
- 不得在對話、日誌或檔案中列印金鑰或令牌。
- 不得在沒有記錄來源和授權的情況下添加音樂、字型或片段。
- 不得越權處理引擎的領域：組合程式碼屬於 HyperFrames 或 Remotion 技能。