Communitygithub.com

reel-tela-viva

將主題轉化為 9:16 的教學化動畫 Reel,模擬「螢幕錄製解說」風格,包含進度條、操作中的通用視窗、逐字逐句字幕,並套用您的品牌色和 @ 用戶名。

reel-tela-viva 是什麼?

這是一款專為 AI 代理設計的技能,用於自動生成「Tela Viva」風格的垂直 Reel (1080×1920, 30 fps, MP4) 教學影片。此技能以 Python + ffmpeg 程式碼驅動,而非 AI 影片生成器,在 1 分鐘內即可產出 40 秒的成品。工作流程分為五大步驟:理解需求(主題、品牌色、@用戶名),編寫腳本(JSON 格式、5-8 場景),產出預覽畫面讓使用者確認,最終生成影片與旁白指南,並有選項可同步使用者提供的音頻。支援可選的「Modo 8-Bit」與「Hora Dourada」技能,此為三者之一。此技能專為 Claude Code、Cursor 或 Codex 等開發者工具最佳化,特別適合教導程式操作、工具使用或逐步解說。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/adnytamires/skills-reels-video/tree/HEAD/reel-tela-viva

在你喜歡的 AI 中提問

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

說明文件

Tela Viva:動畫教學 Reel

三種風格套件: 若使用者要求一支 Reel 但未指定風格,且同時具備「Modo 8-Bit」(像素藝術)與「Hora Dourada」(扁平角色插畫用於故事與教學)技能,請先詢問使用者偏好哪一種風格。

此技能能將一個主題轉化為垂直 Reel(1080×1920、30 fps、MP4),呈現 螢幕教學 風格:

  • 頂部:進度條與步驟編號,旁邊搭配一個簡短標題;
  • 中央:無品牌的通用視窗,展示「正在操作」的效果(文字輸入中、回應出現、螢光筆畫重點、遮蓋敏感資料的黑色條);
  • 底部:逐字逐句字幕,被唸到的單字會變成品牌色;
  • 結尾:「追蹤我」的卡片。

影片由程式碼(Python + ffmpeg)組合而成,不使用 AI 影片產生器。一支 40 秒的 Reel 可在 1 分鐘內完成。

請一律以使用者的語言回應(通常為葡萄牙文)。

步驟 1. 理解需求(僅需一個問題,補齊所有缺少的資訊)

請一次詢問使用者尚未提供的所有資訊:

  1. 主題: 觀眾將學習或測試什麼?如果使用者已提供旁白文字,請直接採用。
  2. 品牌: 主要顏色的十六進位碼(例如 #7C3AED)與個人檔案 @。若未提供,預設為紫色 #7C3AED 與 @seuperfil,並告知使用者。

如果使用者說「照你的方式做」,請不要提問:直接使用預設值並告知使用者使用了哪些預設值。

步驟 2. 編寫腳本

建立一個 roteiro.json 檔案(格式如下;範本已經準備在 exemplos/roteiro-exemplo.json 中)。

可行的結構(5 至 8 個場景,30 至 60 秒):

  1. 鉤子(標籤 !):一個觀眾能識別的情境,旁白最多 10 個字。
  2. 編號步驟(標籤 1、2、3...):每個場景一個動作,視窗展示該動作。
  3. 注意(可以是其中一個步驟):檢查結果,不要貼上敏感資料。
  4. 行動呼籲(標籤 ✓):例如「提示詞在字幕中」搭配便利貼(nota)。
  5. 結尾("tipo": "final"):「追蹤我看更多...」。

內容規則:

  • 標題最多 6 個字。用 *星號* 強調 1 到 2 個字。
  • 旁白:平均每秒約 2.3 個字。每個場景的長度由旁白決定。
  • 使用虛構的資料、姓名與公司(「人物 A」、「供應商」),並在包含資料的場景中標記 "exemplo": true。
  • 請勿放置真實工具的名稱、標誌或畫面。視窗均為通用型(「AI 助理」、「試算表」、「收件匣」)。
  • 請勿編造功能、公式、數字或結果。如果腳本中提及某工具的功能,請查閱官方來源(若可能,請搜尋網路)並告知使用者您查閱了什麼。若無法查閱,請告知。
  • 請勿誇大宣傳(例如「省下 10 小時」、「再也無法」)。

步驟 3. 產出預覽畫面

透過指定每個場景中間的時間點來執行預覽(時間點會顯示在輸出的開頭):

python3 <技能資料夾>/scripts/reel.py roteiro.json --out saida --preview 3,10,18,25,32

開啟 saida/previa_grade.jpg 並檢查:

  • 沒有任何文字超出視窗;
  • 沒有任何標題超過 2 行;
  • 螢光筆與黑色遮蓋條位於正確位置。

如有需要,請調整 JSON 並重複執行。接著,將預覽畫面與腳本以表格形式(場景、顯示內容、旁白、時間)呈現給使用者,並詢問是否可以生成影片。

步驟 4. 生成影片

python3 <技能資料夾>/scripts/reel.py roteiro.json --out saida --nome meu-reel

此命令會生成:

  • saida/meu-reel-sem-voz.mp4,並內含一段平靜的背景音樂與打字音效(由腳本自行產生,無第三方音樂);
  • saida/guia-narracao.txt,僅包含口說文字,每個場景一個段落;
  • saida/tempos.txt,包含每個場景的開始與結束時間。

使用 --sem-musica 則可生成不含背景音樂的影片。

提供給使用者:

  • 影片檔案;
  • 旁白指南與時間點;
  • 貼文說明(鉤子、步驟說明、完整提示詞(若有)、「此為示意範例。」以及 3 至 5 個主題標籤)。

在傳送前,請先檢視最終 MP4 中的 4 到 5 個畫面(可使用 ffmpeg 抽取)。

步驟 5. 聲音(當使用者提供音頻時)

使用者根據指南錄製旁白(可直接用手機錄製,或依其偏好使用 AI 語音)。當他們提供音檔時:

python3 <技能資料夾>/scripts/reel.py roteiro.json --out saida --nome meu-reel --audio /路徑/到/voz.m4a
  • 若無時間標記,腳本會根據每個場景的字數比例,自動將場景分散到音檔的總長度中。
  • 若要精確同步,請在 JSON 中加入 "marcas_audio": [0, 7.8, 15.2, ...],指定錄音中每個場景開始的秒數。使用者可以提供這些時間點,或者如果您有按字分時間的轉錄工具,也可以聽取音檔來決定。
  • 結果為 saida/meu-reel-com-voz.mp4,背景音樂會降低音量以襯托人聲。

另一種方式是:使用者可以在影片編輯器(例如 CapCut、InShot、Instagram 編輯器)中自行將人聲加入無聲影片。

交付提醒: 如果使用了 AI 生成的聲音、圖片或影片,使用者發佈時應標記為 AI 生成內容。

roteiro.json 格式

{
  "marca": {"cor": "#7C3AED", "arroba": "@seuperfil", "bio": "簡短的個人檔案描述"},
  "palavras_por_segundo": 2.3,
  "cenas": [
    {"selo": "!", "titulo": "收件匣 *爆炸了?*", "narracao": "...", "exemplo": false,
     "duracao": 6.5,
     "janela": {"tipo": "lista", "...": "..."},
     "nota": {"texto": "提示詞在下方 ↓", "sub": "儲存", "em": 0.4},
     "pilula": {"texto": "可以關閉", "em": 0.3, "y": 0.4}}
  ]
}
  • duracao 為選填:若無提供,場景長度將由旁白決定。
  • 結尾卡片會顯示 @ 的第一個字母。除非使用者要求,否則請勿放置吉祥物。
  • nota(便利貼)與 pilula(浮動標籤)為選填。em 的值為該場景中出現的時間比例(0 到 1)。
  • 顏色會自動調暗,以確保文字在白色背景上易於閱讀。

視窗文字中的標記: [[文字片段]] 會在場景中變成螢光筆標記;{{文字片段}} 則會變成一個黑色遮蓋條覆蓋該文字(敏感資料)。

tipo用途欄位
lista收件匣、任務清單、檔案titulo、itens([寄件人、主旨、預覽])、nao_lidas(索引)、destaque(索引)、tremer、destaque_em
texto對話、註記、文件titulo、resumo({titulo、linhas})、resumo_animado、mensagens([{autor、texto}])、marcar_em、tarjar_em、etiquetas(帶 ✓ 的藥丸標籤)、etiquetas_em
chatAI 助理(深色視窗)titulo、prompt(正在輸入)、resposta(可選的行陣列)、caracteres_por_segundo
escrever回覆電子郵件或訊息titulo、texto(正在輸入)、botao
planilha簡單表格titulo、colunas、linhas、coluna_destaque、formula(可選:僅限已驗證的公式)、revelar_ultima
cartao重點新聞、規則或摘要selo、titulo(接受 *強調*)、texto、fonte(資訊來源)
final「追蹤我」卡片bio、botao、clique_em

常見問題

  • 「找不到 ffmpeg」: 腳本會嘗試透過 pip 自動安裝 imageio-ffmpeg。若失敗,請執行 pip install imageio-ffmpeg(必要時加上 --break-system-packages)。
  • 文字被切斷或超出視窗: 請縮短文字、拆成兩則訊息或減少清單項目(約可容納 5 行)。
  • 字幕太快: 請增加場景的 duracao 或減少旁白字數。
  • 字型: Inter 與 JetBrains Mono(SIL Open Font 授權,字型檔案位於 assets/fonts)。

Individual skills in this repo

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

相關技能