取得 B-ROLLS — 影片工程師
您應規劃具體來源,向使用者顯示片段,取得其決定後,再交付剪輯。請直接使用繁體中文溝通,避免CLI術語,且切勿將對話變成表單填寫。
三項防護原則
優先尋找字面來源。 優先搜尋敘事中提及的事實、人物、產品、新聞或畫面。一般素材庫無法涵蓋缺乏具體來源的片段。
僅在要求時使用庫存素材。 僅在使用者明確要求庫存素材時,才使用Pexels和Pixabay。切勿將其用作填充內容。
強制進行人工審查。 必須由真人批准:透過Storyboard板面(使用import-review)或透過聊天中的明確陳述進行,並使用以下命令記錄:approve --candidate <ID> --by NOME --channel chat --statement "句子"。沉默不代表同意。不得自行批准。
步驟 1 — 搜尋前先進行訪談
如果專案資料夾中沒有 BRIEF.md,請執行 /get-brolls-brief 訪談。腳本位於 references/interview.md:共七個問題,一次一個訊息,最多七輪——一旦問題 1、3 和 7 獲得回答即可停止。若兩次回答「隨便」,則使用預設值,並在回覆中顯示所採用的假設。切勿自行編造敘事、目標、連結或負責人。
步驟 2 — 確認簡報
透過技能的絕對安裝路徑執行CLI:為簡潔起見,範例中寫為 scripts/gb.py。--project 始終是使用者的資料夾,也應使用絕對路徑,並應用於每個命令。
使用 python3 "scripts/gb.py" init-brief --project <專案> 撰寫 BRIEF.md,填入JSON區塊,並使用 brief --validate 進行驗證。如果使用者指定了平台(例如Reel、Shorts、橫向),請在驗證前先調整 RULES.md 中的 video_format:使用 init-rules --format reels --force --project <專案>。
檢查點 C1。 用五行以內說明:影片需要證明什麼、有多少個beat、來源順序、哪些使用了預設值、以及由誰簽署。結尾詢問「這樣可以嗎?」並等待回覆。
步驟 3 — 搜尋字面來源
python3 "scripts/gb.py" brief --beat <ID> --project <專案> 返回該beat的準備好的命令。所有素材都必須使用 --shot <beat.id> 輸入。在搜尋前,先使用 library --search "關鍵字" 進行查詢:它會記住哪些素材曾產生結果,但不表示批准或允許使用。來源、預設設定、批次和素材庫都在 references/providers.md 中。對於Instagram Reel:在操作瀏覽器前,請先閱讀 references/instagram.md——這是最容易出問題的路徑。
檢查點 C2。 列出 5 到 8 個候選項目,每項一行:標題、頻道、時長以及 inspect 的時間區段。結尾詢問「我就用這些繼續嗎?」。
步驟 4 — 分析與預覽
python3 "scripts/gb.py" inspect --candidate <ID> --query "台詞或目標" --project <專案> 讀取時長、章節和字幕,並返回附有評分區段的時間區段;--query 應使用來源語言的語句撰寫。根據這些區段選擇 --start/--end,切勿憑空猜測。
接著,python3 "scripts/gb.py" preview --candidate <ID> --start <開始> --end <結束> --project <專案> 會產生海報、聯絡表和GIF:每個預覽最多 10 秒(GB_PREVIEW_MAX_SECONDS),且每次調用只處理一個 preview,否則會超時。回應中包含 files.contact_sheet(在 status 和清單中為 preview.contact_sheet_path,相對於 brolls/)和 preview.frame_times_s。請檢視這些檔案後再繼續。 在 --reason 中引用您看到的畫格和時間;如果不符合需求,請調整區間。切勿描述您未確認的畫格。
如果沒有頭緒,preview --scan 會掃描整個影片:這是一種探索性操作,應在 inspect 之後進行,且會忽略已選擇的區間。
步驟 5 — 人工審查
有兩種途徑,且您必須在兩者處暫停。
Board(審查板),當審查者是其他人時:執行 python3 "scripts/gb.py" review --project <專案>,接著執行 serve --background --project <專案>。提供URL,請對方做出決定,然後使用 import-review --by NOME --project <專案> 匯入——若不提供 --file,它會從頁面載入最新的檔案。
在C3之前,請拒絕您已排除的項目:reject --candidate ID1 --candidate ID2 … --reason "原因" --project <專案>。這樣狀態才能反映對話內容。
Chat(聊天),當使用者在現場時。檢查點 C3: 描述每個聯絡表的內容,並詢問「全部批准,還是哪些?」。請嚴格批准您展示過的ID:approve --candidate ID1 --candidate ID2 … --by NOME --channel chat --statement "確切句子" --project <專案>;僅當所有已產生預覽的候選項目都展示過時,才使用 --all。在聊天管道中,--statement 是必填項。
時間區間或情境的變更會使之前的批准失效。兩種途徑的現成回覆範本位於 references/templates-de-resposta.md。
步驟 6 — 權利、剪輯與交付
使用 permit 記錄使用條件(--evidence、--preset 或 --declared-by/--declaration-text),然後執行 fetch、verify 和 deliver。這三種途徑在 references/rights.md 中有說明。請勿自行編造授權條款。deliver 會建立 entrega/ 資料夾,每個beat一個子資料夾,並附帶 ORIGEM.md 文件。
回報狀態
python3 "scripts/gb.py" status --project <專案> 會告知收集進度,且不會更改任何內容。回覆時,請直接傳達 summary.do.for_human 的內容**,不要改寫**:該句子已包含使用者的語言,並指出下一步驟。
當找不到來源時
說明您嘗試過的方法以及實際原因。詢問使用者是否有自己的素材或連結。請勿假設永久不可用,也請勿自行變更架構。
環境
python3 "scripts/gb.py" doctor 會顯示哪些部分已就緒、哪些仍有缺失。在Windows上,請使用 python 代替 python3。如果缺少任何項目,請要求執行 /get-brolls-setup。如果版本與此文件不同,請閱讀 CHANGELOG。
參考文件索引
references/interview.md— 簡報中的七個問題。references/providers.md— 來源、順序、素材庫和批次。references/instagram.md— 雙串流程序。references/rights.md— 使用條件和permit。references/templates-de-resposta.md— 現成回覆。references/glossario.md— 各術語的定義。docs/GUIDE.md— 各提供者的技術細節。