Communitygithub.com

TurkiHassan/period-launch-video

製作一支 24 秒正方形(1440²,60fps)循環產品發表影片,所有故事在字標的句點內發生 — 從夜間照片虹膜開啟、玻璃 UI 變化、到最終回到應用程式圖示旁的句點。

period-launch-video 是什麼?

這項技能可自動化產生一支 24 秒、1440x1440 解析度、60fps 的循環產品發表影片。整個故事視覺場景巧妙地被限制在字標的「句點」範圍內展開,包含虹膜開啟、玻璃質感 UI 元件變換(ask → find → write → night → results → phone lock screen → proof → CTA),並在最後閉合回應用程式圖示旁的句點。該技能支援 Playwright 渲染、動態模糊、節拍同步音效與 -14 LUFS 響度標準,提供阿拉伯語 RTL 與英語 LTR 兩種版面模板。工作流程包含專案初始化、從 App Store 或 iOS 素材目錄擷取品牌素材、選擇照片(支援 Higgsfield MCP、Codex 或 ChatGPT 提示)、透過節拍圖與六張關鍵影格獲得使用者批准,最後執行渲染、掃描驗證與交付。若使用者提及「the night-shift video」、「نفس فيديو النقطة」、或貼出含有「inside the period of the wordmark」/ iOS 玻璃面板/ goo-split 藥丸的簡報,即使未指名此技能也應自動觸發。

相容平台✓Claude Code✓Codex CLI~Cursor✓Gemini CLI
npx skills add TurkiHassan/period-launch-video

在你喜歡的 AI 中提問

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

說明文件

句點發表影片

一段 24 秒循環影片,產品的完整工作流程在字標的句點內上演。所有內容都放在 template/ 中:渲染器(index.html,所有內容在 config.js 中)、渲染、掃描與音訊腳本、字型、真實 macOS 游標以及峰值量測的 SFX。你的工作主要是選擇內容與照片,然後執行管線。在變更任何動畫前,請先閱讀 references/craft.md 一次。它包含了方向、節拍圖以及已經解決的陷阱。

工作流程

1 · 設定

~/.claude/skills/period-launch-video/scripts/new_project.sh <project>/brag-output/<slug>

將輸出放在使用者的專案內。如果存在 brag-output/ 這類被 git 忽略的資料夾,請使用它。該腳本也會從這台 Mac 複製真實的 macOS 游標(make_pointers.py,不重新分發)並安裝 Playwright。若要符合原始外觀,請將 Thmanyah Sans woff2 檔案(thmanyah-sans-{400,500,700}.woff2)放入 assets/fonts/。若無,則使用 IBM Plex Sans Arabic。

2 · 從專案收集輸入(只詢問缺少的部分)

  • 身份取自已發布版本。 使用 App Store 截圖、iOS 素材目錄(圖示、顏色)以及應用程式本身的範例資料與文案。忽略過時的網頁素材。如果你無法判斷哪個版本是現行的,請詢問。這是第一次執行後的主要修正。
  • 圖示: 將正方形應用程式圖示複製到 assets/img/icon.png。模板會自行套用 iOS 圓角遮罩。
  • 歌曲: 如果專案已有現成曲目則使用,否則請詢問。執行 python3 find_hit.py assets/music/song.mp3 並設定 config.song.hit(≈ 回報的擊點 − 0.04)與 bpm。enterAt(預設 3.10)是擊點落下的時間,位於第一個藥丸處。保持 enterAt + 20 beats 約在 13.5 秒,使「結果」落在第 20 拍。
  • 文案: 填入 config.js:名稱(一個單字,它會變成黑色字標加上句點)、標語、兩行開場文字、ask 藥丸、工作、find/write/night 標籤、3 個結果、通知、5 個函式庫列、圖表數值以及 CTA。讓每個數字在節拍間保持一致。使用西方數字。保持嚴格的 JSON 格式,因為 audio.py 會解析它。
  • 誠實檢查: 如果故事暗示了產品實際上做不到的事情(例如隔夜批次工作),請在渲染前提出並提供中立的措辭。

3 · 照片(四張圖板)

請遵循 references/image-prompts.md。根據可用資源選擇路徑:

  1. 有額度的 Higgsfield MCP。 先處理白天,然後夜晚與黎明作為白天工作的編輯,再加上外部。先預估費用。
  2. 本地 Codex(which codex)。scripts/codex_image.sh 使用使用者的 ChatGPT 訂閱中的 Codex 內建 image_gen。
  3. 無額度也無 Codex。 將四個填好的提示提供給使用者(編輯部分使用 Gemini)並等待圖片檔案。

然後:

python3 check_align.py      # night/dawn 必須相對於 day 偏移 (0,0)
python3 grade_plates.py     # → assets/img/*.jpg + 模糊副本;預覽 out/plates.jpg

4 · 節拍圖 + 六張靜態圖 → 渲染前取得批准

node stills.mjs 1.30 7.35 10.10 14.60 17.30 23.25     # open, find, write, results, phone, out
python3 sheet.py out/review-sheet.jpg out/stills/t{1.30,7.35,10.10,14.60,17.30,23.25}.png

先自己仔細檢查每張靜態圖:文字是否合適、有沒有被裁切、玻璃元件在圖板上是否可讀。然後向使用者展示該試算表(使用 SendUserFile)以及根據 index.html 中的 T 建立的節拍圖表格。只有在他們批准後才開始渲染。

5 · 渲染、驗證、交付

./build.sh out/<slug>-launch.mp4     # 4 個渲染工作者 → scan.py + scan_local.py → 時間軸 + 音訊 → H.264/AAC
  • scan.py 必須回報接縫差異約為 0(乾淨的循環),且無突波或階梯。
  • scan_local.py 的擊點若為計數器或打字聲則可接受。其他情況都是真正的爆音:找出是哪個交接造成的並修正。然後用 node render.mjs a b 只重新渲染那些影格,並使用 build.sh 中的 ffmpeg 指令重新編碼。
  • 在每個計數器結束時抽取一個影格,確認它顯示了精確的最終數字。
  • 報告規格(1440²、60fps、1440 影格、24.0 秒、LUFS、峰值)、任何未解決的誠實標記以及檔案路徑。

超越預設值的調整

  • 重新計時: 編輯 index.html 中的 T(保持 0.8 秒滑動),然後重新執行 node timeline.mjs && python3 audio.py。
  • 函式庫列數固定為 5 列,由佈局決定。圖表軸有 3 個標籤(起點、中點、終點)。
  • LTR 產品(英文字標):模板為 RTL 佈局。句點位於左端,列與藥丸靠右對齊,掃描與圖表從右到左進行。對於 LTR,鏡像這些錨點(align、R/L 邊界、scanX、cpt),並將圖示放在左側。為此預留時間並檢查每張靜態圖。

相關技能