init: huashu-design skill v1.0

花叔设计工作台 —— AI 驱动的 HTML 设计工作流，支持 Claude Code / Codex /
Cursor / Trae / OpenClaw / Hermes Agent 等任意 skill-compatible agent。

四条主干能力：
- HTML 高保真视觉产出（原型/App/幻灯片/动画/变体/信息图）
- 设计方向顾问 Fallback（5 流派 × 20 设计哲学 × 24 预制 showcase）
- Junior Designer 工作流（先 show 假设再迭代）
- 专家级 5 维度评审（哲学/层级/执行/功能/创新）

工程工具链：
- HTML → 25fps/60fps MP4 + palette GIF，含 6 首场景化 BGM
- HTML → PDF / PPTX 导出
- Playwright 截图 + 控制台错误验证
- iOS/Android/macOS/Browser 设备边框 + Stage/Sprite 动画引擎

初版包含 SKILL.md + 13 份 references + 7 个 scripts + 18 类 assets。

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>

scripts/render-video.js

@@ -0,0 +1,254 @@
+#!/usr/bin/env node
+/**
+ * HTML animation → MP4 via Playwright recordVideo + ffmpeg.
+ *
+ * Requires: global playwright (`npm install -g playwright`), ffmpeg on PATH.
+ *
+ * Usage:
+ *   NODE_PATH=$(npm root -g) node render-video.js <html-file> \
+ *     [--duration=30] [--width=1920] [--height=1080] \
+ *     [--trim=<seconds>] [--fontwait=1.5] [--readytimeout=8] \
+ *     [--keep-chrome]
+ *
+ * Design:
+ *   1. Warmup context (no record) — caches fonts/assets, closes cleanly
+ *   2. Record context (fresh, recordVideo ON) — WebM starts writing at
+ *      context creation. Babel-standalone compile + React mount +
+ *      fonts.ready can take 1.5-3s, during which WebM writes black frames.
+ *      We measure this by waiting for window.__ready (set by animations.jsx
+ *      Stage component after first paint), then trim exactly that offset.
+ *   3. addInitScript injects CSS hiding "chrome" elements (progress bar,
+ *      replay button, masthead, footer, etc.) that are fine for human
+ *      debugging but shouldn't appear in exported video.
+ *
+ * Animation-ready signal:
+ *   Set `window.__ready = true` in your HTML after first paint. This tells
+ *   the recorder "animation has started rendering — treat now as t=0".
+ *   If you use animations.jsx, Stage does this automatically. Otherwise
+ *   add: `document.fonts.ready.then(() => requestAnimationFrame(() => { window.__ready = true }));`
+ *   after your first render call.
+ *
+ *   Without __ready, falls back to --fontwait=1.5s (may leave 1-2s of black
+ *   at the start). Pass --trim=<seconds> to override manually.
+ *
+ * Chrome elements hidden by default (all common class names + `.no-record`
+ * convention). Pass --keep-chrome to disable this and see raw HTML.
+ *
+ * Output: next to the HTML file, same basename with .mp4 suffix.
+ */
+
+const { chromium } = require('playwright');
+const path = require('path');
+const fs = require('fs');
+const { spawnSync } = require('child_process');
+
+function arg(name, def) {
+  const p = process.argv.find(a => a.startsWith('--' + name + '='));
+  return p ? p.slice(name.length + 3) : def;
+}
+function hasFlag(name) {
+  return process.argv.includes('--' + name);
+}
+
+const HTML_FILE = process.argv[2];
+if (!HTML_FILE || HTML_FILE.startsWith('--')) {
+  console.error('Usage: node render-video.js <html-file>');
+  console.error('Example: NODE_PATH=$(npm root -g) node render-video.js my-animation.html');
+  process.exit(1);
+}
+
+const DURATION  = parseFloat(arg('duration', '30'));
+const WIDTH     = parseInt(arg('width', '1920'));
+const HEIGHT    = parseInt(arg('height', '1080'));
+const TRIM_OVERRIDE = arg('trim', null);              // manual override (seconds). If unset, auto-detected.
+const FONT_WAIT = parseFloat(arg('fontwait', '1.5')); // fallback when no __ready signal
+const READY_TIMEOUT = parseFloat(arg('readytimeout', '8'));
+const KEEP_CHROME = hasFlag('keep-chrome');
+
+const HTML_ABS = path.resolve(HTML_FILE);
+const BASENAME = path.basename(HTML_FILE, path.extname(HTML_FILE));
+const DIR      = path.dirname(HTML_ABS);
+const TMP_DIR  = path.join(DIR, '.video-tmp-' + Date.now() + '-' + process.pid);
+const MP4_OUT  = path.join(DIR, BASENAME + '.mp4');
+
+// CSS to hide "chrome" elements during recording.
+// Covers class-name conventions seen across skill-built animations,
+// plus a `.no-record` explicit opt-out class.
+const HIDE_CHROME_CSS = `
+  .no-record,
+  .progress, .progress-bar,
+  .counter, .tCur,
+  .phases, .phase-label, .phase,
+  .replay, button.replay,
+  .masthead, .kicker, .title,
+  .footer,
+  [data-role="chrome"], [data-record="hidden"] {
+    display: none !important;
+  }
+`;
+
+console.log(`▸ Rendering: ${HTML_FILE}`);
+console.log(`  size: ${WIDTH}x${HEIGHT} · duration: ${DURATION}s · hide-chrome: ${!KEEP_CHROME}`);
+console.log(`  output: ${MP4_OUT}`);
+
+(async () => {
+  fs.mkdirSync(TMP_DIR, { recursive: true });
+
+  const browser = await chromium.launch();
+  const url = 'file://' + HTML_ABS;
+
+  // ── Phase 1: WARMUP (no recording, caches fonts/assets) ─────────────
+  console.log('▸ Warmup (caching fonts)…');
+  const warmupCtx = await browser.newContext({
+    viewport: { width: WIDTH, height: HEIGHT },
+  });
+  const warmupPage = await warmupCtx.newPage();
+  await warmupPage.goto(url, { waitUntil: 'networkidle' });
+  await warmupPage.waitForTimeout(FONT_WAIT * 1000);
+  await warmupCtx.close();
+
+  // ── Phase 2: RECORD (fresh context, animation from t=0) ─────────────
+  console.log('▸ Recording (clean start)…');
+  const recordCtx = await browser.newContext({
+    viewport: { width: WIDTH, height: HEIGHT },
+    deviceScaleFactor: 1,
+    recordVideo: {
+      dir: TMP_DIR,
+      size: { width: WIDTH, height: HEIGHT },
+    },
+  });
+
+  // Inject CSS + JS heuristic to hide "chrome" elements.
+  // Two layers:
+  //   A. CSS selectors for common class-name conventions (cheap)
+  //   B. JS heuristic for fixed-position bars containing buttons or time
+  //      readouts (catches inline-styled chrome like <Stage> controls)
+  // Persists across reloads via addInitScript.
+  if (!KEEP_CHROME) {
+    await recordCtx.addInitScript(css => {
+      const HIDE_MARK = 'data-video-hidden';
+
+      function injectStyle() {
+        const style = document.createElement('style');
+        style.setAttribute('data-inject', 'render-video-chrome-hide');
+        style.textContent = css;
+        (document.head || document.documentElement).appendChild(style);
+      }
+
+      function hideChromeBars() {
+        const vh = window.innerHeight;
+        document.querySelectorAll('div, nav, header, footer, section, aside')
+          .forEach(el => {
+            if (el.hasAttribute(HIDE_MARK)) return;
+            if (el.dataset.recordKeep === 'true') return;
+            const s = getComputedStyle(el);
+            if (s.position !== 'fixed' && s.position !== 'sticky') return;
+            const r = el.getBoundingClientRect();
+            // Only skinny bars (not full-screen overlays)
+            if (r.height > vh * 0.25) return;
+            const atBottom = r.bottom >= vh - 30;
+            const atTop = r.top <= 30 && r.height < 80;
+            if (!atBottom && !atTop) return;
+            // Chrome-like: contains button or scrubber/time glyphs
+            const txt = el.textContent || '';
+            const hasBtn = !!el.querySelector('button, [role="button"]');
+            const hasCtrls = /[⏸▶⏮⏭↻↺↩↪]|\d+\.\d+\s*s/.test(txt);
+            if (hasBtn || hasCtrls) {
+              el.style.setProperty('display', 'none', 'important');
+              el.setAttribute(HIDE_MARK, '1');
+            }
+          });
+      }
+
+      const start = () => {
+        injectStyle();
+        hideChromeBars();
+        // Re-run as React/Vue commits DOM changes
+        const obs = new MutationObserver(hideChromeBars);
+        obs.observe(document.body, { childList: true, subtree: true });
+        setTimeout(() => obs.disconnect(), 6000);
+      };
+
+      if (document.readyState === 'loading') {
+        document.addEventListener('DOMContentLoaded', start, { once: true });
+      } else {
+        start();
+      }
+    }, HIDE_CHROME_CSS);
+  }
+
+  // Record context opens page. The WebM starts writing the moment the
+  // context is created — so we track T0 here and measure how many seconds
+  // elapse before the animation is actually ready (Babel compile + React
+  // mount + fonts.ready). That elapsed time = exact trim offset.
+  const T0 = Date.now();
+  const page = await recordCtx.newPage();
+  await page.goto(url, { waitUntil: 'networkidle' });
+
+  // Wait for animation ready signal. Stage component (animations.jsx) sets
+  // window.__ready = true on its first rAF after mount + fonts.ready.
+  // Fallback: if HTML doesn't set __ready within READY_TIMEOUT, use fontwait.
+  let animationStartSec;
+  const hasReady = await page.waitForFunction(
+    () => window.__ready === true,
+    { timeout: READY_TIMEOUT * 1000 },
+  ).then(() => true).catch(() => false);
+
+  if (hasReady) {
+    animationStartSec = (Date.now() - T0) / 1000;
+    console.log(`▸ Ready at ${animationStartSec.toFixed(2)}s (from window.__ready)`);
+  } else {
+    await page.waitForTimeout(FONT_WAIT * 1000);
+    animationStartSec = (Date.now() - T0) / 1000;
+    console.log(`▸ No window.__ready signal; using fallback wait (${animationStartSec.toFixed(2)}s)`);
+    console.log(`  tip: in animations.jsx-based HTML this is automatic;`);
+    console.log(`       otherwise set window.__ready=true after your first paint.`);
+  }
+
+  // Now let the animation play out its full duration
+  await page.waitForTimeout(DURATION * 1000 + 300);
+
+  await page.close();
+  await recordCtx.close();
+  await browser.close();
+
+  const webmFiles = fs.readdirSync(TMP_DIR).filter(f => f.endsWith('.webm'));
+  if (webmFiles.length === 0) {
+    console.error('✗ No webm produced');
+    process.exit(1);
+  }
+  const webmPath = path.join(TMP_DIR, webmFiles[0]);
+  console.log(`▸ WebM: ${(fs.statSync(webmPath).size / 1024 / 1024).toFixed(1)} MB`);
+
+  // Resolve final trim offset:
+  //   - manual --trim=X   → use X (explicit user override)
+  //   - otherwise          → use animationStartSec (measured), with a tiny
+  //                          +0.05s nudge to clear the first Babel-commit frame
+  const resolvedTrim = TRIM_OVERRIDE !== null
+    ? parseFloat(TRIM_OVERRIDE)
+    : animationStartSec + 0.05;
+
+  console.log(`▸ ffmpeg: trim=${resolvedTrim.toFixed(2)}s${TRIM_OVERRIDE !== null ? ' (manual)' : ' (auto)'}, encode H.264…`);
+  const ffmpeg = spawnSync('ffmpeg', [
+    '-y',
+    '-ss', String(resolvedTrim),
+    '-i', webmPath,
+    '-t', String(DURATION),
+    '-c:v', 'libx264',
+    '-pix_fmt', 'yuv420p',
+    '-crf', '18',
+    '-preset', 'medium',
+    '-movflags', '+faststart',
+    MP4_OUT,
+  ], { stdio: ['ignore', 'ignore', 'pipe'] });
+
+  if (ffmpeg.status !== 0) {
+    console.error('✗ ffmpeg failed:\n' + ffmpeg.stderr.toString().slice(-2000));
+    process.exit(1);
+  }
+
+  fs.rmSync(TMP_DIR, { recursive: true, force: true });
+
+  const mp4Size = (fs.statSync(MP4_OUT).size / 1024 / 1024).toFixed(1);
+  console.log(`✓ Done: ${MP4_OUT} (${mp4Size} MB)`);
+})();