Wiki 影片粗剪
將有序程序與素材資料夾轉換成非破壞性的教學影片粗剪套件。接受直接貼到對話中的程序文字或本地的 UTF-8 純文字 / Markdown 檔案。優先使用語音證據，必要時回退到檔名，保留所有錄製片段，並以提供的程序（而非即興旁白）作為字幕的事實來源。
工作流程
-
詢問素材目錄與有序程序。接受直接貼到對話中的文字或本地的 UTF-8 純文字 / Markdown 檔案；若已提供貼上的文字，則無需要求
.md檔案。除非使用者明確要求，否則不要獲取 URL。在呼叫 CLI 之前，將貼上的文字原封不動儲存為該工作的wiki-source.md。 -
僅將有序、有拍攝的動作視為時間軸步驟。不要要求使用者新增未經拍攝的工具清單、準備章節、背景或理論。優先使用
Step 1/2/3、步驟一/二/三或編號清單。將必要的注意事項保留在適用的動作步驟內。 -
從已載入的
SKILL.md定位此技能目錄；切勿假定為.codex、.claude或.cursor路徑。 -
執行能力檢查：
python scripts/roughcut.py doctor -
執行分析。除非使用者要求僅限檔名處理，否則使用
auto模式。在自動模式下，先提取音軌，使用文字時間戳進行轉錄，並測試口語標籤是否與程序步驟相關，之後才考慮檔名：python scripts/roughcut.py run --media "E:\footage" --wiki "E:\job\wiki.md" --output "E:\job\output" --mode auto --preview -
檢查
review.md、edit-plan.json、代表性證據與警告。僅在素材/程序證據支持變更時，才改進wiki-steps.json或edit-plan.json。切勿編造數量、物體、材料、零件、方向或安全聲明。 -
手動更改計畫後重新執行匯出器（目前使用
run進行完整重建）。保留模糊或衝突的素材並標記為待確認；切勿無聲地丟棄輸入媒體。 -
在 Windows 上，使用
jianying10命令從edit-plan.json建立原生的剪映 10/11 專案。首先省略--user-data並在暫存目錄中驗證。在新增--user-data以註冊真實專案前，要求剪映完全關閉。匯出器必須使用最新的有效本地videoeditor.dll加密兩個草稿 JSON 檔案，備份root_meta_info.json，並註冊相符的首頁條目。除非使用者明確授權，否則切勿取代現有草稿。
證據規則
使用此優先順序：使用者修正；程序相關且開始後的口語標籤；有意義的檔名與零件編號；僅供審查用的程序順序/OCR/視覺上下文。像 DJI_0001 這樣的相機檔名不是標籤。如果語音為空或與每個程序步驟都無關，則嘗試使用檔名。如果兩者都無法提供與程序相關的證據，則停止而非猜測，並要求使用者錄製步驟口語標籤或重新命名檔案。保留重複的錄製片段，並在錄製時間之前明確排序零件。將其他不相關的素材放在時間軸結尾，並僅在報告中列出未拍攝的程序步驟。
開始提示語為 321開始、三二一開始、321走 或獨立的 開始/走。結束提示語為獨立的 OK、過、可以、好了 或 結束。不要修剪短語內部的詞語，例如 可以安裝 或 開始拆卸。檔案結束是有效的片段結束。
字幕與輸出
根據提供的程序建立正式字幕，並對語法進行輕微潤飾以利自然閱讀。保留步驟中陳述的名稱、數量、方向與警告。使用兩個獨立的可移除音軌：文档字幕 與確切文字 待確認。保持原始音訊與原始 4K 檔案不變。
輸出合約與 JSON 欄位定義在 schemas.md。請閱讀 usage.md 以了解平台/設定細節，並在註冊剪映專案前閱讀 jianying10.md。在協助拍攝慣例時，請閱讀 shooting-guide.md、filename-guide.md 與 wiki-format.md。
失敗處理
僅使用多語言 faster-whisper small 模型。不要使用 tiny 替代。如果 small 缺失或不完整，則停止語音分析並顯示單一命令 scripts/download-model.ps1 或 scripts/download-model.sh 修復。對於其他辨識或 OCR 失敗，保留所有媒體，使用剩餘證據，並在 review.md 中記錄回退。如果缺少 FFmpeg，仍然輸出計畫、SRT、FCPXML 與草稿候選；省略預覽。如果剪映加密或註冊失敗，則保留暫存草稿、診斷資訊、SRT、FCPXML 與 edit-plan.json；切勿自動取代、降級或解除安裝使用者的剪映。