kingsizestrj/SKILLS

使用 Voltec AI 及品牌角色製作的真實影片（ElevenLabs + HyperFrames）

製作和編輯任何由品牌角色主演的 Voltec AI 真實影片（Reels、Stories 或 9:16 廣告，適用於任何活動、季節、主題或場景）：AI 角色在真實地點 → 批准快照 → Veo 3.1 圖像轉影片 → 克隆語音旁白 → HyperFrames 編輯，包含字幕、CTA 和 QR 碼。以下是流程、規則、Voltec 固定元素以及每個影片會變化的插槽。JSON 主體、完整提示和長命令位於 references/。

已測試的參考案例： Reels "Verão Conectado"（2026 年 10 月 15 日；20.5 秒，1080x1920，24 fps；v5 交付）。它的值顯示為 "例：Verão Conectado"，且絕非預設值：屬於活動的是插槽（§1b），而填入的範例則在 §7.2。

• [Voltec] 標記為 Voltec 品牌角色或服務區域（Grussaí 及周邊地區）的固定元素。"例：Verão Conectado" 僅標記參考活動的值。其餘適用於任何 AI 廣告。
• 證據等級，與參考文檔相同：[vivido] 在會話中發生並已確認；[aplicado] 來自研究或評論，並已納入已批准的片段；[pesquisa] 僅來自研究；[não testado] 源自規則，未經任何生成（§8）。
• $SKILL = 此 SKILL.md 的資料夾；$PROJ = 影片專案的資料夾。Shell 變數不會從一個 Bash 呼叫傳遞到另一個：在每次呼叫中重複第 5 節的序言。
• 生成提示使用英文。給客戶的文字、旁白和字幕使用葡萄牙文。
• API 金鑰位於 ~/.config/elevenlabs/env（chmod 600），scripts/el.py 會讀取它而不列印。切勿對其使用 echo、cat、env、curl -v 或 set -x，也不要將其寫入檔案、提示或訊息中。
• 您無法聽到音訊：使用 STT（文字和 audio_event）、片段頻譜圖和 ebur128 進行檢查，並在閘道頁面上列出讓客戶聆聽的時間點。

1. 使用時機

• [Voltec] 任何由 品牌角色 主演的 Voltec 真實 AI 影片，需要看起來像是被人真實拍攝的：Reels、Stories 或廣告；任何活動、季節或主題（季節性促銷、機構形象、Wi-Fi 提示、技術支援、開幕、黑色星期五）；服務區域內的現實場景（Grussaí、Atafona、Chapéu do Sol、São João da Barra；作為場景的內容：§7.1）或內部場景（房屋、商店、汽車）。從未生成過的場景、服裝或格式：§8。
• 透過 ElevenLabs API 生成：圖像（快照）、影片（Veo 3.1；Seedance 僅在 API 批准後使用，或手動在應用程式中使用）、克隆語音旁白、SFX 和 STT。
• 在 HyperFrames 中編輯：逐畫格剪輯、混音、卡片、同步字幕、CTA 和 QR 碼。
• 調整已交付的 AI 影片：剪輯片段、更換變體、更換一句話或 CTA、製作附字幕版本、調整角色設定。
• 她對著鏡頭說話（"她說話"、"她講話"、"她解釋"）：說話模式，在 references/modo-falando.md 中。Veo 3.1 生成包含對話的片段，而 sts.py 將語音替換為 Radassa。[vivido：2026 年 10 月 15 日批准的 13 秒測試]
• [GERAL] 其他品牌或角色：非 [Voltec] 的內容，經過調整後適用（替換 §7.1 並填入 §1b 的插槽）。參考專案：/home/syllas/hyperframes/voltec-reels-ia/（Verão Conectado；僅供讀取）。
• 不適用於沒有人物或生成場景的動態圖形（那樣只需 HyperFrames），也不適用於不涉及影片的 Voltec 主題（網路、GenieACS、TR-069）。

品質標準（Voltec 要求；用作所有專案的標準）：最大真實感；可信的攝影機，就像有人真的在拍攝；真實的環境，沒有突然的變化；手中物體無異常；使用已授權照片（或客戶自己的）展示的真實地點；在任何影片之前必須有批准的快照；詳細的提示（動作、皮膚、帶真實噪音的音訊捕獲）；生成前研究最佳實踐。

1b. 快速開始：任何新的 Voltec 品牌角色影片

1. 依序閱讀： 此 SKILL.md（含 §7）→ persona-e-marca-voltec.md §1–4 和 §6–7 → 場景：在 Grussaí，locais-grussai.md §1、§3（含 "Outras estações" 表格）和 §4；在其他地方或室內場景，此文件的 §8、persona-e-marca-voltec.md §10 和 locais-grussai.md §7–§10 → prompts-principios.md §1（含 "Checklist do prompt"）→ 僅 prompts-moldes.md §2 中最接近場景的模板（2.1 朋友拍攝、2.2 在同一位置擺姿勢、2.3 自拍、2.5–2.6 影片；新場景：2.9–2.10）。其餘內容，僅在需要時閱讀。prompts-moldes.md 和 persona-e-marca-voltec.md 超出一次 Read 讀取的限制：使用 Grep 找到章節（例如：^### 2\.9、^## 10）並使用 offset/limit 讀取。
2. 已決定的事項（Voltec 固定元素；不要再問）： 帳戶中的角色，包含資產 na7keiYvPpGArmyghOpk、pUgU1HXgmdqXfP02iR8T 和 ZY1iDcJLhPFklahPnvkM（不要重新上傳；角色 §4）以及臉部、皮膚和手部錨點（角色 §3.1–3.3）；語音 "Radassa 100%" 4yvYc2GSakxLWMhlsd6b，eleven_v4，0.45/0.85，"pt"，現在 A/B 測試是在該語音的 2 個種子之間進行；發音 vol-TÉC（TTS 中為 "Voltéc"，螢幕上為 "Voltec"）；無珠寶或刺青；無音樂；標誌、顏色、字體和城市（§7.1）；真實感、提示和品質保證的規則（§3、qa-checklist.md）以及閘道（§2）。模型：透過 API 的 Veo 3.1，於 2026 年 10 月 15 日選擇；僅當免費存取測試（modelos-e-custos.md §2.2）或 Fase 1 的目錄審查改變情況時，才重新提出問題。
3. 影片的插槽： 在編寫旁白之前（僅在聊天中）務必詢問。填入的範例在 §7.2。
   • 來自客戶（切勿虛構）： 主題和格式（Reels、Stories、廣告）；畫外音旁白（預設）或她對著鏡頭說話（references/modo-falando.md），在這種情況下是每個片段的對話；優惠、價格、條件和期間；付費廣告（"Saiba mais" 按鈕 + QR 碼）或有機貼文（"link na bio"）；QR 碼的目標（page_id=674 是 "Verão Conectado 2026" 頁面：未經客戶確認不要重用）；CC BY 照片的版權標註是否要放在貼文說明中。
   • 詢問並建議（客戶在閘道 1 或 2 批准）： 場景、時間和光線；持續時間；片段腳本（每個片段：地點、手中物體和環境音效）；服裝；鉤子；活動卡片；SFX 背景音的文字。
4. 根據場景、季節或情境重新設計（這些都不複製範例）：角色風格中的服裝錨點（角色 §3.4）（不透明、無圖案或標誌；平紋或大紋理布料，因為細紋理會閃爍）；根據地點、日期和時間計算的陽光光線（locais-grussai.md §8；在 Grussaí，§3 的 "Outras estações" 表格：冬季，下午 3:40 左右太陽高度約 19.5°，午後陽光方向約 293–304°；在逆光自拍中，她朝南走，海洋在右邊）；風（僅研究過夏季的風：在生成前研究）；地點的環境音效（在影片提示和 SFX 背景音中）；negative_prompt 中的地點片段（prompts-moldes.md §2.6）；快照中為鉤子預留的空白空間，位於畫面中的平滑區域（模板的 #q1 位於右上角；例如 Verão Conectado：T1 中的開闊天空）；模板中 __…__ 標記內的活動文字：鉤子、分 1 或 2 部分的卡片標題（可選圖示；例如 "VERÃO ☀ CONECTADO"，帶太陽圖示）和優惠；SFX 背景音的文字。
5. 新專案和頁面： $HOME/hyperframes/<campanha> 和一個新的 Artifact。不要重新發佈到 Verão Conectado 的 URL（§7.2）。

2. 分階段流程和閘道

每個閘道都是一個頁面（Artifact），帶有並排的 A/B 比較和編號的問題。要求以 "T1-A、T2-A、T3-A、voz A、modelo 1" 格式簡短回答；這加速了決策。

• 頁面： 每個專案一個頁面，每個閘道重新發佈（相同檔案，相同 URL），當前閘道在頂部，已做的決定在底部；新活動 = 新頁面。媒體作為支援檔案放在 media/：快照為 JPG（會話中約 200 KB 每個）、旁白為 MP3、影片預覽為帶 JPG 海報的 MP4（會話中約 11 MB；每個檔案限制 15 MB）。模型頁面結構（例如：Verão Conectado 的頁面）：閱讀 https://claude.ai/artifact/MivTjGgrZ9ZyhZTftP66kh（Artifact，`action: "read"`）。每個片段：A/B、攝影機、動作、捕獲的音效、旁白、螢幕文字和時間。之後：帶時間表的旁白 A/B、模型路徑、帶版權標註的地點，以及一個包含回复格式的框。
• 記錄： 將每個閘道的回复記錄在 $PROJ/DECISOES.md 和頁面的 "Decisões" 部分。
• 合併閘道： 當優惠、CTA（付費 vs 有機）和 QR 碼目標都已回復時，將閘道 1、2 和 3 合併到一個頁面中。在此之前，先執行閘道 1（僅在聊天中），並且不要生成快照或旁白。在獲得回复之前，在分鏡腳本中顯示的旁白是臨時的：在獲得回复之後（發音、CTA、優惠），使用選擇的語音（2 個種子，每個約 300 點）生成最終旁白，在影片之前。例如 Verão Conectado：分鏡腳本中的 narracao_radassa100，以及回復後的 narracao_v2_A_s1。
• 永不合併： 在閘道 3 獲得批准之前，不要製作影片。

Fase 1. 研究與計劃（0 點）

• 並行研究（4 條線：模型、真實感/抗幻覺、地點和 API；如果有子代理，並行進行）。然後以分鏡腳本格式編寫腳本和片段計劃：每個片段、地點和時間、誰拍攝和攝影機、2-3 個階段的動作、物體、捕獲的音效、旁白句子、螢幕文字和時間。
• 在花費之前執行 2 次獨立審查：每個重點一個子代理；沒有子代理，則每個重點單獨過一遍。技術 = API 的限制和字段（api-elevenlabs.md §3.3）、持續時間/1080p、成本和審查（prompts-principios.md §4）。真實感 = prompts-principios.md §1 中的 "Checklist do prompt" + 光線和幾何形狀（在 locais-grussai.md §8 中計算的陽光；室內或夜間場景：此文件的 §8）。每個審查返回問題、片段、嚴重性和修正。
• 排名變化很快：如果 modelos-e-custos.md 超過約 2 個月，請重新查詢。從 2026 年 11 月 17 日起，檢查 veo-3.1-generate-001 是否仍然存在。在不花費的情況下測試每個模型的存取（同一文件的 §2.2）。
• 已服務過的客戶： 參考資料即為研究。僅重做上述項目和活動中的新內容：季節（未研究過非夏季的風）、範例之外或沒有開放照片的場景（向客戶索取照片，locais-grussai.md §7；未研究的內容在此文件的 §8 和 locais-grussai.md §10 中）、服裝和手中物體（角色 §3.4）。在花費之前保持 2 次審查。
• 閘道 1，客戶收到： 推薦模型，附帶日期評分和預計成本；腳本，包含編寫好的旁白；編號的問題：付費廣告或有機貼文的 CTA、QR 碼目標、品牌發音、優惠和價格（來自客戶；切勿虛構）、角色和參考資料（如果任何參考資料中有其他面孔則警告）、語音和同意、音樂（預設：無）、持續時間、刺青和珠寶、"Informações de IA" 標籤、照片版權標註。[Voltec] 僅詢問第 1b 節要求的內容。

Fase 2. 真實地點（0 點）

• 照片，需在照片頁面上閱讀許可證並證明地點（地理標籤、OpenStreetMap）：方法在 locais-grussai.md §7。為場景時間計算陽光（locais-grussai.md §8）並檢查該地點的風。僅 CC0 和 CC BY 可送入 API；NC 照片僅作為編寫提示的參考。室內場景（房屋、商店、汽車）：客戶自己的照片，無可見的標誌或標牌（§8）。
• 閘道 2，客戶收到： 聯絡表（綠色 = 可送入 API；紅色 = NC）、版權標註、提議的單一場景（一個地點和一個時間；例如 Verão Conectado：陽台和前面的沙灘，在一個夏日下午）以及光線時間。

Fase 3. 快照與旁白（強制閘道）

• 快照 = 每個片段的第一個畫格，使用 gpt-image-2.5-sunburst（9:16、2K、high），每個片段有 2 個變體。使用 qa-checklist.md §A 審查所有內容。
• 首先生成 T1 A/B。您根據 qa-checklist.md §A 選擇最佳的一個，並將其作為基礎：在同一個地點的下一個片段是其編輯版本，攝影機在同一點；新地點是新的圖像，並以它作為 Image 1（例如 Verão Conectado：T2 和 T3 來自於分鏡腳本之前的 T1-A 5vBTv3B9FOt44Vu8jMY4）。在閘道 3 中，說明哪些片段衍生自 T1-X。如果客戶選擇另一個 T1，則重新從該 T1 生成衍生片段（每個片段 2 張圖像；例如 Verão Conectado：T2 和 T3，4 張圖像，約 2,200 點），然後再進行任何影片。
• 在一個請求中完成整個旁白，使用 2 個語音或 2 個種子。由 alignment 測量的持續時間定義剪輯點。檢查品牌重音和說的文字（stress.py + STT）。
• 閘道 3，客戶收到： 每個片段的 A/B 並排顯示，附帶面部參考、旁白 A/B 播放器、地點照片，以及模型問題。在回復之前暫停，並保存已批准的 generation_id。

Fase 4. 影片，每個片段 2 個變體

• Veo 3.1，start_frame = 已批准快照的 generation_id，9:16，1080p，8 秒，含音訊，種子 20260115 和 20260116。提示僅描述動作、攝影機和音效（prompts-moldes.md §2.5–2.6）。角色不說話，除非在說話模式中（references/modo-falando.md §4）。
• 每次生成 19,391 點，每個片段 2 次（例如 Verão Conectado，3 個片段 × 2 個變體 = 116,346）。在會話中，6 次並行生成約 3 分鐘完成（變化）。客戶在此階段不會收到任何內容。

Fase 5. 每個變體的選擇與品質保證（內部閘道）

• 2 fps 的聯絡表，24 fps 的編號條帶（嘴巴）和 8 fps 的編號條帶（手和物體），以及原生音訊的 STT（qa-checklist.md §B）。記錄每個缺陷的畫格（Veo 片段 = 192 畫格；畫格 = 秒 × 24），並選擇避開它的 in/out 點。如果變體 A 沒有乾淨的視窗，請使用變體 B。如果兩個都失敗，則更改一個變數重新生成。
• 超出 2 個變體重新生成：在閘道 1 批准的 1 輪儲備內；超過此數，請取得批准，說明原因和成本（每個片段 19,391 點）。
• 只有在有真正疑問時，客戶才會在這裡收到東西：頁面上循環播放的 2 個變體。

Fase 6. 編輯（0 點，除了背景音…

…[已截斷以進行翻譯]