Communitygithub.com

CleanExpo/Pi-Dev-Ops

根据1到3个十六进制锚点,生成一套完整的无障碍色板(主色、辅色、强调色、四步中性色、语义色及深色变体),并附带颜色家族分类。对所有的文本-背景组合进行WCAG-AA对比度验证。当BrandConfig中定义的颜色少于5个或对比度失败时触发。

Pi-Dev-Ops 是什么?

CleanExpo/Pi-Dev-Ops 是一个用于从极简输入生成完整无障碍色板的确定性技能。它接收1到3个十六进制颜色锚点(主色为必填,辅色和强调色为可选)以及一个颜色家族(如restoration、safety、industrial等),并自动补全缺失的色调。该技能在OKLch色彩空间中工作,以保证色相旋转时感知亮度不变,并确保所有文本-背景组合的对比度达到WCAG-AA标准(4.5:1)。 它支持多种视觉学派预设(如modern-minimal、tech-utility、brutalist-experimental等),这些预设会影响色相范围、亮度范围、中性色温度和强调色饱和度。该技能是确定性的——相同的输入始终产生相同的输出,并且绝不调用LLM。输出包含一个JSON对比度报告(包含OKLch坐标)和一个准备放入BrandConfig的YAML片段。它适用于Remotion Studio、Cursor和任何使用设计令牌的AI代理环境,确保品牌调色板既美观又无障碍。

兼容平台✓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个十六进制锚点(主色为必填;辅色、强调色可选)
  • 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靛蓝/青色/石板灰低(首选深色表面)冷灰色趋向石板灰-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消费者使用(第2阶段)。

  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)。如果不满足,则重新生成失败的槽位。Brutalist-experimental要求≥7.0(AAA)。

输出

两个产物:

  1. JSON对比度报告,包含OKLch坐标(供remotion-brand-codify和第2阶段Web使用):
{
  "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:块中 —— 令牌名称遵循@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.

相关技能