デザイナー・フロント素材・自動化担当向け。リモート Mac の OpenClaw で フォルダ監視→バッチ PNG(1x/2x 等)と命名規範までを再現する HowTo です。導入は OpenClaw インストール、監視の基礎は フォルダ監視とリネーム を参照。
ディレクトリ構造と権限
パスと所有者の不一致は黙った失敗の原因です。監視前にツリーを固定します。
レイアウト例:inbox(書き出し・フォルダ監視対象)/staging(処理中・部分書き込みと分離)/out(マルチサイズ成果)/failed(failed.jsonl 付き)/logs(ローテ)。
権限チェック:① OpenClaw・fswatch・シェルを同一ユーザーに。② 設定は $HOME/... の絶対パス。③ touch で読書き確認。
監視タスクの設定
書き込み完了後の PNG のみ反応させる。OpenClaw 監視タスクはパス・*.png・1〜3 秒デバウンス。fswatch+ワーカーなら brew install fswatch、tmux/LaunchAgent で リモート Mac を常駐。
デプロイ:① インストール手順で版固定 ② INBOX 等を env/YAML で版管理 ③ PNG 1 枚でスモーク ④ launchd でログアウト後も継続。半端ファイル対策に .done またはサイズ不変の stat。詳細は 監視・リトライ・ログ HowTo。
マルチサイズテンプレート表
ソース 1 枚から命名規範付きセットへ。表は設定/CSV の雛形です。
| 役割 | 長辺/ボックス | ファイル名サフィックス | メモ |
|---|---|---|---|
| Web 1x | 幅 800px | _w800 |
マーケページのベースライン |
| Web 2x | 幅 1600px | _w1600 |
Retina。マスターと sRGB ICC を揃える |
| サムネ | 256×256 カバー | _thumb256 |
正方形クロップ方針はブランドごとに文書化 |
| OGP | 1200×630 | _og1200x630 |
デザインファイルでセーフマージンを確保 |
| ストーリー縦長 | 1080×1920 | _story1080x1920 |
キャンペーン命名は SNS バッチ実戦 も参照 |
命名テンプレ:{project}__{component}__{variant}_{token}.png(小文字・__ で階層)。メタは JSON/親フォルダから取得し バッチ PNG の衝突を避ける。sips -Z 等でリサイズ後、寸法が期待と違えばジョブ失敗に。
ログと失敗時のリトライ
データ欠損は退避、一時障害は失敗リトライ。
- ログ:
job_id等を 1 行 JSON。日次ローテ。 - 分類:破損→
failed.jsonl。満杯/timeout→指数バックオフ(例 3 回)。総リトライ上限でループ防止。 - QA:PNG 一括 QA を
staging→outの前に。manifest で差分管理。
デザイン納品との接続
out/+manifest.json でバリアントと色空間メモを列挙し、色彩管理チェックリスト と整合。混在フォーマットは WebP/AVIF/PNG 納品 とリンク。inbox パス・命名チート・SLA を文書化。関連:自動命名と検証、素材パイプライン。
排障 FAQ
Q. 監視が二重発火。 A. デバウンス延長・隠しファイル無視・一時 .png~ の回避。
Q. ぼけ/色ズレ。 A. マスタープロファイル固定。sRGB/P3 と照合。
Q. Permission denied。 A. LaunchAgent ユーザーと SSH ユーザーを一致。plist は $HOME。
Q. ディスク不足。 A. バリアント合算で容量見積り、しきい値とアーカイブ方針を決める。
Q. API 経由で一括。 A. API バッチ実戦。命名テンプレは監視パイプと共通化。