Communitygithub.com

thativanng/reels-maker

在構建任何影片之前進行訪談。它會讀取已提供的資料(來源文字、履歷、連結、品牌檔案),然後以幾輪簡短的編號提問來獲取遺漏的資訊,並標示出建議答案;最終產生一份單頁簡報,分為「你所說」與「我假設」兩部分,以及一個分鏡表,在獲得同意前不構建任何內容。

reels-maker 是什麼?

這個技能(reels-maker)是一個針對影片製作的前期訪談代理。它的核心原則是:在沒有任何構建成品(如畫面、樣式)之前,必須先取得使用者的明確同意。它專注於避免因「假設錯誤」而導致的昂貴返工,例如錯誤的平台比例、不適合的視覺風格或未經確認的創意方向。該技能支援多種影片類型,包括 Reels、影片、解說片、職業影片、動畫等,並適用於 Claude Code、Cursor 等具備代理能力的開發工具。 運作方式:技能首先掃描專案中已有的所有素材(如文字稿、履歷、品牌檔案、過去的視覺風格紀錄),然後以固定的四到五輪提問(每輪一個訊息)逐步收集必要資訊,每個問題都包含一個星號標記的建議答案。使用者可以輸入 `defaults` 一次接受所有建議,或輸入 `just build it` 直接結束訪談。訪談結束後,技能會產生一份單頁簡報,清楚區分「你所說」與「我假設」的內容,以及一個對應的分鏡表。最終,只有在使用者回答「是」之後,才會將控制權轉交給其他視覺與建置引擎(如 reel-style 和 film-engine)。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thativanng/reels-maker/tree/HEAD/skills/reel-intake

在你喜歡的 AI 中提問

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

說明文件

reel-intake:先問再建

工具包存放位置: 此技能的所有指令都應在 reels-maker 資料夾中執行(該資料夾是 github.com/thativanng/reels-maker 的複製,內含 template/ 和 tools/)。如果專案中沒有此資料夾,請先依照該儲存庫的 SETUP.md 進行設定。

規則: 在使用者對簡報及其分鏡表說「是」之前,不建構任何內容(無畫面、無框架)。以程式碼建構影片時,昂貴的錯誤很少來自時間問題,而是來自那些沒人問過的問題。真正的目的常在腳本寫完後才浮現;比例可能選錯平台;視覺風格可能被使用者認為廉價。每一次錯誤都需要重建,而一個問題只花費一行文字。

0 · 先看再問

閱讀所有已取得的資料,絕不詢問已經可以查到的事:

  • 請求本身、任何來源文字、連結、履歷、他們的網站或個人資料
  • 專案中的品牌檔案(顏色、字體、標誌)
  • .reels/looks-log.md(如果存在,記錄了 reel-style 過去使用的視覺風格)

由資料回答的欄位應直接填入,並標註「來自你的履歷」、「來自你的網站」等。猜測不是答案: 猜測應放在簡報的「我假設」部分,讓使用者可以看見並修正。

1 · 如何提問

  • 輪次進行,不是一次表單,也不是零散提問。 一輪 = 一個訊息中的一個區塊。為每個問題編號。用 ★ 標記建議答案,並給出一行理由。
  • 事實性問題提供選項(平台、長度、聲音)。創意性問題提供草稿供編輯,不留空白: 「觀眾應該記住的一件事:★ 『預測是猜測;安全庫存應付意外。』 保留、編輯或替換?」
  • 依賴前面答案的問題 會預先填入衍生值(比例跟隨平台),或等待下一輪。
  • 使用者可輸入的快捷指令: defaults 接受該輪中所有 ★ 標記的答案。just build it 結束訪談:每個未回答的欄位都會變成簡報中的明確決策,並附帶理由。
  • 正常情況四輪,上限五輪。 一旦所有必要欄位都已回答或使用預設值,即停止。

2 · 提問輪次(完整問題庫,包含選項和預設值,位於 references/rounds.md)

第 1 輪 · 目的(必要)

  1. 這個內容是關於什麼的?(僅在未提供來源時提問)
  2. 觀眾應該記住的一件事(為他們草擬;對於模糊的請求,提供 2-3 個草稿)
  3. 誰是唯一的觀眾?(招募人員、客戶、同業、領域外的陌生人)
  4. 那位觀眾看完後應該做什麼?(追蹤、留言、點擊連結、儲存或分享、只需記住)

第 2 輪 · 格式(必要,六項問題,按此順序;平台事實和禁止區域位於 references/platforms.md)

  1. 首先發布在哪個平台?第一個平台是主版本,其餘為裁減版。
  2. Reel 還是影片?僅在平台同時支援兩者時提問(LinkedIn、X、YouTube、Facebook)。
  3. 比例,根據平台預設:Reels、TikTok 和 Shorts 為 9:16;LinkedIn 為 4:5;YouTube 為 16:9。
  4. 版面:★ 讓 reel-style 展示三種選項,或如果使用者已知,直接指定一種(這將綁定所有三種視覺風格)。標明禁止區域,無需詢問。對於自然推廣的 Reels、TikTok 和 Shorts,文字需保留在中間區域(內部慣例,非平台規範):應用程式預設會覆蓋底部四分之一和右側按鈕列。付費 Reel 則需保持底部 35% 淨空(Meta 廣告指南);使用 -ads 平台鍵。
  5. 長度:是硬性上限,還是跟隨內容?同時顯示平台的官方限制。
  6. 聲音:靜音時可用且搭配聲音效果更佳(★ 預設)、聲音主導、純靜音。然後設定旁白、音樂和字幕風格。

第 3 輪 · 素材與故事(視情況提問)

  • 已存在的素材:螢幕截圖、錄影、照片、本人畫面、標誌、資料,或一無所有。缺少的素材應以帶標籤的佔位符表示,絕不憑空捏造。
  • 每個數字:是已測量的、目標值,還是示意值,以及來源為何。絕不虛構數字。
  • 誰來撰寫畫面上的文字?(★ 我草擬,你的編輯為最終版本、你的文字完全照用)使用哪種語言,英式或美式拼法?
  • 單次內容還是系列?(系列會鎖定所有集數的視覺風格;由 reel-style 處理)
  • 求職或職業故事 需加入職業歷程區塊(references/journey.md):每個角色和職位、各個僱主的命名/描述/隱藏方式、同事可能認為牽強的論點。

第 4 輪 · 視覺風格、防護措施與審查(必要)

  1. 他們喜歡的 1-3 個影片,以及 他們覺得什麼看起來廉價。 這是跳過代價最高的問題。
  2. 品牌顏色和字體(先查詢;只在未找到時提問)。
  3. 任何不得出現的元素(數字、姓名、臉孔、標誌),以及必須出現的元素(帳號、結尾卡、免責聲明)。
  4. 封面,即人們在點擊播放前看到的靜態圖(個人檔案網格、LinkedIn 縮圖):★ 鉤子句子,大字,疊在開場畫面上。若未指定,平台會自動選取畫面(據報導 LinkedIn 會選第一幀;未經證實),通常不是最佳選擇。
  5. 他們希望的審查方式:★ 靜態圖片 → 10 秒片段 → 在獨立檢查後完成完整影片 → 手機預覽。

3 · 結束

  1. 衝突檢查。 在撰寫簡報前,檢查所有答案之間是否一致:

    • LinkedIn 使用 9:16 → 建議改為 4:5
    • LinkedIn 使用聲音主導 → 需要內嵌字幕
    • 在 9:16 Reel 的中間區域有長腳本(底部四分之一淨空;付費則 35%)→ 減少字數,而非縮小字型
    • Instagram 上超過 3 分鐘 → 不會推薦給新觀眾
  2. 單頁簡報(範本位於 references/brief.md),儲存為 reels/<short-name>/brief.md:每個 Reel 都有自己的資料夾。分為你所說和我假設(及原因)。包含格式行:平台 → Reel 或影片 → 比例與尺寸 → 版面與禁止區域 → 長度 → 聲音。

  3. 分鏡表: 時間 · 畫面上的文字(完全按顯示方式) · 聲音與字幕 · 此節奏的原因。鉤子需在 3 秒內出現,且每個節奏的持續時間加總應等於總長度。

  4. 請求「是」。 任何修正都需重新朗讀。絕不在與簡報相同的訊息中開始建構。

然後交接:reel-style 選擇視覺風格(3 張靜態圖片),film-engine 以此風格建構,頁面尺寸由簡報的格式決定。

絕不

  • 提問資料已回答的問題。
  • 虛構數字、引用、客戶或結果。
  • 用你的話替換使用者的話。可以校對(語法、流暢度),但不要重寫。
  • 跳過格式輪次,即使平台看似明顯。
  • 在訪談中選擇視覺風格。那是 reel-style 的工作,以靜態圖片呈現,絕不從列表中命名。

致謝

訪談姿態(代理先問後動,且每個問題提供建議答案)來自 Matt Pocock 的 grill-me(mattpocock/skills, MIT)。一次問完的規則(先給建議選項、跳過已回答的問題、陳述 vs 假設、摘要前的衝突檢查)改編自 HyperFrames 的意圖訪談(heygen-com/hyperframes, Apache-2.0)。簡報欄位遵循常見的代理商影片簡報。平台事實於 2026-10-06 對照各平台官方頁面(若可讀取)進行了檢查;無法確認的(如 X)已在 references/platforms.md 中標示為未經證實。

Individual skills in this repo

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

thativanng/reels-maker

The gates every code-rendered film passes before anyone sees it. A 40 fps collision pass (no mover touches a solid or another mover), pixel probes (nothing sits over or behind a face, a head, a subtitle or the frame edge), then an independent auditor (a fresh agent) who reads frame sheets at ≥2 fps and signs off. The builder never signs off their own film. Use it before sending ANY render, after every fix round, and whenever someone says "check the film", "audit this", "is it ready", or "why does this frame look wrong".

thativanng/reels-maker

Build and render a film, reel or animation as code. One HTML page draws any frame on demand with window.seek(t), and a headless browser renders every frame at 2x into an MP4 with sound. Use it whenever someone wants a video made with code rather than a video generator, says "make a film / reel / animated explainer / career video", "render this to MP4", "turn this page into a video", or needs the finishing steps (audio cues, loudness, colour-safe encode, phone preview). It is style-agnostic and renders 9:16, 4:5, 1:1 or 16:9. It runs after reel-intake (the brief) and reel-style (the look), builds on template/starter.html or a style pack such as voxel-walk, and passes film-audit before anything is shown to anyone.

thativanng/reels-maker

Picks the look of a reel or film before it is built. It shows three genuinely different looks as stills of the same opening frame with the same words, so the person judges the look and not the content. It keeps a log of every look ever shown, so no look comes back unless asked for, and it locks one look on purpose for a series. Use it after reel-intake's brief is signed and before any test strip, whenever someone says "what should it look like", "give me options", "make it look different from last time", "it looks cheap", or starts a new reel or a new series.

thativanng/reels-maker

The voxel career-film style. A blocky 3D version of the person walks, without ever vanishing, through one scene per role. Their outfit changes as they walk, each scene rises out of the floor ahead of them, and a dark banner tracks year, company and role. Use it when someone wants their career, a journey or a "how I got here" told as a short 3D film for LinkedIn or a portfolio, says "make my career film", "turn my CV into a video", "voxel film", or wants a new chapter added to an existing one. It runs on film-engine (render, audio, finish) and must pass film-audit before anything is sent.

相關技能