← ClaudeAtlas

column-image-uploadlisted

コラム記事(`apps/www/src/content/posts/column/`)に相対パスで貼られたローカル画像を R2 バケット `weekly-assets` にアップロードし、記事内の参照を `https://assets.claude-code-log.com/` を指す `<img>` に書き換えて、ローカルの画像ファイルを削除する。`/column-image-upload` の実行時、または「コラムの画像を R2 に上げて」「記事の画像を公開 URL に差し替えて」「画像を貼ったコラムを公開できる状態にして」等の依頼時に使う。週次アップデート記事(`apps/www/src/content/posts/weekly/`)の画像は管理画面からアップロード済みなので対象外。`public/` 配下の静的画像・OGP 画像の差し替えや、記事の執筆・推敲そのものにも使わない。macOS 専用(`sips` に依存する)。
Suntory-N-Water/claude-code-changelog-viewer · ★ 0 · AI & Automation · score 59
Install: claude install-skill Suntory-N-Water/claude-code-changelog-viewer
# コラム記事の本文画像を R2 にアップロードする 執筆中はローカルの画像ファイルを相対パスで貼り、公開前にこのスキルで R2 へ移す。 Astro は Markdown 内の相対パス画像をビルド時に最適化しようとするため、貼ったままだと `pnpm run build` が Sharp 不足で失敗する。書き換えて初めてビルドが通る。 **アップロードを全件終えてから記事を書き換える。** 1枚ずつ書き換えると途中で失敗したときに記事が壊れる。手順4と手順5を混ぜない。 ## 手順 ### 1. 対象記事を確定する `$ARGUMENTS` を確認して記事の `.md` パスを1つに確定する。 - `.md` パスが渡された → それを使う - slug が渡された → `apps/www/src/content/posts/column/` 配下から frontmatter の `slug` が一致する記事を探す - 空 → `apps/www/src/content/posts/column/*.md` を Grep して `![...](...)` のローカル画像参照を含む記事を探す。1件ならそれを使い、複数あればどれを対象にするかユーザーに確認して止まる R2 のキーには**ファイル名ではなく frontmatter の `slug`** が入る(記事の URL がそれで決まるため)。 ### 2. ローカル画像を検出する ```bash mkdir -p .tmp python3 <skill_dir>/scripts/scan.py <記事パス> > .tmp/column-images.json ``` 記事内の `![alt](パス)` を走査し、ローカル画像だけをマニフェストに書き出す。`http(s)://` 始まり(アップロード済み)と `/` 始まり(`public/` 配下)は除外されるので、**書き足して再実行しても既存の画像は再アップロードされない**。 マジックバイトで PNG / JPEG / WebP を判定し、`sips` で寸法を取り、R2 キーと公開 URL をここで確定する。 `images` が空だった場合は、書き換える画像がないことをユーザーに伝えて終了する。以降の手順は実行しない。 ### 3. alt を埋める マニフェストの各 `file` を Read して画像を見て、`alt` が空の項目を Edit で埋める。**編集してよいのは `alt` だけ**で、`key` / `url` / `start` / `end` / `width` / `height` には触らない(手順5の位置照合と CLS 対策がここで確定している)。 - 画像に何が写っているかを日本語で書く。スクリーンショットなら、どの画面のどの状態かが伝わるようにする - 本文で既に説明されている内容をそのまま繰り返さない - 「画像」「スクリーンショット」「〜の図」で始めない(スクリーンリーダーが二重に読み上げる) - 20〜60字を目安にする - 執筆者が `![...]` に既に alt を書いていた場合は、その意図を尊重してそのまま残す ### 4. R2 にアップロードする ```bash python3 <skill_dir>/scripts/upload.py .tmp/column-images.json ``` バケット `weekly-assets` に全件アップ