column-image-uploadlisted
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
```
記事内の `` を走査し、ローカル画像だけをマニフェストに書き出す。`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` に全件アップ