Communitygithub.com

CleanExpo/Pi-Dev-Ops

根據主題快速產出多支風格一致、不露臉的品牌行銷影片,涵蓋腳本、ElevenLabs 配音、插圖、ffmpeg 合成與 YouTube 上傳。

Pi-Dev-Ops 是什麼?

這個技能讓開發者或 AI 代理只需一條指令 `/brand-video` 就能產出多支風格統一、不露臉的品牌行銷影片。它與「faceless-video」和「video-director」不同之處在於它是一套完整的自動化管道:從腳本生成(120-140 字、12-16 句,每句對應一個視覺節拍)、使用 ElevenLabs 產生附時間戳的配音、利用 Gemini 2.5 Flash 模型生成 16:9 插圖,到最後透過 ffmpeg 合成 1080p 影片。它支援平行批次處理多個主題,並可選擇將影片上傳至 YouTube(非公開)。品牌風格(如 flat-line、hand-doodle、bold-kinetic 等)集中在 `styles.md` 檔案裡,修改該檔案就能立即擴充新外觀。該技能遵循嚴格的品牌 wiki 資料,確保內容真實可靠,並內建防呆機制與重配音、重合成等常見操作模式。支援 Cursor、Claude Code 與其他支援 MCP 的 AI 環境。

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

在你喜歡的 AI 中提問

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

說明文件

brand-video — 按需產出風格一致的不露臉影片

使用指令 /brand-video。一條指令,多種風格。基於已驗證的 RestoreAssist 專案(已交付 9 支影片)建構。從 styles.md 中選取風格,其餘參數保持不變,確保產出批次一致、品牌統一。

輸入(僅在缺少時詢問;合理推斷)

  • brand — RestoreAssist / Synthex / DR / NRPG / CARSI / CCW / Unite,或客戶名稱。設定主張、號召行動與配音。
  • style — styles.md 中的鍵值(預設 flat-line)。這就是「外觀」/下拉選項值。
  • topic(s) — 單一主題,或批次清單(每個主題一支影片,平行處理)。
  • voice — ELEVENLABS_VOICE_ID(依品牌而定;來自 ~/.hermes/.env)。關鍵:產生前務必確認當前值——使用者經常更改它。
  • upload? — 預設:僅算繪與暫存。僅在要求時上傳至 YouTube 非公開。

管道(每支影片一個 slug 資料夾,絕不共用目錄)

  1. 腳本 → <slug>/script.md:一個乾淨的 VO 段落,約 120–140 字,約 12–16 個短句(一句 = 一個視覺節拍 = 一張圖),問題→解決方案→號召行動。主張需基於品牌 wiki;不得虛構功能。結尾為品牌號召行動詞句。
  2. 配音 → 執行 bundled 的 tts.py(讀取 ELEVENLABS_API_KEY + ELEVENLABS_VOICE_ID + DIR): cd <workdir> && set -a && . ~/.hermes/.env && set +a && DIR=$PWD/<slug> python3 <skill>/pipeline/tts.py 產出 <slug>/voiceover.mp3 + <slug>/transcript.json(節拍)。記下節拍數量。
  3. 圖片 → 每個節拍一張,提示詞 = 所選風格的 POSITIVE token + 該句子對應的具體場景 + 該風格的 NEGATIVE token,橫向 16:9,檔案名稱零填充 <slug>/images/01.png …。
    • 正式 / 無頭模式(預設): python3 <skill>/pipeline/image_gen.py "<prompt>" <out.png> — Gemini gemini-2.5-flash-image(「Nano-Banana」)透過 HTTPS,GEMINI_API_KEY 從環境變數讀取。可在伺服器端運作;已完整驗證。這是應用程式 Worker 呼叫的方式(無需本機 MCP)。
    • 互動模式(選擇性): 在 Claude 工作階段中執行時使用 mcp__margot__image_generate;使用 slug 前綴的檔名以避免平行衝突(參見 [[parallel-agents-shared-output-collision]])。
  4. 合成 → python3 <skill>/pipeline/stitch.py <slug> → <slug>/final-1080p.mp4(1920×1080@25,圖片時間來自節拍)。確認最終長度 ≈ 配音長度。

批次處理與新增外觀

  • 批次: 每個主題分派一個子代理(平行處理),各自擁有自己的 slug 資料夾。參考 RestoreAssist 專案以取得精確的代理提示格式。
  • 重配音(變更配音,腳本/圖片不變):重新產生 VO,將 list.txt 的持續時間按 new_total/old_total 等比例縮放,重新合成。(重配音模式。)
  • 新增外觀: 在 styles.md 中新增一個區塊(positive/negative token)。該鍵值立即可作為可選風格——此登錄檔就是下拉選單的資料來源。

上傳(YouTube,選擇性)

瀏覽器檔案上傳已失效(主機路徑被拒)。使用 [[youtube-api-upload-restoreassist]] 中記載的 YouTube Data API 路徑:桌面 OAuth 用戶端 → token 儲存於 ~/.hermes/yt-restoreassist-token.json → videos().insert privacyStatus=unlisted、category 27、not-for-kids;以頻道標題為保護條件;透過 uploaded.json 確保冪等性。需要在 OAuth 用戶端的 GCP 專案中啟用 YouTube Data API v3。

防護措施

  • 主張必須真實(品牌 wiki / 產品事實)。扁平插圖 + 合成語音 → YouTube AI 揭露通常為「否」(上傳時確認;若有 AI 音樂則改為「是」)。
  • 為保持一致性,一個批次只使用一種風格。保持 SKILL.md 不超過 200 行(依據 [[feedback-tight-code]])。
  • 參考實作與素材:/Users/phill-mac/restoreassist-videos/。

Individual skills in this repo

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

CleanExpo/Pi-Dev-Ops

Produce a faceless YouTube-style video (hand-drawn doodle / simple-illustration channels like Zen, Nick Invest) end-to-end from a single topic. ASKS FACT-vs-STORY mode first (non-fiction educational vs fiction storytelling) and branches the whole run — built to serve multiple clients/channels, not one fixed format. Reverse-engineers a proven reference video's script format, writes a new script in that format, generates an ElevenLabs voiceover with timestamps, creates one styled Artlist (AI Toolkit) image per timestamp, and stitches everything with FFmpeg — fully automated, no human recording. Use when the user says "faceless video", "/faceless-video", "doodle video", "make a YouTube short/long-form in the Zen style", or wants an organic faceless-channel content piece. Composes with video-distribution-strategist (channel/launch) and video-director (when motion/edit polish is wanted instead of stills).

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.

相關技能