Communitygithub.com

CleanExpo/Pi-Dev-Ops

從單一主題端到端製作無臉 YouTube 風格影片(手繪塗鴉 / 簡潔插畫頻道,如 Zen、Nick Invest)。優先詢問「事實 vs 故事」模式,並據此分支整個流程——專為服務多個客戶/頻道而生,非固定格式。自動逆向工程參考影片的腳本格式、撰寫新腳本、生成 ElevenLabs 有時間戳的配音、為每個時間戳建立風格統一的 Artlist 影像,最後用 FFmpeg 無縫拼接。

Pi-Dev-Ops 是什麼?

CleanExpo/Pi-Dev-Ops 是一個全自動無臉影片產生技能,專為打造塗鴉風格的 YouTube 內容而設計。它的核心流程從確定影片模式(事實型非虛構教育,還是故事型虛構敘事)開始,這會影響後續所有步驟,包括參考影片格式、資料驗證標準,以及最終是否標記為「兒童內容」。技能會從使用者提供的參考影片中逆向工程出結構框架(如鉤子 + 三根支柱 + 回饋,或角色 → 缺陷 → 旅程 → 教訓),並以該格式撰寫新腳本。配音完全使用 ElevenLabs TTS API 自動生成,並產生逐詞時間戳。每個時間戳對應一個影像,透過瀏覽器自動化 Artlist AI Toolkit(Nano Banana 2 模型)生成,並強制套用鎖定的樣式標記。最後使用 FFmpeg 將影像與配音拼接,並可選加入 Artlist AI Music 音軌。此技能支援 Cursor、Claude Code、Codex 等平台,但 Artlist 瀏覽器自動化需使用 Chrome 除錯模式。

相容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/CleanExpo/Pi-Dev-Ops/tree/HEAD/skills-library/skills/faceless-video

在你喜歡的 AI 中提問

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

說明文件

無臉影片管線

將無臉頻道影片建構為確定性四階段管線。來源拆解: ~/2nd Brain/2nd Brain/Wiki/research-faceless-youtube-claude-code-pipeline-2026-06-26.md。

嚴格規則(平台風險 + 品質)

  1. 配音 = ElevenLabs Voice Artist(Phill 的付費方案),不可使用人類錄音。來源影片中「AI 語音會被 Ban」的擔憂是錯誤的——請參閱 Sources/youtube-synthetic-content-disclosure-policy-2026-06-26.md 中的 YouTube 揭露政策。真正的規則是:YouTube 的「經修改/合成內容」揭露要求僅適用於 AI 音樂、非創作者本人克隆的合成語音,或對真人/真實地點/事件的逼真 AI 模擬——而不適用於動畫/塗鴉。這個揭露是零成本的(不影響觀看數/營利),因此每當影片包含 AI 音樂或非本人的合成語音(我們的管線總是如此)時,預設選擇「是」。在 YouTube Studio → 屬性 →「AI 使用」→「是」中設定。僅在內容面向兒童時(故事/育兒)將「為兒童製作」設為「是」。
  2. 每個影像使用單一樣式標記。 預先鎖定單一樣式描述;每個生成的影像都完整攜帶它,確保頻道視覺一致性。
  3. 符合模式的權威性(參見第 0 階段切換)。FACT/非虛構: 引用真實研究/日期/統計數據,撰寫前先研究,驗證主張的準確性。STORY/虛構: 發明敘事;權威來自情感共鳴,而非事實;改為驗證年齡和品牌適切性(例如,育兒類需溫和、安全、適合該年齡層)。絕不在事實模式下將虛構呈現為事實或發明「事實」。
  4. 靜態影像 + 配音,非動態圖形。 這是塗鴉頻道格式。若使用者想要動畫/編輯精修,則轉交給 video-director。

基礎設施——重要區別

來源影片使用 Higgsfield(Claude Code MCP)。我們不使用 Higgsfield。 Phill 的影像平台是 Artlist(artlist.io,AI Toolkit),透過 browser-harness 在瀏覽器中驅動。注意:「artist.io」是 artlist.io 的筆誤。

  • 影像生成(主要):Artlist AI Toolkit,位於 toolkit.artlist.io/image-video-generator?mode=image(模型 Nano Banana 2,16:9 / 2K)。第 3 階段中已透過內部測試驗證機制。
  • 影像生成(備用):mcp__margot__image_generate(同樣是 Nano Banana 2)——僅用於無人值守測試。從不使用 Higgsfield。
  • 配音:ElevenLabs TTS,透過 REST API 使用。金鑰和預設語音位於 ~/.hermes/.env(ELEVENLABS_API_KEY、ELEVENLABS_VOICE_ID)——透過程式解析,絕不直接貼上。無人類錄音。
  • 逐字稿擷取:yt-dlp。時間戳:ElevenLabs 對齊(主要)或 whisper-cli(備用)。拼接:ffmpeg。

工作目錄

建立 ~/faceless-video/<topic-slug>/,並將所有成品保留在內:reference-format.md、script.md、voiceover.mp3、transcript.json、images/NN.png、final.mp4。

第 0 階段——模式切換(優先詢問,在一切之前)

此引擎服務於不同客戶/應用程式時任務相反,因此每次執行的第一個問題是:

「這是 FACT(非虛構)還是 STORY(虛構)腳本?」 將 mode 記錄在工作目錄(mode.txt)中。它會分支整個流程:

FACT(非虛構)STORY(虛構)
使用案例教育產品、解說、冷知識育兒故事、寓言、睡前/品牌故事
參考格式鉤子 + 三根支柱主體 + 回饋角色 → 缺陷 → 旅程 → 教訓 → 結局
權威性經研究過的真實研究/統計/日期;準確性驗證情感共鳴;年齡/品牌適切性驗證
嚴格規則絕不發明事實絕不將虛構呈現為事實
YouTube 揭露AI 使用 = 是(有 AI 音樂/語音)AI 使用 = 是 + 專為兒童製作 = 是(兒童導向)

如果要求者已暗示模式(例如「為我妻子做一個育兒故事」→ STORY;「解釋 X 給我的產品」→ FACT),則一行確認而非重新詢問。預設的參考處理、腳本模板和驗證都由此切換決定。

第 0b 階段——樣式標記(每個頻道一次,之後重複使用)

請使用者提供目標視覺風格的 3–5 張參考截圖。提示分析:

「分析此影像的視覺風格,適用於 AI 影像生成器。提供 (1) 一個簡短的正面風格描述,我可以貼上作為提示詞;(2) 一組負面提示詞,以防止漂移到精緻/逼真的輸出。只關注風格,不關注主題。」 將結果儲存為頻道根目錄下的 style-token.md(該頻道的所有影片皆可重複使用)。

第 1 階段——腳本(根據第 0 階段模式分支)

  1. 要求提供主題和一個在所選模式範圍內的經過驗證的參考影片 URL(FACT 模式用事實頻道,STORY 模式用故事頻道——不要跨頻道)。
  2. 擷取參考逐字稿:yt-dlp --write-auto-sub --sub-lang en --skip-download --sub-format vtt -o 'ref-%(id)s.%(ext)s' '<URL>'。清理 .vtt(移除時間戳/標籤,去重疊的自動字幕行)。
  3. 拆解成可重複使用的模板,按模式:
    • FACT: 鉤子(微節拍)、介紹/承諾、三根支柱主體、過渡句、總長度。
    • STORY: 主角 + 一個共同缺陷、渴望、觸發事件、旅程、展示型(非告知型)示範、一句格言、內在覺悟、向前看的結尾。 儲存為 reference-format.md。
  4. 按該模板為主題撰寫一個新腳本。FACT: 先執行 source-ingest 技能,將可靠的 Tier 1–2 資料擷取到 Vault 的 Sources/ 庫中,然後僅引用這些儲存的來源撰寫腳本,並對每個主張進行準確性驗證。STORY: 自由創作,進行年齡/品牌適切性驗證。輸出一個乾淨的腳本(無場景指示)到 script.md。
  5. 在生成配音之前,先與使用者確認腳本。

第 2 階段——配音 + 時間戳(ElevenLabs,自動化)

  1. 透過 ElevenLabs 含時間戳端點,從 script.md 生成配音(一次呼叫返回音訊 + 字符對齊): curl -s -X POST "https://api.elevenlabs.io/v1/text-to-speech/$ELEVENLABS_VOICE_ID/with-timestamps" -H "xi-api-key: $ELEVENLABS_API_KEY" -H "content-type: application/json" -d '{"text":"<script>","model_id":"eleven_multilingual_v2"}' → 將 base64 音訊儲存為 voiceover.mp3,對齊資料儲存為 transcript.json。
  2. 從對齊資料推導出每個短語/句子的時間戳區段——每個區段成為一個影像節拍。(若對齊資料無法使用,備用方案:whisper-cli -f voiceover.wav -ml 1 --output-json -of transcript,先透過 ffmpeg -i voiceover.mp3 voiceover.wav 轉換。)
  3. 語音是按頻道/客戶的,非固定——選擇符合模式/品牌的 ElevenLabs 語音(例如,育兒虛構類用溫暖、溫柔的說書人;教育事實產品用清晰、權威的聲音)。將該 voice_id 取代 ELEVENLABS_VOICE_ID 中的預設值。在選擇時瀏覽使用者的 ElevenLabs 語音庫。
  4. 無需人工暫停——第 2 階段無人值守執行。

第 3 階段——每個時間戳一張影像(Artlist AI Toolkit,瀏覽器驗證)

每個節拍:場景提示詞 + 鎖定的樣式標記(逐字)。透過 browser-harness 驅動 Artlist(需要 Phill 的 Chrome 已登入;Way-1 遠端除錯已啟用)。經過艱苦測試的機制:

  1. 開啟 toolkit.artlist.io/image-video-generator?mode=image。提示詞是一個 [contenteditable=true] 的 div;Generate 按鈕的 innerText 為 Generate。預設設定已是 16:9 / 2K / 1 張影像(良好)。
  2. 每張影像:快照現有已生成的 UUID → 點擊文字框、document.execCommand('selectAll')、type_text(prompt) → 點擊 Generate → 輪詢直到載入文字(on its way|Almost ready|Generating)消失 且 出現新的 UUID。
  3. 結果位於 ai-toolkit-generations.imgix.net/...png?...&s=<sig>。使用通用正則表達式 [0-9a-f]{8}-[0-9a-f]{4}-...{12}\.png 提取 UUID(檔名前綴會變化:image-<uuid> 或 -t-e-x-t_-t-o_-i-m-a-g-e-<uuid>)。下載確切 src——重寫任何 imgix 參數(例如 w=)會破壞簽名 → 403。
  4. 一次只進行一張。 快速發送會觸發佇列/限流,且網格視圖會虛擬化 DOM,這兩者都會破壞新 UUID 的檢測。若生成在輪詢視窗之後完成,則從網格中搶救(下載不相符的 UUID,拼貼,視覺上對應)。 備用方案(僅無人值守):mcp__margot__image_generate——儲存為 <save_as>.jpg,需考慮副檔名。

第 4 階段——拼接

建立一個 FFmpeg concat,讓每個影像停留 (next_start - this_start) 秒,並混入配音:

  1. 從時間戳生成包含每個影像持續時間的 concat 列表。
  2. ffmpeg -f concat -safe 0 -i list.txt -i voiceover.wav -c:v libx264 -pix_fmt yuv420p -c:a aac -shortest final.mp4
  3. 對於正式上傳,建議使用 2K 來源影像(低解析度僅用於測試執行)。

第 5 階段——完成(針對正式上傳,非測試執行)

將原始拼接轉換為完成的交付物:

  • 1080p——將 concat 縮放/填補為 1920:1080(白色填補以融入素描本背景),crf 19。
  • 淡入淡出——fade=t=in:st=0:d=0.6:color=white 和結尾約 0.8 秒的 fade=t=out。在影像之間保留硬切(節拍上)(符合風格——請勿交叉淡入)。
  • 音樂背景——透過 Artlist AI Music 生成平靜的曲目(toolkit.artlist.io/music-generator?mode=music,Lyria 3;與影像相同的瀏覽器流程,結果為有簽名的 .wav,位於 cms-toolkit-artifacts.artlist.io/...music-<uuid>——下載確切 src)。與配音混合:volume≈0.13(約 −18 dB),afade 淡入 1.5 秒 / 淡出約 1.8 秒,amix=inputs=2:normalize=0。使用 volumedetect 驗證:整體峰值 < 0 dB(無削波),音樂平均值約低於配音 15 dB 以上。

輸出

final-1080p-music.mp4(交付物)+ 可重複使用的 style-token.md。回報路徑和每個階段的成品。對於發布/頻道策略,轉交給 video-distribution-strategist;請記住上傳時的合成內容揭露。

Individual skills in this repo

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

CleanExpo/Pi-Dev-Ops

Produce one or many consistent, on-brand faceless marketing videos from a topic: script, ElevenLabs voiceover with timestamps, one styled illustration per beat, ffmpeg stitch to 1080p, optional Unlisted YouTube upload. The look is a named style from styles.md (flat-line, hand-doodle, bold-kinetic, cinematic-photoreal, minimal-corporate, retro-print), so one command yields repeatable output per brand. The automated pipeline; distinct from faceless-video and video-director.

CleanExpo/Pi-Dev-Ops

The 15+ year brand director extension of `brand-guardian` specifically for video — frame-by-frame audit of brand-mark integrity, Gun Metal `#1a1a1a` + Candy Red `#dc143c` consistency, NO AI slop, NO Lucide icons, custom geometric marks ONLY, real logos correctly placed. PASS / FAIL gate before any client-facing video ships. Use after `video-colorist` completes the grade pass.

CleanExpo/Pi-Dev-Ops

The 15+ year Director-of-Photography persona (Roger Deakins / Emmanuel Lubezki / Hoyte van Hoytema-tier) that owns shot composition, lens psychology, motion language, and the decision of which source (Remotion / Hyperframes / stock cinematic) each scene uses. Extends the existing `remotion-designer` + `remotion-motion-language` skills with a frame-by-frame shot-language framework. Use when the user says "cinematography", "shot list", "framing", "DoP", "lens choice", or invoked by `video-director` Phase 2.

CleanExpo/Pi-Dev-Ops

The 15+ year colorist persona (Light Iron / Company 3 / The Mill-tier) that applies per-brand LUT + grade pass to every Unite-Group video. Closes the "raw Remotion render colours" gap — today Remotion outputs whatever colours BrandConfig declares with zero cinematic grade. Use when the user says "colour", "grade", "LUT", "look", "cinematic finish", or invoked by `video-director` Phase 3 (post-production) after `video-sound-designer` mixes audio.

CleanExpo/Pi-Dev-Ops

The Creative Director persona that owns brief intake, composition selection and narrative POV for every Unite-Group video. ENTRY POINT for the Video Agency: use for any video creation brief (explainer, promo, social cut, demo reel, case study, testimonial, client video). Dispatches the full production team: script-writer, cinematographer, editor, sound designer, colorist, brand-guardian.

CleanExpo/Pi-Dev-Ops

The 15+ year platform-native distribution expert (early TikTok creator economy + YouTube algorithm + LinkedIn organic reach + IG Reels native specialist) that owns per-platform aspect ratio + duration cap + caption format + hook density + thumbnail composition. Extends `remotion-marketing-strategist` with platform-native specs locked per BrandConfig. Use when the user says "which platform", "distribution", "channel-fit", "thumbnail", "captions", or invoked by `video-director` Phase 4 (QA + Delivery) for per-platform cuts.

CleanExpo/Pi-Dev-Ops

The 15+ year screenwriter persona (Pixar / Apple keynote / Nike spot tier) that engineers hooks (0-3s), retention beats (7-15s), narrative tension curves, and CTA placement. Extends the existing `remotion-screen-storyteller` skill with a structural framework lifted from Pixar's 22 Rules + Apple keynote architecture. Use when the user says "script", "voiceover", "narration", "hook", "story arc", or invoked by `video-director` Phase 2.

CleanExpo/Pi-Dev-Ops

The 15+ year sound designer persona (Skywalker Sound / Sound Lounge / Audio Network-tier) that mixes ElevenLabs voiceover with music bed, sound effects, ambient texture, and audio polish. Closes the single biggest gap in the existing Remotion pipeline — today voiceover is the ONLY audio; this skill adds music + SFX + mix. Use when the user says "sound design", "audio mix", "music bed", "SFX", "score this", or invoked by `video-director` Phase 3 (post-production).

CleanExpo/Pi-Dev-Ops

Converts a BrandResearch dossier into THREE artifacts — (1) typed BrandConfig TypeScript at Synthex/packages/brand-config/src/brands/{slug}.ts (runtime/behaviour — voice, voiceover, motion, audience, channel, forbiddenWords); (2) spec-conformant {slug}.design.md at Synthex/packages/brand-config/src/brands/{slug}.design.md (visual tokens — colour, typography, spacing, components, layout, elevation); (3) human-readable 9-section .md projection at Pi-Dev-Ops/remotion-studio/src/brands/{slug}.md derived from BOTH. Boundary contract at Pi-Dev-Ops/remotion-studio/src/brands/CONTRACT.md. Triggered after remotion-brand-research, or when the user pastes brand assets and says "codify". PRs are auto-merge:false — a human reviews before merge.

CleanExpo/Pi-Dev-Ops

Researches a portfolio company's visual identity from public sources (homepage, about page, marketing copy, GitHub README) and produces a structured BrandResearch dossier. Triggered when `Synthex/packages/brand-config/src/brands/{slug}.ts` (canonical home per RA-1985 / Synthex SYN-897) is missing, older than 90 days, or the user explicitly says "refresh brand for {brand}". Output feeds remotion-brand-codify.

CleanExpo/Pi-Dev-Ops

Generates a complete, accessible palette (primary, secondary, accent, 4-step neutral, semantic, and dark variant) from one to three hex anchors plus a colour-family classification. Validates WCAG-AA contrast for all text-on-background pairs. Triggered when a BrandConfig has fewer than 5 defined colours or contrast fails.

CleanExpo/Pi-Dev-Ops

Authors or extends a Remotion composition (.tsx) wired to BrandConfig + Storyboard + layout spec + motion. The actual builder skill — runs as a Sonnet-tier worker. Triggered after brand, storyboard, designer, and motion-language outputs are ready. Produces the file under remotion-studio/src/compositions/ and registers it in src/Root.tsx.

CleanExpo/Pi-Dev-Ops

Visual-design specialist for Remotion compositions. Sets layout grid, typography hierarchy, white-space, scene framing, and visual rhythm for a given composition + brand. Triggered after remotion-composition-builder for QA, or upfront when authoring a new composition type. Produces a layout spec consumed by remotion-composition-builder.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video needs creative direction — hook, visual sequence, scene purpose, motion restraint, and CTA direction before render.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video has timing, sync, transition, caption, pacing, or audio-fit risk and needs editing discipline before render.

CleanExpo/Pi-Dev-Ops

Use when /remotion-video needs existing Synthex ElevenLabs, brand-config, Remotion, output storage, Claude, or Hermes integration without adding vendors.

CleanExpo/Pi-Dev-Ops

Tunes a video's format and message for the target channel — LinkedIn, YouTube, Instagram Reel, internal training. Sets aspect ratio, total duration, hook timing, CTA timing, and pacing. Triggered when the brief mentions a specific channel or campaign goal. Output feeds remotion-screen-storyteller and remotion-composition-builder.

CleanExpo/Pi-Dev-Ops

Designs a brand-specific motion vocabulary — easing curves, default scene durations, signature entry/exit, transition frames. Each brand gets one signature move (rise / sweep / pulse / iris / whip) that recurs across compositions to build motion-recognition. Triggered when BrandConfig.motion is empty.

CleanExpo/Pi-Dev-Ops

/remotion-video one-shot Remotion command skill and ENTRY POINT for the Remotion Skills Package. Use for video, explainer, ad, promo, reel, intro, social cut, marketing, training, or launch videos. Reads the brief, classifies intent, enforces one single Synthex ElevenLabs voice, emits a production/wave plan, and dispatches the right sub-skills in topological order. Always invoked first.

CleanExpo/Pi-Dev-Ops

Use when a Remotion video job needs production gates, render evidence, output discipline, and pass/fail validation before it can be called shippable.

相關技能