opencode-skills-collection 4.0.35 → 4.0.37

package/bundled-skills/liuguang-banlan-ui/assets/starter/shared/workbench.js

@@ -0,0 +1,255 @@
+(function () {
+  "use strict";
+
+  const config = window.SPECTRAL_THEME;
+  const canvas = document.querySelector("#spectral-field");
+  const field = new window.SpectralField(canvas, config);
+  const panel = document.querySelector("#parameter-panel");
+  const panelToggle = document.querySelector("#parameter-toggle");
+  const panelClose = document.querySelector("#parameter-close");
+  const controls = document.querySelector("#parameter-controls");
+  const exportButton = document.querySelector("#export-parameters");
+  const copyButton = document.querySelector("#copy-parameters");
+  const motionButton = document.querySelector("#motion-toggle");
+  const menuButton = document.querySelector("#menu-toggle");
+  const sidebar = document.querySelector("#sidebar");
+  const liveStatus = document.querySelector("#live-status");
+  const defaultConfig = JSON.parse(JSON.stringify(config));
+
+  function formatNumber(value, digits = 2) {
+    return Number(value).toFixed(digits);
+  }
+
+  function applyThemeMetadata() {
+    document.documentElement.dataset.mode = config.mode;
+    document.querySelectorAll("[data-theme-name]").forEach((node) => {
+      node.textContent = config.label;
+    });
+    document.querySelector("#preset-value").textContent = config.preset;
+    document.querySelector("#seed-value").textContent = String(config.seed);
+    document.querySelector("#renderer-value").textContent = field.available ? "WebGL · live" : "CSS · fallback";
+  }
+
+  function renderControls() {
+    controls.replaceChildren();
+
+    const overall = document.createElement("div");
+    overall.className = "parameter-block parameter-master";
+    overall.innerHTML = `
+      <div class="parameter-heading">
+        <div>
+          <span class="parameter-kicker">全局色度预算</span>
+          <strong>总体彩色强度</strong>
+        </div>
+        <output for="overall-intensity">${formatNumber(config.overallColorIntensity)}</output>
+      </div>
+      <input id="overall-intensity" type="range" min="0" max="1" step="0.01" value="${config.overallColorIntensity}" aria-label="总体彩色强度">
+      <div class="range-labels"><span>中性基材</span><span>校准上限</span></div>
+    `;
+    controls.append(overall);
+
+    const overallInput = overall.querySelector("input");
+    overallInput.addEventListener("input", () => {
+      config.overallColorIntensity = Number(overallInput.value);
+      overall.querySelector("output").value = formatNumber(config.overallColorIntensity);
+      field.updateConfig(config);
+      announce(`总体彩色强度 ${formatNumber(config.overallColorIntensity)}`);
+    });
+
+    config.colors.forEach((color, index) => {
+      const row = document.createElement("div");
+      row.className = "parameter-block color-parameter";
+      row.innerHTML = `
+        <div class="parameter-heading">
+          <div class="color-name">
+            <span class="color-chip" style="--chip:${color.srgbFallback}"></span>
+            <div>
+              <strong>${color.label}</strong>
+              <span class="parameter-kicker">OKLCH ${formatNumber(color.oklch.l)} ${formatNumber(color.oklch.c, 3)} ${formatNumber(color.oklch.h, 0)}</span>
+            </div>
+          </div>
+          <output for="color-${index}">${formatNumber(color.intensity)}</output>
+        </div>
+        <input id="color-${index}" type="range" min="0" max="1" step="0.01" value="${color.intensity}" aria-label="${color.label}强度">
+        <dl class="parameter-facts">
+          <div><dt>峰值 α</dt><dd>${formatNumber(color.peakOpacity, 3)}</dd></div>
+          <div><dt>空间尺度</dt><dd>${formatNumber(color.fieldScale)}</dd></div>
+          <div><dt>相位</dt><dd>${color.phase.map((value) => formatNumber(value)).join(" / ")}</dd></div>
+        </dl>
+      `;
+      controls.append(row);
+      const input = row.querySelector("input");
+      input.addEventListener("input", () => {
+        color.intensity = Number(input.value);
+        row.querySelector("output").value = formatNumber(color.intensity);
+        field.updateConfig(config);
+        announce(`${color.label}强度 ${formatNumber(color.intensity)}`);
+      });
+    });
+  }
+
+  function serializableConfig() {
+    return {
+      ...config,
+      validationCapabilities: {
+        modelVision: "runtime-check-required",
+        screenshotCapture: "runtime-check-required",
+        deterministicPixelMetrics: "runtime-check-required",
+        visualVerificationMode: "unverified"
+      }
+    };
+  }
+
+  function downloadParameters() {
+    const blob = new Blob([JSON.stringify(serializableConfig(), null, 2)], { type: "application/json" });
+    const url = URL.createObjectURL(blob);
+    const anchor = document.createElement("a");
+    anchor.href = url;
+    anchor.download = `${config.mode}-parameters.json`;
+    document.body.append(anchor);
+    anchor.click();
+    anchor.remove();
+    URL.revokeObjectURL(url);
+    announce("参数 JSON 已导出");
+  }
+
+  async function copyParameters() {
+    try {
+      await navigator.clipboard.writeText(JSON.stringify(serializableConfig(), null, 2));
+      announce("参数 JSON 已复制");
+    } catch (_error) {
+      announce("当前环境无法访问剪贴板，请使用导出 JSON");
+    }
+  }
+
+  function announce(message) {
+    liveStatus.textContent = message;
+  }
+
+  function setPanel(open) {
+    panel.dataset.open = String(open);
+    panel.setAttribute("aria-hidden", String(!open));
+    panel.toggleAttribute("inert", !open);
+    panel.inert = !open;
+    panelToggle.setAttribute("aria-expanded", String(open));
+    if (open) panelClose.focus();
+  }
+
+  setPanel(panel.dataset.open === "true");
+  panelToggle.addEventListener("click", () => setPanel(panel.dataset.open !== "true"));
+  panelClose.addEventListener("click", () => {
+    setPanel(false);
+    panelToggle.focus();
+  });
+  exportButton.addEventListener("click", downloadParameters);
+  copyButton.addEventListener("click", copyParameters);
+
+  const isMobileViewport = () => window.matchMedia("(max-width: 760px)").matches;
+  let sidebarOpen = sidebar.dataset.open === "true";
+  function setSidebar(open) {
+    sidebarOpen = Boolean(open);
+    const mobile = isMobileViewport();
+    const visible = !mobile || sidebarOpen;
+    sidebar.dataset.open = String(visible);
+    sidebar.setAttribute("aria-hidden", String(!visible));
+    sidebar.toggleAttribute("inert", !visible);
+    sidebar.inert = !visible;
+    menuButton.setAttribute("aria-expanded", String(mobile && sidebarOpen));
+    menuButton.setAttribute("aria-label", visible ? "关闭导航菜单" : "打开导航菜单");
+  }
+  setSidebar(sidebarOpen);
+  window.addEventListener("resize", () => setSidebar(sidebarOpen), { passive: true });
+
+  const motionPreference = window.matchMedia("(prefers-reduced-motion: reduce)");
+  let motionPausedByUser = false;
+  let motionEnabled = false;
+  function applyMotion(announceChange = false) {
+    motionEnabled = !motionPreference.matches && !motionPausedByUser;
+    const enabled = motionEnabled;
+    field.setMotion(enabled);
+    motionButton.setAttribute("aria-pressed", String(!enabled));
+    motionButton.disabled = motionPreference.matches;
+    motionButton.querySelector("span").textContent = motionPreference.matches
+      ? "系统减少动态"
+      : enabled ? "暂停环境" : "恢复环境";
+    if (announceChange) {
+      announce(motionPreference.matches
+        ? "已遵循系统减少动态偏好"
+        : enabled ? "环境动画已恢复" : "环境动画已暂停");
+    }
+  }
+  motionButton.addEventListener("click", () => {
+    motionPausedByUser = motionEnabled;
+    applyMotion(true);
+  });
+  motionPreference.addEventListener("change", () => applyMotion(true));
+  applyMotion();
+
+  menuButton.addEventListener("click", () => {
+    setSidebar(!sidebarOpen);
+  });
+
+  document.querySelectorAll(".nav-item").forEach((button) => {
+    button.addEventListener("click", () => {
+      document.querySelectorAll(".nav-item").forEach((item) => item.removeAttribute("aria-current"));
+      button.setAttribute("aria-current", "page");
+      document.querySelector("#page-location").textContent = button.dataset.location;
+      if (isMobileViewport()) setSidebar(false);
+    });
+  });
+
+  document.querySelectorAll(".record-row").forEach((row) => {
+    row.addEventListener("click", () => {
+      document.querySelectorAll(".record-row").forEach((item) => item.removeAttribute("aria-selected"));
+      row.setAttribute("aria-selected", "true");
+      document.querySelector("#record-title").textContent = row.dataset.title;
+      document.querySelector("#record-time").textContent = row.dataset.time;
+      announce(`已选择 ${row.dataset.title}`);
+    });
+  });
+
+  const tabs = Array.from(document.querySelectorAll("[role='tab']"));
+  function activateTab(tab, focus = false) {
+    tabs.forEach((item) => {
+      const selected = item === tab;
+      item.setAttribute("aria-selected", String(selected));
+      item.tabIndex = selected ? 0 : -1;
+    });
+    document.querySelector("#detail-copy").textContent = tab.dataset.copy;
+    if (focus) tab.focus();
+  }
+  tabs.forEach((tab, index) => {
+    tab.addEventListener("click", () => {
+      activateTab(tab);
+    });
+    tab.addEventListener("keydown", (event) => {
+      let targetIndex = null;
+      if (event.key === "ArrowRight") targetIndex = (index + 1) % tabs.length;
+      if (event.key === "ArrowLeft") targetIndex = (index - 1 + tabs.length) % tabs.length;
+      if (event.key === "Home") targetIndex = 0;
+      if (event.key === "End") targetIndex = tabs.length - 1;
+      if (targetIndex === null) return;
+      event.preventDefault();
+      activateTab(tabs[targetIndex], true);
+    });
+  });
+  const selectedTab = tabs.find((tab) => tab.getAttribute("aria-selected") === "true") || tabs[0];
+  if (selectedTab) activateTab(selectedTab);
+
+  document.querySelector("#reset-parameters").addEventListener("click", () => {
+    Object.assign(config, JSON.parse(JSON.stringify(defaultConfig)));
+    renderControls();
+    field.updateConfig(config);
+    announce("参数已恢复为模板预设");
+  });
+
+  document.addEventListener("keydown", (event) => {
+    if (event.key === "Escape" && panel.dataset.open === "true") {
+      setPanel(false);
+      panelToggle.focus();
+    }
+  });
+
+  applyThemeMetadata();
+  renderControls();
+})();

package/bundled-skills/liuguang-banlan-ui/references/style-contract.md

@@ -0,0 +1,53 @@
+# 风格契约
+
+## 共通原则
+
+- 把色场当作环境现象，不把它当成组件皮肤或装饰贴纸。
+- 先建立稳定的信息层级：导航、列表/队列、详情、元数据、状态带。
+- 让颜色跨越整个场景，但保持文字、边界、按钮和选择态可读。
+- 用 OKLCH 编写颜色；为降级路径保留 sRGB 值。
+- 使用连续的 fBm/domain-warp、流带或方向性流域。禁止明显的圆形光斑、中心聚光和硬彩虹条。
+- 维持静、薄、净、密、活的工作台气质：表面轻、信息密、状态清楚、背景有生命但不抢语义。
+
+## 流光溢彩白 / `opal`
+
+定位：白色是第一视觉，色彩像被光照亮的珠光薄层，能看到变化但不破坏“白”。
+
+| 参数 | 建议范围 | 作用 |
+|---|---:|---|
+| `overallColorIntensity` | 0.60–0.90 | 控制全局彩色预算，默认约 0.82 |
+| `base.oklch.l` | 0.975–0.990 | 保留白色基材身份 |
+| `base.oklch.c` | 0.002–0.008 | 只给基材轻微方向，不制造灰雾 |
+| 颜色 `oklch.l` | 0.90–0.96 | 让色彩保持浅、薄、透 |
+| 颜色 `oklch.c` | 0.030–0.065 | 足够识别，但避免糖果霓虹 |
+| `peakOpacity` | 0.055–0.110 | 决定局部峰值，先调它再调总体 |
+| `field.warpStrength` | 0.22–0.42 | 让颜色互相流动而非分块 |
+| `field.luminanceCap` | 0.94–1.00 | 白场通常不需强行压暗 |
+
+建议使用玫瑰、海玻璃青、丁香、珠杏、薄荷和远空蓝等低饱和色相。至少让三种色相在同一截图中可辨，不要让整张图退化为普通暖白、灰雾或单一冷白。
+
+## 五彩斑斓黑 / `obsidian`
+
+定位：黑色是基材，彩色是沉在黑里的光谱现象；多色可见，但亮度必须受控。
+
+| 参数 | 建议范围 | 作用 |
+|---|---:|---|
+| `overallColorIntensity` | 0.80–1.00 | 允许色相进入暗场，默认约 1.00 |
+| `base.oklch.l` | 0.070–0.130 | 保留黑色基材身份 |
+| `base.oklch.c` | 0.006–0.018 | 只给黑底轻微冷向 |
+| 颜色 `oklch.l` | 0.18–0.34 | 控制暗彩的可见层级 |
+| 颜色 `oklch.c` | 0.035–0.075 | 使色相可辨但不变霓虹 |
+| `peakOpacity` | 0.14–0.32 | 暗场中色彩的局部峰值 |
+| `field.warpStrength` | 0.30–0.50 | 形成连续暗流 |
+| `field.luminanceCap` | 0.12–0.19 | 防止黑版被抬成灰版 |
+
+建议覆盖深潮青、石油蓝绿、海军蓝、暗靛、紫影和氧化暗金。确保至少五种色相在校准截图中有测得覆盖；不要只剩青黑、死黑或一圈彩色边。
+
+## 参数解释
+
+- `intensity`：该色相参与场的权重，必须可被滑杆实时改变。
+- `peakOpacity`：该色相的局部峰值预算；不要把它误写成整个页面透明度。
+- `fieldScale`：该色相的空间频率；不同值能避免所有颜色同相叠加。
+- `phase`：确定性相位，长度为 2 的数组；同一 seed 下保持稳定。
+- `measuredCoverage`：截图中超过基材色度阈值、并归属该色相的像素占比。
+- `effectiveShare`：可见色度能量中该色相的相对份额；这是近似归属，不是 shader 内部精确贡献。

package/bundled-skills/liuguang-banlan-ui/references/verification.md

@@ -0,0 +1,70 @@
+# 验证契约
+
+## 能力门槛
+
+先确认执行模型是否具备原生视觉能力：让模型直接查看一张生成的页面截图，并确认它能描述布局、色场、文字可读性和明显缺陷。只有这一步通过，才可把 `visualVerificationMode` 记为 `native-vision-plus-deterministic-pixel-metrics`。
+
+若执行模型不能查看图片：
+
+- 仍可运行语法、DOM、浏览器交互和像素统计；
+- 把 `modelVision` 或 `visualVerificationMode` 标记为不可用/`visual-unverified`；
+- 不得把截图尺寸、CSS 值或 DOM 状态当作视觉质量证明；
+- 把需要人眼确认的项目明确列入未验证清单。
+
+## 浏览器检查
+
+用真实浏览器生成至少两种视口：桌面（建议 1440×960）和窄屏（建议 390×844）。至少检查：
+
+1. 页面初始渲染与 WebGL/CSS fallback 状态；
+2. 参数面板打开、关闭、Escape 返回焦点；
+3. 总体彩色强度和每个颜色滑杆实时改变画面与数值；
+4. 恢复预设、导出 JSON、复制失败时的可用提示；
+5. 导航、记录选择、标签切换、移动端导航收起；
+6. 控制台错误/警告和本地静态资源请求；
+7. reduced-motion 与页面隐藏时暂停/冻结行为。
+
+截图必须直接看过才能产生审美结论。重点检查：白版是否仍以白为主、黑版是否仍以黑为底、六色是否形成连续流域、文字是否可读，以及是否出现圆形大光斑、RGB 霓虹、灰雾、黑压死或全页玻璃。
+
+## 像素检查
+
+用 `scripts/measure_preview.py` 测量纯色场截图，而不是只测被面板遮挡的完整页面。脚本会：
+
+- 读取 JS manifest 中的 base 与 palette；
+- 将截图转换到 OKLab；
+- 以“高于基材色度阈值”的像素作为可见色；
+- 将可见像素分配给最近的配置色相；
+- 输出可见色像素比例、OKLab chroma、亮度均值/P95/最大值、每色覆盖率和有效色度份额。
+
+低色度白场的色相归属只能作为近似统计，不能替代视觉检查。黑版必须同时检查最大亮度不超过 manifest 的 `luminanceCap` 意图；不要把截图中的 sRGB 值直接当成线性亮度。
+
+## 报告结构
+
+最终报告至少输出：
+
+```json
+{
+  "validationCapabilities": {
+    "modelVision": true,
+    "screenshotCapture": true,
+    "deterministicPixelMetrics": true,
+    "visualVerificationMode": "native-vision-plus-deterministic-pixel-metrics"
+  },
+  "theme": {
+    "overallColorIntensity": 0.82,
+    "colors": [
+      {
+        "id": "cyan",
+        "intensity": 0.62,
+        "oklch": [0.928, 0.043, 201],
+        "peakOpacity": 0.078,
+        "fieldScale": 0.94,
+        "phase": [0.78, 0.21],
+        "measuredCoverage": 0.1499,
+        "effectiveShare": 0.227
+      }
+    ]
+  }
+}
+```
+
+把“配置参数”和“截图实测”分开写。若某一项没有真实测量，使用 `null` 或 `unverified`，不要填一个看起来完整但无法复现的数字。

package/bundled-skills/liuguang-banlan-ui/scripts/measure_preview.py

@@ -0,0 +1,144 @@
+#!/usr/bin/env python3
+"""Measure a rendered spectral field against its parameter manifest."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import pathlib
+import subprocess
+import sys
+
+try:
+    import numpy as np
+    from PIL import Image
+except ModuleNotFoundError as exc:
+    package = {"PIL": "Pillow"}.get(exc.name, exc.name)
+    requirements = pathlib.Path(__file__).with_name("requirements.txt")
+    print(
+        json.dumps(
+            {
+                "status": "unavailable",
+                "reason": f"Optional measurement dependency is missing: {package}",
+                "install": f"python -m pip install -r {requirements}",
+            },
+            ensure_ascii=False,
+        ),
+        file=sys.stderr,
+    )
+    raise SystemExit(2)
+
+
+def load_config(path: pathlib.Path) -> dict:
+    source = (
+        "global.window={};require(require('path').resolve(process.argv[1]));"
+        "process.stdout.write(JSON.stringify(window.SPECTRAL_THEME));"
+    )
+    result = subprocess.run(
+        ["node", "-e", source, str(path)],
+        check=True,
+        capture_output=True,
+        text=True,
+        encoding="utf-8",
+    )
+    return json.loads(result.stdout)
+
+
+def srgb_to_oklab(rgb: np.ndarray) -> tuple[np.ndarray, np.ndarray]:
+    linear = np.where(
+        rgb <= 0.04045,
+        rgb / 12.92,
+        ((rgb + 0.055) / 1.055) ** 2.4,
+    )
+    r, g, b = np.moveaxis(linear, -1, 0)
+    l = np.cbrt(0.4122214708 * r + 0.5363325363 * g + 0.0514459929 * b)
+    m = np.cbrt(0.2119034982 * r + 0.6806995451 * g + 0.1073969566 * b)
+    s = np.cbrt(0.0883024619 * r + 0.2817188376 * g + 0.6299787005 * b)
+    lab = np.stack(
+        (
+            0.2104542553 * l + 0.7936177850 * m - 0.0040720468 * s,
+            1.9779984951 * l - 2.4285922050 * m + 0.4505937099 * s,
+            0.0259040371 * l + 0.7827717662 * m - 0.8086757660 * s,
+        ),
+        axis=-1,
+    )
+    luminance = 0.2126 * r + 0.7152 * g + 0.0722 * b
+    return lab, luminance
+
+
+def circular_distance(a: np.ndarray, b: float) -> np.ndarray:
+    delta = np.abs(a - b)
+    return np.minimum(delta, 360.0 - delta)
+
+
+def measure(image_path: pathlib.Path, config: dict) -> dict:
+    image = Image.open(image_path).convert("RGB")
+    pixels = np.asarray(image, dtype=np.float32) / 255.0
+    lab, luminance = srgb_to_oklab(pixels)
+    chroma = np.hypot(lab[..., 1], lab[..., 2])
+    hue = (np.degrees(np.arctan2(lab[..., 2], lab[..., 1])) + 360.0) % 360.0
+
+    base_chroma = float(config["base"]["oklch"]["c"])
+    threshold = base_chroma + (0.003 if config["mode"] == "opal" else 0.004)
+    chroma_energy = np.maximum(chroma - threshold, 0.0)
+    visible = chroma_energy > 0
+
+    distances = np.stack(
+        [circular_distance(hue, float(color["oklch"]["h"])) for color in config["colors"]],
+        axis=-1,
+    )
+    assignments = np.argmin(distances, axis=-1)
+    total_pixels = pixels.shape[0] * pixels.shape[1]
+    total_energy = float(chroma_energy.sum())
+    colors = []
+    for index, color in enumerate(config["colors"]):
+        assigned = visible & (assignments == index)
+        energy = float(chroma_energy[assigned].sum())
+        colors.append(
+            {
+                "id": color["id"],
+                "label": color["label"],
+                "configuredIntensity": color["intensity"],
+                "oklch": color["oklch"],
+                "peakOpacity": color["peakOpacity"],
+                "measuredCoverage": round(float(assigned.sum()) / total_pixels, 4),
+                "effectiveShare": round(energy / total_energy, 4) if total_energy else 0.0,
+            }
+        )
+
+    return {
+        "image": image_path.name,
+        "dimensions": {"width": image.width, "height": image.height},
+        "method": "nearest configured OKLCH hue over pixels above the base-chroma visibility threshold",
+        "visibilityThresholdChroma": round(threshold, 4),
+        "chromaticPixelRatio": round(float(visible.mean()), 4),
+        "meanOklabChroma": round(float(chroma.mean()), 5),
+        "luminance": {
+            "mean": round(float(luminance.mean()), 5),
+            "p05": round(float(np.percentile(luminance, 5)), 5),
+            "p95": round(float(np.percentile(luminance, 95)), 5),
+            "max": round(float(luminance.max()), 5),
+            "configuredCap": config["field"]["luminanceCap"],
+        },
+        "colors": colors,
+    }
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser()
+    parser.add_argument("--image", required=True, type=pathlib.Path)
+    parser.add_argument("--config", required=True, type=pathlib.Path)
+    args = parser.parse_args()
+    config = load_config(args.config.resolve())
+    payload = {
+        "schemaVersion": "1.0",
+        "theme": config["label"],
+        "preset": config["preset"],
+        "overallColorIntensity": config["overallColorIntensity"],
+        "measurement": measure(args.image.resolve(), config),
+    }
+    print(json.dumps(payload, ensure_ascii=False, indent=2))
+
+
+if __name__ == "__main__":
+    main()

package/bundled-skills/liuguang-banlan-ui/scripts/requirements.txt

@@ -0,0 +1,2 @@
+numpy>=1.24,<3
+Pillow>=10,<13

package/bundled-skills/liuguang-banlan-ui/scripts/scaffold_template.py

@@ -0,0 +1,43 @@
+#!/usr/bin/env python3
+"""Copy the bundled neutral workbench starter into a new output directory."""
+
+from __future__ import annotations
+
+import argparse
+import pathlib
+import shutil
+
+
+def copy_tree(source: pathlib.Path, target: pathlib.Path) -> None:
+    shutil.copytree(source, target, dirs_exist_ok=True)
+
+
+def scaffold(skill_root: pathlib.Path, output: pathlib.Path, variant: str) -> None:
+    starter = skill_root / "assets" / "starter"
+    if output.exists():
+        raise SystemExit(f"Refusing to overwrite existing output: {output}")
+    output.mkdir(parents=True)
+
+    if variant == "both":
+        copy_tree(starter, output)
+        return
+
+    (output / "shared").mkdir()
+    copy_tree(starter / "shared", output / "shared")
+    shutil.copy2(starter / "favicon.svg", output / "favicon.svg")
+    copy_tree(starter / variant, output)
+    index = output / "index.html"
+    index.write_text(index.read_text(encoding="utf-8").replace("../", "./"), encoding="utf-8")
+
+
+def main() -> None:
+    parser = argparse.ArgumentParser(description="Scaffold the two-mode spectral UI starter")
+    parser.add_argument("--output", required=True, type=pathlib.Path)
+    parser.add_argument("--variant", choices=("opal", "obsidian", "both"), default="both")
+    args = parser.parse_args()
+    scaffold(pathlib.Path(__file__).resolve().parents[1], args.output.resolve(), args.variant)
+    print(f"scaffolded {args.variant} -> {args.output.resolve()}")
+
+
+if __name__ == "__main__":
+    main()