ブランド素材の多テーマ PNGをトークン更新ごとに再現する手順。OpenClaw の Mac 導入・Gateway、監視／タスク起動、token JSON 一括レンダー、しきい値 diff・レポート、エラーとリトライをチュートリアル＋チェックリスト化。
目次
多テーマ PNG で起きがちな課題
手作業ではプレビュー漏れ・端末差・差分レビュー不足が起きやすいです。インストールガイドに沿いリモート Macで Gateway とレンダーを固定してください。
トリガー比較
| トリガー | 向いている用途 | 注意点 |
|---|---|---|
| 監視＋デバウンス | tokens.json や SVG を inbox/ に置く |
パス権限を固定し、自動保存連打で多重起動しないよう間隔を空ける |
| cron / launchd | 夜間リグレッション | 未変更でも走るので git ハッシュ等でゲート推奨 |
| 手動スキル | リリース直前・承認前 | SSH での実行に依存 |
大量セットは 監視フォルダ（PNG セット）のロック・バッチログを流用。
パイプラインの再現手順
- SSH／VNC で接続し
tokens|templates|out|logsを作成。 - OpenClaw 導入・Gateway ヘルス・API がプロジェクト読取可を確認。
- スキルにテーマ・寸法・命名・ベースライン path を渡す。
tokens/デバウンス監視または CI／launchd 起動。- テーマ注入・固定 DPR で PNG 出力→ベースラインと比較、NG 時のみヒートマップ。
report.md／summary.jsonをチケット等へ。
token JSON とレンダーループ
1 ライン 1 マニフェスト。themes[] に id・colors・radius・任意 font・template。スキーマ検証後にレンダー。DPR／背景固定・必要なら sRGB ICC。小文字スラグ命名。M4 は 12〜48 テーマから負荷測定。
しきい値比較とレポート出力
compare でスコア＋ヒートマップ。正規化後変更画素 <1%・RMSE 上限を目安に。行でテーマ・指標・合否・hash。PNG 一括 QA とサイズ／アルファを統一。
エラーとリトライ
| 症状 | 想定原因 | リトライの型 |
|---|---|---|
| 502／timeout | コールドスタート・ポート競合 | 2→4→8s バックオフ、3 回で Gateway 再起動を検討 |
| Permission denied | ユーザー／ACL | whoami で揃えて再実行 |
| 白画面・色ズレ | フォント・P3/sRGB | フォント導入・プロファイル明示で再レンダー |
| diff 常時 NG | AA ノイズ・解像度差 | 正規化・軽 fuzz・しきい値再較正 |
logs/runs.jsonl に時刻・sha・合否を記録。
事前チェックリスト
- Gateway OK・バージョン固定・token スキーマ／テンプレ path 実在
- out／logs が SSH ユーザーで書込可、ベースライン＋しきい値が文書化済み
- 監視デバウンス＋ロックで多重起動なし、レポートがチケット等にリンク
FAQ
token JSON に最低限は？
id・意味色・角丸・タイポ。パスはルート相対で統一。
しきい値の初値は？
変更画素 0.5〜1.0%。良品で RMSE 較正。
リモート Mac の利点は？
OS・フォント・色管理と Gateway を固定できる。