Communitygithub.com

CleanExpo/Pi-Dev-Ops

根据主题生成一个或多个风格一致、无品牌露出的营销视频:脚本、带时间戳的 ElevenLabs 语音旁白、每拍对应一张风格化插画、ffmpeg 合成 1080p,并可选择上传至 YouTube(非公开)。

Pi-Dev-Ops 是什么?

该技能(/brand-video)能够从单一主题或主题列表自动生成风格统一、不露脸的营销视频。它从 styles.md 中选择一个命名风格(如 flat-line、hand-doodle、bold-kinetic 等),然后依次执行:生成约 120–140 字的脚本、使用 ElevenLabs(通过品牌专属 VOICE_ID)生成带时间戳的旁白、为每个句子/节拍通过 Gemini 2.5 Flash 生成一张 16:9 插画(支持无头生产模式),最后用 ffmpeg 合成为 1080p25 的 MP4 文件。支持批量并行生成(每个主题一个子代理),也支持在语音变更时仅重新生成旁白并调整时间适配。上传至 YouTube 时使用 Desktop OAuth 客户端和 YouTube Data API v3,确保非公开上传且幂等。所有步骤都在独立的文件夹中进行,避免并行冲突。该技能适用于 Cursor、Claude Code 等工具,强调一致性、可重复性和品牌适配。

兼容平台✓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 或某个客户。决定主张、CTA 和语音。
  • style — styles.md 中的一个键(默认 flat-line)。这就是“外观”/下拉选项值。
  • topic(s) — 一个角度,或一个列表用于批量生成(每个视频一个,并行)。
  • voice — ELEVENLABS_VOICE_ID(每个品牌不同;来自 ~/.hermes/.env)。关键:在生成前确认当前值——用户会经常更换。
  • upload? — 默认:仅渲染并暂存。仅在用户要求时才上传至 YouTube 非公开。

流水线(每个视频 — 各自一个 slug 文件夹,从不共享目录)

  1. 脚本 → <slug>/script.md:一段干净的旁白段落,约 120–140 字,约 12–16 个短句(一个句子 = 一个视觉节拍 = 一张图片),问题→解决方案→CTA。基于品牌维基进行主张验证;绝不捏造功能。以品牌的 CTA 行结尾。
  2. 语音旁白 → 运行捆绑的 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 从环境变量读取。服务端运行;已端到端验证。这是应用工作者调用的方式(无需本地 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 运行记录中确切的代理提示格式。
  • 重新配音(语音变更,脚本/图片不变):重新生成旁白,按 新总时长/旧总时长 缩放 list.txt 中的持续时间,重新合成。(参见 revoice 模式。)
  • 添加新外观: 在 styles.md 中添加一个代码块(positive/negative token)。该键立即成为可选风格——这个注册表就是下拉菜单的数据源。

上传(YouTube,可选)

浏览器文件上传已不可用(主机路径被拒绝)。使用 [[youtube-api-upload-restoreassist]] 中记录的 YouTube Data API 路径:Desktop OAuth 客户端 → 令牌存储在 ~/.hermes/yt-restoreassist-token.json → videos().insert privacyStatus=unlisted,category 27,not-for-kids;通过频道标题进行守卫;通过 uploaded.json 实现幂等。需要在 OAuth 客户端的 GCP 项目中启用 YouTube Data API v3。

安全护栏

  • 主张必须真实(来自品牌维基/产品事实)。扁平插画 + 合成语音 → YouTube AI 披露通常选“否”(上传时确认;如果添加了 AI 音乐则改为“是”)。
  • 每个批次保持一种风格以确保一致性。遵循 [[feedback-tight-code]] 保持 SKILL.md 不超过 200 行。
  • 参考实现 + 资产:/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.

相关技能