Communitygithub.com

by-lua/video-editing

收集、預覽並交付B-roll素材,包含人工審查與來源記錄。當有人要求B-roll、輔助影片、輔助圖片、cutaway、insert、片段、「某人在說某事的一段畫面」、網站或新聞截圖,或用於影片、Reel或課程的素材時使用——搜尋YouTube、Instagram、TikTok、Wikimedia Commons、NASA或素材庫(Pexels、Pixabay),產生預覽供人工審查,並交付帶有來源與使用條件的片段。不適用於編輯、剪接或渲染最終影片。

video-editing 是什麼?

這個AI技能定義了一個結構化的工作流程,用於收集、預覽及交付B-roll素材(包括剪接鏡頭、插播畫面、輔助影片、庫存影片與螢幕截圖)。它強制要求先尋找與敘事直接相關的字面來源(例如特定人物、新聞事件或產品),僅在明確要求時才使用一般庫存素材。支援的來源包括YouTube、Instagram、TikTok、Wikimedia Commons、NASA、Pexels與Pixabay。關鍵原則是每次交付前必須進行人工審查:透過Storyboard板面進行審查與匯入,或直接在聊天中明確批准(必須使用`approve`命令並附上確切陳述)。該技能也管理使用權限記錄(透過`permit`命令,包含證據或來源授權)、最終素材的提取與驗證,並以結構化檔案夾的形式(每個beat一個`entrega/`目錄,附有`ORIGEM.md`文件)進行交付。該技能適用於Claude Code等AI代理平台,使用基於CLI的工具(在Unix上為`python3 scripts/gb.py`,在Windows上為`python scripts/gb.py`)來執行工作流程的每個步驟。它包含明確的運行時檢查點(C1、C2、C3)以中斷操作並等待用戶確認,從而確保最終輸出符合預期且經過授權。它還整合了專案層級的設定(BRIEF.md、RULES.md),並提供用於檢查環境狀態、搜尋先前使用過的素材庫以及取得詳細技術指引的輔助命令。參考文件位於`references/`目錄中。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/by-lua/video-editing/tree/HEAD/plugins/engenheirodevideo/get-brolls/2.5.0

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

取得 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。

參考文件索引

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

by-lua/video-editing

Contorna bloqueio de Cloudflare, "Confirme que é humano", detecção de bot e telas de login em automação de browser. Sobe o Chromium do sistema com perfil persistente e porta CDP, e conecta o agent-browser nele em vez de deixar ele lançar o Chromium empacotado. Use sempre que o agent-browser empacar em desafio do Cloudflare, checkbox de verificação humana, "Just a moment", tela de bot detection, ou quando precisar automatizar site logado com várias contas ao mesmo tempo.

by-lua/video-editing

Escalonamento de baixo nivel do agent-browser. Use quando precisar de CDP cru: interceptar/inspecionar requests de rede, iframes cross-origin, shadow DOM, drag-and-drop, upload/download travado, print-as-PDF, dialogs nativos, ou quando um comando do agent-browser falhar duas vezes no mesmo passo. Padrao continua sendo agent-browser.

by-lua/video-editing

Porta de entrada ÚNICA de criativo de anúncio (Meta/TikTok) — vídeo, imagem estática ou carrossel. Faz a estratégia (briefing, matriz persona × dor/bolha, escolha de formato, quantidade por fase da conta, regras do Kevones 2026) e depois puxa a mecânica certa — `criativo-ads-video-orq` para vídeo, `modelagem-escalados` + `gpt-imagem-playwright` para estático/carrossel, `narracao-hub-tts` para voz. Use sempre que o usuário pedir criativo, anúncio, ad, leva de criativos, hook, variação de criativo, novo ângulo, "criativo de vídeo", "criativo estático", carrossel, banner de anúncio, UGC, modelar um criativo que está escalando, ou mencionar metodologia Kevones de criativo, bolhas, ângulos, gatilhos.

by-lua/video-editing

Mecânica de produção e edição de anúncios em vídeo, chamada por criativo-ads. Use para criativo de vídeo, UGC, hook novo, variação de vencedor, modelagem de escalados, Veo/Flow, cenas com imagem de referência, b-roll, gravação de tela, PiP, narração ou trilha. Cobre briefing, persona/ângulo/oferta, orçamento de palavras, prompts de continuidade/voz/lip-sync, QA de imagem e clipe, montagem, cortes por palavra e gesto, repetição, limpeza de áudio, volume, legendas e entrega. Modos: do zero, hook+body, bodies variados, modelagem Kevones e Vitrine Guiada. Delega geração às skills de browser; usa video-use para cortes, Remotion para composição/legenda, Hyperframes para motion e ffmpeg para medição/normalização/mix. A estratégia da leva vem de criativo-ads; motor e restrições seguem as regras atuais do corpo desta skill.

by-lua/video-editing

Mecânica completa do Google Flow (labs.google/fx/pt/tools/flow) — pega lane, gera imagem OU vídeo via prompt no Omni 1.1 Flash, espera o fim da fila/geração, baixa pelo conteúdo (não pelo "último card"), valida duração+cor bt709+áudio, e move pro projeto. Cobre o pipeline INTEIRO (envio → fila → pronto → download → gate), não só o clique. Use quando a skill-mãe (`tiktok-shop` ou `criativo-ads-video-orq`) pedir vídeo via Flow (alternativa ao Hub quando Hub está expirado). Profile `flow-enovalabs-pro` (porta 9265), logado Google conta contato.inovalabsx; clones -2/3/4 pra paralelo.

by-lua/video-editing

Gera imagens no ChatGPT usando o perfil de browser persistente já logado (sessão gpt). Aceita imagem de referência anexada para manter rosto, produto ou estilo, e gera até 10 imagens separadas por vez. Baixa os resultados direto para a pasta pedida. Use sempre que o usuário pedir para criar, gerar ou editar imagem no GPT/ChatGPT, pedir imagem de referência, mockup, cena, retrato, variação visual, ou disser "gera uma imagem".

by-lua/video-editing

MECÂNICA de estático/carrossel chamada pela skill `criativo-ads` (porta de entrada de todo criativo; estratégia e quantidade moram lá). Modela criativos de anúncio a partir de uma biblioteca local de 103 formatos que já estão escalando (87 estáticos, 16 vídeos, 47 categorias) — anexa a referência real no ChatGPT e adapta para a marca do usuário via pipeline de 12 prompts (brandkit, dossiê, matriz de ângulos, seleção de formato, leitura estrutural, copy, arte 1:1 1080×1080 (9:16 só se pedido), leva de headlines, reenquadramento, gate de QA, ponte para vídeo, nomenclatura). Use quando o usuário pedir criativo estático, modelar/clonar um criativo que está escalando, "modelagem de escalados", leva de anúncios, variação de headline, banco de formatos, biblioteca de anúncios, ou mencionar Antonio Ferriani, formatos escalados, antes e depois, print de WhatsApp, caixa de perguntas, Reclame Aqui, notícia, ilustração como formato de anúncio.

by-lua/video-editing

Gera narração/voz off em WAV pela API do NinjaVoice (NinjaBR Hub), sem browser e sem login — 82 vozes, português nativo, resposta síncrona. Cobre escolha de voz por nicho e gênero, quebra de texto acima de 2000 caracteres, geração em lote cena a cena, gate de validação do arquivo e mixagem com trilha de fundo no ffmpeg. Use sempre que precisar de narração para criativo de vídeo, voz off, VO, locução, áudio de anúncio, dublar um roteiro, ou quando o usuário mencionar NinjaVoice, TTS, text-to-speech, voz masculina/feminina para o criativo.

by-lua/video-editing

SLASH-COMMAND-ONLY. Invoke ONLY when the user explicitly types the literal `/watch-video` slash command. Never auto-trigger on phrases like "watch this video," "summarize this video," "take notes on this video," or on a bare YouTube URL. For ad-hoc YouTube questions, fetch the transcript directly (YouTube page or yt-dlp) and skim — do not run this heavyweight pipeline.

相關技能