Communitygithub.com

prepro-deck-builder

從一個或多個腳本建立完整的前製簡報(.pptx,可在任何簡報應用程式中開啟)。內建公司格式,無需範本或參考簡報。

prepro-deck-builder 是什麼?

這是一個專門用於自動化前製簡報(pre-production deck)建立的 AI 技能。它接收一個或多個腳本,並輸出可立即使用的 .pptx 檔案,內建固定的格式與章節結構(包含封面、總覽、創意方向、攝影、場景設計、服裝、分鏡圖等),因此無需手動套用範本。支援的平台包括 Claude Code、Cursor、Codex 以及任何能執行 Python 腳本的環境。此技能會自動從客戶提供的品牌書、Logo 或網站抓取品牌色彩,若無則使用安全的中性色系(sky blue)作為佔位符。每個腳本會產生完整章節,場景編號自動排序,並在每次輸出前執行嚴格的審查流程,確保文案符合製作語言、格式正確且無佔位內容。最後提供圖片整合選項(使用者上傳或 AI 提示包),但不強制生成圖片。

相容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/thinkalim/ai-video-preproduction-skills/tree/HEAD/skills/prepro-deck-builder

在你喜歡的 AI 中提問

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

說明文件

前製簡報建置工具

腳本輸入,完整前製簡報輸出。格式固定。文案是技藝。

1. 資訊收集

只問一次,且只問缺少的項目:

  • 腳本。忽略暫存或測試分頁。若分頁不明確則提問。
  • 品牌名稱,與客戶書寫方式完全相同。
  • 交付物及數量(範例:30s 主影片 (x3)、15s 精簡版 (x3))。不可自行發明數量。
  • 拍攝天數與地點(如已知)。哪些腳本共用同一天。
  • 產品清單附 SKU 或產品 ID(如腳本中有提及產品)。
  • 外觀。 預設為客戶自有品牌(見下方)。若尚無任何可參考資料,則提供:
    • sky:天藍色漸層分隔頁,Avenir 字型。在品牌色設定前的中性佔位符。
    • ink:黑色與炭灰色分隔頁,Helvetica 字型。編輯感、高端、科技風。
    • sage:柔和綠色分隔頁,Georgia 字型。平靜、自然、養生與家居風。
    • custom:使用者上傳品牌書、Logo、截圖或網站。選取兩種分隔頁顏色、文字顏色與字型。以十六進位色碼顯示選擇並在建立前確認。若使用者裝置未安裝品牌字型,則指出相近的系統字型並說明。 若使用者未選擇且無可用品牌,則使用 sky。

品牌優先。天藍色僅為暫代方案。 在建立前,尋找客戶的顏色:品牌書、使用者分享的 Logo 或截圖,或品牌網站。選取兩種分隔頁顏色、文字顏色與字型,以十六進位色碼顯示並確認。僅在完全無品牌可供擷取時才使用天藍色,並在交接時說明此為佔位符,需替換為品牌色。在規格中將天藍色寫為 "theme": {"base": "gold", "a": "56B4E9", "b": "1F7DC4"}。絕不使用黃金色調。

2. 簡報結構

封面                  品牌名稱,使用品牌色
總覽                  活動內容、目標受眾,接著列出交付物
創意方向              洞察觀點、每支廣告如何拉出一條線索、每支廣告的落點
攝影風格              共用設定,僅當所有廣告共用同一攝影手法時
-- 每個腳本 --
分隔頁                廣告名稱;可選副標題(主題標語或「Day 1」)
攝影風格              此廣告專屬,除非共用
場景                  地點選擇的佔位區
場景設計              此廣告專屬
選角                  選角選擇的佔位區
服裝設計              此廣告專屬
分鏡圖                每張投影片 3 格
--
感謝頁

場景依腳本編號:腳本 1 = 101, 102... 腳本 2 = 201... 絕不打破腳本順序。 共用拍攝日的腳本可共用一個攝影風格、場景設計與服裝設計章節。在分隔頁上說明(「腳本 1 與 3 / Day 1」)。

3. 撰寫每張投影片

語氣:導演寫給劇組的指示。簡潔、經過深思的段落,每段兩到四個完整句子,使用製作語言:鏡頭、涵蓋範圍、光線、走位、質感、場景佈置、節奏。每個段落告訴劇組他們可以拍攝、搭建或購買的內容,以及為什麼這對故事重要。句子之間要連貫並層層推進。絕不堆砌片段或寫出像標語的句子。無填充詞、無破折號、無「提升」、「無縫銜接」、「沉浸式」。

總覽(80 至 120 字,在交付物之前)。一段簡短段落說明活動內容及其所處的世界,第二段說明目標受眾及其應被引導的行動。接著是交付物區塊,每種格式一行。

創意方向(100 至 150 字)。以完整的想法開頭,而非口號。接著每支廣告用一兩句說明它拉出的線索及在螢幕上的呈現方式。以所有廣告的落點作結(結束卡、URL、標語)。

攝影風格(3 個短段落,每段 40 至 55 字)。攝影機如何移動及其原因。鏡頭尺寸及何時使用廣角。插敘鏡頭必須呈現的內容及其可讀性。光線。將動態與情感連結:何時移動、何時靜止。

場景設計。 固定格式:

  • 標題行:大寫的 廣告名稱 · 簡短標語。
  • 兩句氛圍描述:空間應有的感覺及其原因。
  • 場景設定:每個場景一或兩句。生活化的細節(門邊的鞋子、冰箱上的畫)。
  • 色調搭配:3 或 4 種顏色,加上品牌色出現在小而真實的位置。
  • 必要道具:分組,2 至 4 行。主力產品優先,附顏色款式與 SKU。 長清單放在備註中,而非投影片上。

服裝設計。 固定格式:

  • 兩句該地點或廣告的氛圍。
  • 每個角色一行:姓名(性別,年齡):穿著,以及一個講述故事的細節。 兒童需確切年齡。成人給區間(30 多歲、25 歲左右)。
  • 色調搭配: 一行。
  • 無 Logo,除非是客戶的。

分鏡圖。 每格包含:

  • 視覺:場景變換時的場標(內景 廚房 - 白天)。首次出現的角色姓名以大寫書寫並標註年齡。接著 2 至 3 句完整的方向指示:動作、構圖及任何攝影機移動。對螢幕與產品特寫使用 插敘:,對硬切使用 切至:,對必須取得的鏡頭使用 備註:。標明產品及其 SKU。
  • 旁白/文字:旁白: 行(腳本逐字)。文字: 用於螢幕上的文案。音效: 和 音樂: 用於腳本中有要求時。備選: 用於備用台詞。
  • 最後一格為結束卡。在此之後可新增產品系列或顏色款式鏡頭作為額外場景。
  • 保留腳本中的旁白與品牌名稱完全一致。標出矛盾之處。絕不默默修正。

4. 空間限制

方框不會自動縮小。刪減文字,而非字型大小。

  • 場景設計:標題、氛圍、2 個短區塊、2 至 4 行道具。
  • 服裝設計:氛圍、每個角色一行、色調搭配。
  • 攝影風格:3 個段落,每段約 40 至 55 字。
  • 分鏡視覺:約 45 至 55 字。旁白與文字:約 25 字。

5. 法律標記

在建立前,檢查腳本中是否有統計數據、最高級用語、價格、優惠、健康或金錢相關主張、推薦見證及第三方品牌。保留原有台詞,加上 備選: 更安全的版本,並在交接時列出每個標記。必要的免責聲明需在 文字: 中加上星號。這僅為初步檢查,不構成法律建議。

6. 建立

先撰寫一個 JSON 規格,然後執行:

python scripts/build_deck.py spec.json outputs/<Brand>_PrePro_v1.pptx

規格格式:

{
  "brand": "品牌名稱",
  "theme": {"base": "gold", "a": "56B4E9", "b": "1F7DC4"},
  "cover_sub": "選填",
  "overview": ["行", "", "交付物:", "30s 主影片 (x1)"],
  "creative_approach": ["行", "", "行"],
  "shared_cinematography": ["選填;省略則為每支廣告獨立撰寫"],
  "scripts": [{
    "title": "廣告名稱", "subtitle": "選填", "base": 101,
    "cinematography": ["行"],
    "production_design": ["廣告  ·  標語", "氛圍", "", "場景設定", "行", "", "色調搭配", "行", "", "必要道具", "行"],
    "wardrobe": ["氛圍", "", "姓名(性別,年齡):行", "", "色調搭配:行"],
    "location_placeholder": true, "casting_placeholder": true,
    "frames": [{"vis": "內景 房間 - 白天\n動作。", "vo": "旁白:行", "title": "螢幕文字"}]
  }]
}

theme 為品牌顏色的字典,如上所示在未設定品牌時使用天藍色,或使用 ink 或 sage。它設定分隔頁漸層顏色(a、b)、主體文字(ink)、標籤(grey)、佔位符(ph)、分隔頁標題顏色(title)及 font。任何遺漏的鍵值會回退至基礎樣式。

完整範例請見 references/example_spec.json。

"" 表示空白行。章節標題(交付物:、場景設定、色調搭配、必要道具)及大寫標題行會自動加粗。在服裝設計中,第一個冒號前的文字會加粗。

7. 圖片(最後一步,僅在簡報獲核准後)

在使用者簽核簡報前,不要提出圖片。然後提供兩條路徑,以一行呈現:

A. 使用者提供的圖片。 使用者上傳分鏡圖、勘景照片、頭像或產品照。為每張圖片命名或對應到一個鍵值,放入同一個資料夾,然後重新建立: python scripts/build_deck.py spec.json out.pptx --images <資料夾> 圖片會裁切以填滿每個格子。空格子保留為佔位符。

B. AI 提示包。 執行 python scripts/make_prompts.py spec.json <Brand>_Image_Prompts.md。 先在規格中寫入 image_style:一行關於外觀、光線、色調搭配與長寬比的描述,取自攝影風格與場景設計文案。交付該檔案。使用者將提示貼入任何圖片工具,以鍵值為檔案名稱儲存每張圖片,上傳,然後您使用 --images 重新建立。

圖片鍵值:

  • 分鏡圖格:場景編號(101、102、201)。
  • 內容投影片:<腳本鍵值>-design-1、-design-2、-wardrobe-1、-wardrobe-2、-cine-1、-cine-2。
  • 場景與選角:-location-1 至 -3、-casting-1 至 -3。
  • 腳本鍵值預設為 s1、s2... 依腳本順序。在腳本上設定 "key" 可覆寫。

絕不生成真實、有名有姓的人物或商標角色的圖片。選角格用於使用者自己的演員照片。

審查流程(每次提交前,一律執行)

每個答案執行兩次。使用者絕不會看到第一個草稿。

  1. 草稿完整答案。
  2. 審查,以嚴格的創意總監與製片人角度,根據以下檢查清單及此技能中的所有規則進行。將文案當作在客戶會議中聽到般朗讀。標出每個缺失。
  3. 修正每個缺失,然後僅呈現修正後的版本。
  4. 以一行結束:審查流程:<變更內容>,或 審查流程:無需變更。

這適用於每個產出步驟:研究、選項、文案、規格與檔案。對於檔案,建立、開啟或預覽、檢查,然後修正並重新建立,之後再交接。

檢查清單

  • 簡報使用客戶的品牌色,或天藍色並在交接時說明為佔位符。絕不使用黃色。
  • 每個腳本都有完整章節。場景編號依序。旁白和品牌名稱與腳本完全一致。
  • 文案讀起來像是深思熟慮的段落,使用製作語言。無標語式片段。
  • 預覽簡報並查看每張投影片。無內容跑出方框。無佔位文字。
  • 法律標記已列出。無使用者未提供的名稱。無破折號。

8. 檢查,然後交接

  • 每個腳本都有完整章節。場景編號依序。無內容跑出投影片(如有 soffice 和 pdftoppm 則可用於預覽)。
  • 無佔位文字、無使用者未提供的名稱、無破折號。
  • 以 3 行交接:投影片數量、腳本與分鏡投影片,接著是法律標記與未解決問題。
  • 圖片、選角與場景選擇由人工手動放入。請說明。
  • 未經詢問,不得加入工作人員、演員或聯絡人姓名。

Individual skills in this repo

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

相關技能