claude-org-ja: Skill for Claude Code

WSL から Windows Chrome で画面を撮る

Linux 側の Chrome は共有ライブラリ不足で起動しない環境なので、Windows 版 Chrome を headless で使う。以下は繰り返し踏んだ手順を固定したもの（経緯と出典は .claude/skills/wsl-windows-chrome-screenshot/references/rationale.md）。 どの失敗もエラーが原因を指さず、PNG が「撮れてしまう」ことが多い。

0. sandbox を外す撮影の実行は窓口が行う

§1 の dangerouslyDisableSandbox: true の呼び出しは、auto mode のワーカーでは分類器に [Safety Bypass Flag] で拒否される（sandbox 内で Chrome を 1 回起動する probe も拒否）。 同じスクリプトは窓口が流して撮れている。よって役割を分ける。

• ワーカー: サーバ起動・撮影・停止を 1 本にまとめた撮影スクリプトを .worker-scratch/ に用意し、sandbox 内でプレビューが起動する（curl が 200）ことまで確かめ、 そのまま流せる 1 行のコマンドを窓口への報告に書く。sandbox 解除は自分で要求しない。 1 回でも拒否されたら再要求しない（繰り返すとロックアウトされる）。
• 窓口: スクリプトを読んでから sandbox 外で 1 回だけ流し、撮れた PNG が Chrome の 接続拒否画面（§2）でないことを確かめて、merge gate のページに載せる。

1. サーバ起動と撮影は 1 つの Bash 呼び出しに入れ、その呼び出しだけ sandbox を外す

sandbox は Bash 呼び出しごとに PID / network 名前空間を分けるため、

• 別呼び出しで起こしたサーバはその呼び出しの終了と同時に死ぬ（setsid しても畳まれる。 run_in_background: true なら生きるが、次の呼び出しの curl からも Windows Chrome からも届かない）
• Chrome 側も sandbox 内から叩くと <3>WSL (N - ) ERROR: UtilConnectUnix:526: socket failed 1 だけを出して PNG を 1 バイトも書かない（WSL interop の unix socket が bwrap に塞がれる。 エラー終了はしない）

よってサーバ起動・ヘルスチェック・撮影・停止をまとめた 1 呼び出しを dangerouslyDisableSandbox: true で流す。build / verify / git は sandbox 内のままでよい。

CHROME="/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
SHOTS="$PWD/.worker-scratch/shots"; mkdir -p "$SHOTS"
UNC="$(wslpath -w "$SHOTS")"   # Windows の Chrome に渡す \\wsl.localhost\... 形式の保存先
PORT=7361

shoot() {  # shoot <name> <scheme 0=dark|1=light> <url>
  "$CHROME" --headless=new --disable-gpu --hide-scrollbars \
    --blink-settings=preferredColorScheme=$2 --window-size=2560,1440 \
    --virtual-time-budget=4000 --screenshot="$UNC\\$1.png" "$3"
}

node .worker-scratch/preview-$PORT.mjs > .worker-scratch/preview.log 2>&1 &
SRV=$!
for i in $(seq 1 20); do curl -fsS -o /dev/null "http://127.0.0.1:$PORT/?lang=en" && break; sleep 1; done
shoot warmup   1 "http://127.0.0.1:$PORT/?lang=en"   # 捨て撮り（§2）
shoot after-en 1 "http://127.0.0.1:$PORT/?lang=en"
shoot after-ja 1 "http://127.0.0.1:$PORT/?lang=ja"
kill $SRV
tail -5 .worker-scratch/preview.log