Omni-Design Studio（三步驟決定性設計與促銷影片整合技能）

Omni-Design Studio（三步驟決定性設計＆促銷影片整合技能）

🎯 設計理念（為什麼低階模型也能產出專業品質？） 將複雜的判斷（色彩提取、標語合成、不對稱編輯排版、300 DPI PDF/SVG 展開圖、24fps 動畫緩動與語音合成）全部封裝在 build_omni_design.py 這一個決定性 Python 管線（Formula-First） 中。 AI 代理（無論高低階模型）只需依序執行下列 「三步驟（①準備 ➔ ②生成三張照片 ➔ ③一併建構）」，即可穩定產出人類設計師水準的成果。

---

🗺️ 整體架構圖（三步驟・狀態機）

flowchart TD
    Start(["👤 使用者請求"]) --> Check{"概念・參考圖片<br>是否有指定？"}

    %% Step 1
    Check -- "未指定（模糊請求）" --> Ask["【Step 1A】提出5個核心問題<br>build_omni_design.py --ask-concept"]
    Ask --> UserAns["使用者回答 / 填寫問卷"]
    Check -- "有指定 / 已回答" --> PromptGen["【Step 1B】DNA提取 ＆ 輸出3組照片提示詞<br>build_omni_design.py --print-image-prompts<br>(--ref-image / --ref-url / --concept-sheet)"]
    UserAns --> PromptGen

    %% Step 2
    PromptGen --> Harness{"執行環境（Harness）是？"}
    Harness -- "Codex (Primary)" --> CodexImg["【Step 2A】使用 Codex 內建 image_gen 工具 × 3次<br>(gpt-image-2.5-sunburst / 訂閱制零費用)<br>自動儲存至 ~/.codex/generated_images/"]
    Harness -- "Antigravity" --> AgyImg["【Step 2B】使用 image-generator 子代理 × 3張<br>(Imagen 4 Ultra / 訂閱制零費用)"]
    Harness -- "有/無自備照片" --> DirectBuild

    %% Step 3
    CodexImg --> DirectBuild["【Step 3】一鍵全媒體建構<br>build_omni_design.py --auto-codex-images --with-promo-video"]
    AgyImg --> DirectBuild

    DirectBuild --> Out(["📦 可自由編輯的完整套件 (零費用)<br>① website.html / poster.html / packaging_mockup.html<br>（內建 WordPress 風格視覺區塊與畫布編輯器）<br>② website_preview.png / poster_300dpi.png / poster_print.pdf / packaging_3d_mockup.png / packaging_dieline.svg<br>③ promo_video_vertical_9x16.mp4 / landscape_16x9.mp4<br>④ promo_video_studio_9x16.html / 16x9.html（瀏覽器字幕與時間軸編輯工作室）<br>⑤ promo_captions.srt / .vtt（Premiere・CapCut 專用字幕）＆ promo_audio_track.wav"])

---

⚡ 低階模型也絕不迷惘的「三步驟執行規則」

腳本路徑固定只有以下一個（其他子腳本會自動內部呼叫）： SCRIPT="$HOME/.codex/skills/omni-design-studio/scripts/build_omni_design.py"

Step 1: 確認概念 ＆ 取得3組照片生成提示詞

1. 若標語或概念尚未確定，請先執行以下命令，向使用者詢問5個核心問題（目標・3個效益・誰給誰×透過什麼×達成什麼・打破舊有前提➔真正解決方案・Before/After）：

   python3 "$SCRIPT" --ask-concept
   

   (範本正本: templates/CONCEPT_QUESTION_SHEET.md)
2. 品牌名稱・參考圖片（--ref-image / --ref-url）確定後，使用 --print-image-prompts 參數執行，以取得與色彩・風格DNA相符的3組照片提示詞（JSON）：

   python3 "$SCRIPT" \
     --brand "品牌名稱" \
     --category "商品類別（例如：耳環・高級珠寶）" \
     --ref-image "/path/to/reference.jpg" \
     --print-image-prompts
   

   (※若無參考圖片，可省略 --ref-image，系統將使用預設的人類策展DNA organic_editorial 的配色與風格)

Step 2: 使用訂閱制零費用的頂級模型生成3張照片素材（無文字照片）

使用 Step 1 輸出的3組提示詞（hero_image_prompt, poster_image_prompt, pack_image_prompt），生成3張不含文字的純粹商業棚拍照片（嚴禁產生API金鑰按量計費，僅限於訂閱範圍內）：

• 🅰️ 若正在 Codex 中執行（第一優先: gpt-image-2.5-sunburst）: 呼叫 Codex 內建的 image_gen 工具 3次（影像會自動儲存至 ~/.codex/generated_images/）。
• 🅱️ 若正在 Antigravity 中執行（Imagen 4 Ultra / Nano Banana 2.1）: 呼叫 invoke_subagent(TypeName="image-generator") 生成3張，並取得儲存路徑。
• 🅲 若請使用者自備照片: 直接將 Step 1（不帶 --print-image-prompts 參數執行）輸出的「📋 代理請求素材清單（所需照片構圖・建議尺寸・AI提示詞草案）」轉達給使用者。

Step 3: 一鍵輸出所有設計與促銷影片

接著只需執行以下一個命令，即可完成 3個可像 WordPress 一樣在瀏覽器中自由編輯圖文元素與版面的 HTML、高解析度 PNG/PDF/SVG，以及一組可後續自由編輯字幕與畫面的促銷影片：

# Codex 環境（使用 --auto-codex-images 自動綁定 Step 2 生成的圖片）
python3 "$HOME/.codex/skills/omni-design-studio/scripts/build_omni_design.py" \
  --auto-codex-images \
  --target all \
  --with-promo-video \
  --brand "LUMIÈRE & CO." \
  --category "耳環・高級珠寶" \
  --headline "Luminous Craft," \
  --subcopy "18K再生黃金與阿古屋珍珠交織的有機耳環系列" \
  --out-dir ~/Downloads/omni_output_pack

# Antigravity / Claude Code 或自訂個別圖片路徑
python3 "$HOME/.codex/skills/omni-design-studio/scripts/build_omni_design.py" \
  --target all \
  --with-promo-video \
  --brand "LUMIÈRE & CO." \
  --category "耳環・高級珠寶" \
  --headline "Luminous Craft," \
  --subcopy "18K再生黃金與阿古屋珍珠交織的有機耳環系列" \
  --hero-image /path/to/hero.jpg \
  --poster-image /path/to/poster.jpg \
  --pack-image /path/to/pack.jpg \
  --out-dir ~/Downloads/omni_output_pack

---

🎨 輸出後的 WordPress 風格視覺編輯 ＆ 影片字幕編輯功能（標準內建）

生成的3個設計檔案（website.html, poster.html, packaging_mockup.html）與影片工作室檔案（promo_video_studio_9x16.html, promo_video_studio_16x9.html）中，已由 cms_editor_runtime.py 自動內建 WordPress（Gutenberg）/ Studio 風格的視覺編輯器（✦ OMNI WP-STUDIO）。只需在瀏覽器中開啟即可進行以下編輯：

1. 直接編輯文字（Inline WYSIWYG）: 點選標題・內文・徽章・直排文案即可就地打字修改，並可一鍵變更字體大小（A+/A-）、文字顏色、字體家族（明體 / 和風現代 / 黑體 / 粗獷主義 / 瑞士網格）。
2. 圖片更換與邊框形狀變更: 雙擊圖片（或從電腦拖放）即可立即更換為其他照片。邊框形狀也可自由切換為「拱窗 (Arch)」「圓角卡片 (Bento)」「直角 (Sharp)」「圓形 (Circle)」。
3. 自由移動元素・區塊・版面: 使用方向鍵（↑/↓/←/→）移動選取的元素，複製（⧉）或刪除（🗑️）區塊，新增文字/圖片區塊（＋ 新增文字 / 🖼️ 新增圖片），一鍵翻轉左右兩欄配置（⇄ 翻轉版面）。
4. 儲存已編輯的 HTML 與輸出 PDF: 點選工具列的 💾 儲存 HTML 將編輯後的狀態儲存為單一 HTML 檔案，🖨️ 輸出 PDF 則可自動隱藏工具列並輸出高解析度 PDF/列印。
5. 影片的後續編輯與字幕編輯（Post-Production Ready）:
   • promo_video_studio_9x16.html / 16x9.html: 可使用底部的時間軸列搜尋 Scene 1〜4 並播放，直接修改影片內的字幕（標題）・標題・照片，點選 📝 儲存 SRT 字幕 按鈕即可立即匯出編輯後的字幕檔案。
   • promo_captions.srt / promo_captions.vtt / promo_audio_track.wav: 可直接匯入 Premiere Pro、CapCut、DaVinci Resolve、Final Cut Pro 等軟體進行字幕替換或背景音樂/旁白的重新編輯。

---

🛠️ 選項功能參考（需要時使用）

欲執行之操作	需添加的旗標 / 命令
從已填寫的概念問卷自動套用文案	--concept-sheet /path/to/CONCEPT_QUESTION_SHEET.md
完全重現參考圖片 / URL 的顏色、風格與字體	--ref-image /path/to/sample.jpg 或 --ref-url https://...
手動指定設計風格（預設為 organic_editorial）	--trend [organic_editorial | japanese_luxury | bento_glass | neo_brutalism | swiss_editorial | cyber_pop]
生成人類設計師百選參考圖表	python3 .../scripts/curate_human_designs.py --out-dir ~/Downloads/curation_100
量產模式（Plan B: DeepSeek + Flux 約0.6日元/張）	--plan plan_b（預設為 --plan plan_a = 訂閱制零費用）