Communitygithub.com

CleanExpo/Pi-Dev-Ops

根據1到3個十六進位錨點與色彩家族分類,自動生成完整、無障礙的色彩調色盤(主色、次要色、強調色、4階中性色、語意色及深色變體)。驗證所有文字-背景組合的WCAG-AA對比度。當BrandConfig定義的顏色少於5種或對比度檢查失敗時觸發。

Pi-Dev-Ops 是什麼?

此技能 (CleanExpo/Pi-Dev-Ops) 是一個完整的品牌調色盤生成器,專為AI代理(如Claude Code、Cursor、Codex)設計。它能從極少量的輸入(1-3個十六進位錨點)自動產生一套包含主色、次要色、強調色、4階中性色、語意色(成功、警告、危險)及深色變體的調色盤。其核心特色是支援「學派預設」(school presets),例如「現代簡約」或「編輯部單片眼鏡」,讓產出的色系符合特定設計風格。此工具使用OKLch色彩空間進行色相旋轉以維持感知亮度,並確保所有文字與背景組合的對比度皆符合WCAG-AA標準(4.5:1),對於「粗野主義實驗」學派更要求AAA標準(7.0:1)。整合於CleanExpo/Pi-Dev-Ops專案中,適用於Claude Code、Codex、Cline等平台,可輸出JSON對比報告與YAML片段,方便直接整合進品牌設定檔,並確保生成過程完全確定性,避免隨機誤差。

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

在你喜歡的 AI 中提問

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

說明文件

remotion-colour-family

從最少錨點建立完整調色盤。重複使用 remotion-studio/src/colour/index.ts 中的 contrast() 輔助函式。

觸發條件

  • BrandConfig 缺少 secondary、accent、neutral 或 semantic 區塊。
  • 渲染對比度失敗:任何文字-背景組合的比率 < 4.5。
  • 使用者說「擴展 {brand} 的調色盤」或「審核顏色」。

輸入

  • 1-3 個十六進位錨點(primary 為必填;secondary、accent 為選填)
  • family:restoration | safety | industrial | consumer | training
  • school (選填):editorial-monocle | modern-minimal | warm-soft | tech-utility | brutalist-experimental — 視覺學派預設(開放設計血統)。在家族啟發法執行之前選擇類型特徵、對比傾向和強調色角色。預設值:modern-minimal。
  • 現有調色盤(若為擴展用途)

方法

  1. 學派預設 — 先套用 school 偏差。每個學派限制了色相範圍、明度範圍、中性色溫度和強調色飽和度:

    學派色相偏差明度偏差中性色強調色飽和度參考(已供應)
    editorial-monocle溫暖大地色(陶土/黏土/沙色)高(羊皮紙/象牙色)僅暖灰色 — 每個灰色帶有黃褐色底色一個色調強調色,深層大地色_library/claude/、_library/monocle/(如果存在)
    modern-minimal冷中性色(石板灰/藍灰色)平衡純灰色一個電光強調色,每個視窗使用少於3次_library/airbnb/、_library/cal/
    warm-soft溫暖粉彩(桃色/粉紅/奶油色)高暖灰色 + 奶油色調低飽和度玫瑰/珊瑚_library/airtable/、_library/cafe/
    tech-utility靛藍 / 青色 / 石板灰低(偏好深色表面)偏向 slate-900 的冷灰色青色信號強調色,僅用於差異/狀態_library/binance/、_library/arc/
    brutalist-experimental純白背景上的高對比主色極高 + 極深僅純黑/白色銳利霓虹色,大膽使用_library/brutalism/、_library/bold/
  2. 家族啟發法 — 在學派之後套用。家族提供了標準的相鄰色:

    • safety:海軍藍 + 緊急橘色 + 象牙色
    • restoration:藍綠色 + 石板灰 + 萊姆綠
    • industrial:石墨灰 + 鋼鐵灰 + 琥珀色
    • consumer:主色紅/藍 + 暖白 + 石板灰
    • training:陶土色 + 奶油色 + 墨色
  3. 在 OKLch 中生成 — 在 OKLch 色彩空間(而非 HSL)中運作,讓色相旋轉能保持感知明度。先將十六進位錨點轉換為 OKLch;將色相旋轉 ±30°/±60°,同時將明度限制在學派的範圍內。將輸出轉回十六進位以儲存於 BrandConfig。在對比報告中保留 oklch 同層級欄位,供下游 Tailwind-4 使用(第二階段)。

  4. 確定性 — 相同的 (primary, family, school) 三元組必須在每次執行中產生相同的輸出調色盤。沒有隨機性;沒有溫度;沒有 LLM 插值。生成器是輸入的純函數。

  5. 建立中性色 — 在 oklch(99% 0 hue) (50) 和 oklch(15% 0 hue) (900) 之間插值,根據學派偏差將 chroma 偏向主色的色相(warm-soft 會將中性色拉暖;tech-utility 會將它們拉冷)。

  6. 建立語意色 — 從一個固定池中選取 success/warning/danger,確保不會與主色衝突。

  7. 建立深色變體 — 反轉中性色(將 50 ↔ 900 的明度互換),並在 OKLch 空間中將主色明度提高 8%。

  8. 驗證 — 針對每對 (primary, neutral.50)、(primary, neutral.900)、(secondary, neutral.50)、(accent, secondary),確保對比度 ≥ 4.5(WCAG-AA)。若不符,則重新生成失敗的欄位。粗野主義實驗學派要求 ≥ 7.0(AAA)。

輸出

兩個成品:

  1. JSON 對比報告,包含 OKLch 座標(供 remotion-brand-codify 和第二階段網頁使用):
{
  "school": "modern-minimal",
  "family": "restoration",
  "tokens": {
    "primary": { "hex": "#0E7C7B", "oklch": "oklch(48% 0.10 195)" },
    "neutral": {
      "50":  { "hex": "#F5F7F8", "oklch": "oklch(97% 0.005 200)" },
      "900": { "hex": "#0E1518", "oklch": "oklch(15% 0.010 215)" }
    }
  },
  "passes": [ { "fg":"#F5F7F8", "bg":"#0E7C7B", "ratio": 7.21, "level":"AAA" } ],
  "fails": []
}
  1. YAML 片段,可直接插入 Synthex/packages/brand-config/src/brands/{slug}.design.md 的 colors: 區塊 — Token 名稱遵循 @google/design.md 規範(階層名稱使用小寫加連字號,例如 neutral-50、dark-primary):
colors:
  primary: "#0E7C7B"
  secondary: "#2A3D45"
  accent: "#C5E063"
  neutral-50: "#F5F7F8"
  neutral-100: "#E4E9EC"
  neutral-500: "#6F7B82"
  neutral-900: "#0E1518"
  success: "#3FA34D"
  warning: "#E0A800"
  danger: "#C0392B"
  on-primary: "#FFFFFF"
  on-secondary: "#FFFFFF"
  on-accent: "#0E1518"
  surface: "{colors.neutral-50}"
  on-surface: "{colors.neutral-900}"
  dark-primary: "#16B5B3"
  dark-secondary: "#1A2428"
  dark-surface: "#0E1518"
  dark-on-surface: "#F5F7F8"

對結果的 .design.md 執行 npx --prefix Pi-Dev-Ops/remotion-studio design.md lint 以確認零對比度錯誤。

邊界

  • 絕不交付帶有任何 AA 失敗的調色盤 — 封鎖並請求創辦人對有問題的欄位提供意見。
  • 絕不覆蓋品牌已設定的明確 darkVariant。
  • 除非 family === 'consumer' 且品牌名稱明確以紅色為錨點,否則絕不使用紅色作為主色。
  • 絕不在生成中途使用 LLM — 該函數是確定性的。如果確定性失敗(相同輸入在不同執行中產生不同輸出),那是生成器的錯誤,而不是功能。
  • 絕不混合兩個學派 — 選擇一個。將 editorial-monocle 的溫暖與 tech-utility 的石板灰混合會產生每個品牌起步時那種渾濁的「AI 預設」調色盤。

交接給

remotion-brand-codify 將結果寫入 src/brands/{slug}.ts。

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

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

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.

相關技能