skills/note-studio/references/image-production.md

# 画像制作の基準

2026-08-18確認時点のnote公式ヘルプでは、見出し画像の推奨寸法は1280×670px。画像生成機能が任意寸法を直接返せない場合があるため、生成と最終寸法の検査を分ける。

## 共通手順

1. 文章とタイトルを確定してから画像を作る。
2. 一回の呼び出しで一画像だけ生成する。
3. 見出し画像では[デザイン選択](thumbnail-design-system.md)を使って一方向へ決め、画像の目的、主役、場面、デザイン構造、表現、正確な文字、禁止事項を短く具体化する。
4. 生成後に実寸と見た目を確認する。
5. 修正は一度に一要素へ絞る。
6. 利用者のローカル保存先へ書き込める場合は、完成版をデスクトップの専用フォルダへ保存する。

画像生成には組み込みの`imagegen`を優先する。利用者へAPIキーを求めない。画像の生成元と完成版を混同せず、記事用の完成ファイルは分かる名前で保存する。

## 見出し画像

目標寸法は1280×670px。note公式の推奨寸法であり、単なる16:9ではない。

本文と確定タイトルから、[デザイン選択](thumbnail-design-system.md)に従って異なる三方向を内部比較し、一方向だけを採用する。利用者へ方式を選ばせず、画像生成へ候補一覧や採点基準を渡さない。採用した方向を次へ圧縮する。

```text
用途: 日本語のnote記事一覧で使う見出し画像
記事固有のフック: 本文と選択タイトルにしかない読む理由を一文
主役と場面: フックを最も具体的に見せる人物、物、瞬間、関係、順序
デザイン構造: 主役、文字、余白、視線の流れをどう関係づけるか
表現: 記事の感情の温度に合う写真、編集イラスト、手描き、抽象表現などと色・質感
文字: 「正確な短いコピー」だけを一度、読みやすい日本語で表示。必要なら同じcopy内で大小や改行による二段階までの強弱をつける
文字サイズ: 最終1280×670pxで、意味の核となる一語または一行は見た目の文字高64px相当以上。理解に必要な補助部分は48px相当以上
一覧表示: 実際に約320×168pxで表示しても、意味の核を拡大や凝視なしで一目で読める
禁止: 余計な文字、ロゴ、透かし、本文より強い約束、無関係な煽り
目標寸法: 1280×670px
```

コピーは8〜16文字を目安にする。タイトル全文の縮小版にせず、タイトルと同じ読む理由を短く表す。意味として一つにし、独立した見出し、補足文、badgeを足さない。文字の誤りがあれば完成扱いにしない。

`64px相当`と`48px相当`はfont設定値ではなく、最終画像上で見える全角文字のおおよその高さを指す。全文を同じ大きさへ固定せず、意味の核を最上位の文字要素にする。収まらない時は文字を縮めず、コピーの短縮、改行、主役との比率または構図を変える。葉書、看板、画面等の物体へ文字を組み込む場合も同じ基準を適用し、物体ごと十分大きく見せる。文字高を満たしても、細すぎる字、弱いcontrast、複雑な背景で一目で読めなければ完成扱いにしない。

タイトルの読む理由が「AだがB」「A。でもB」「Aだけは別」のような対比や例外にある場合は、短いコピーにも両側を残す。前半の肯定だけ、または後半の注意だけへ縮めて、タイトルの中心を変えない。

## 差し絵

目標寸法は1280×720pxの16:9。本文中の一節を理解しやすくする補助画像として作る。

```text
用途: note記事の本文途中へ入れる差し絵
主役と場面: 指定した大見出しの内容を一目で補助する場面
表現: 記事全体のトーンと調和する
構図: 横長16:9。本文中で自然に見える一場面
文字: 原則なし。説明に不可欠な短いラベルだけ許可
禁止: 記事タイトル、見出し風コピー、ロゴ、透かし、複数案のコラージュ
目標寸法: 1280×720px
```

差し絵には、本文へ置くキャプションとALTを一つずつ付ける。見出し画像には付けない。

- キャプション: 画像と節の関係が自然に伝わる一文。見出しの言い換えや制作説明にしない。
- ALT: 見えている人物、物、動作、関係を80字以内の平文で説明する。記事タイトル、宣伝文、キーワードの羅列、URLを入れない。

## 利用者へ渡す保存先

利用者のローカル保存先へ書き込める場合は、完成画像を次へ保存する。

```text
デスクトップ/Note Studio/YYYY-MM-DD_記事名/
```

- 見出し画像は`見出し画像`、差し絵は`差し絵`から始まるfile名にする。
- 同名の異なる画像を上書きせず、再生成時は連番にする。
- 利用者が別の保存先を指定した場合は、その場所を優先する。
- note新規下書きへ直接登録する場合も初期設定では控えを残し、利用者が不要と明示した時だけ省略する。
- Plugin、repository、cache、一時作業場所を最終保存先として案内しない。

完成画像を保存する時は、記事タイトルをshell文字列へ直接展開せず、安全な引数として`save_note_asset.py`へ渡す。

見出し画像:

```bash
python3 scripts/save_note_asset.py note-thumbnail.png --article-title "確定タイトル" --kind thumbnail
```

差し絵:

```bash
python3 scripts/save_note_asset.py note-inline.png --article-title "確定タイトル" --kind inline
```

Webやモバイル等で利用者のローカル保存先へ書き込めない場合は、会話内へ完成画像を表示し、次だけを案内する。

```text
ローカル環境への保存はできなかったので、こちらの画像を保存して使ってください。
```

保存失敗の内部事情を長く説明しない。

## 寸法の正規化

画像生成が目標寸法を返さない場合、元画像を残して`prepare_note_image.py`で中央基準のcover切り抜きと縮小を行う。生成時から重要要素を中央の安全範囲へ置き、切り抜き後に文字や主役が欠けないようにする。

見出し画像:

```bash
python3 scripts/prepare_note_image.py SOURCE.png note-thumbnail.png --width 1280 --height 670
```

file処理が使える場合は、最終画像から一覧確認専用の画像を作る。

```bash
python3 scripts/prepare_note_image.py note-thumbnail.png note-thumbnail-preview.png --width 320 --height 168
```

確認用画像は納品物や最終保存先へ含めず、検査後に一時作業領域から削除する。file処理が使えない場合は利用可能な画像表示で同程度の小表示を確認し、正確な縮小確認を行ったと装わない。

差し絵:

```bash
python3 scripts/prepare_note_image.py SOURCE.png note-inline.png --width 1280 --height 720
```

スクリプトはPillow、ImageMagick、macOSのsips、ffmpegの順に利用可能な処理系を使う。どれもない場合は、正確な寸法へ整えたと装わない。

## 目視確認

- 記事の主題と一致している。
- 人物、手指、食べ物、道具、画面などに目立つ破綻がない。
- 日本語コピーが指定どおりで、余計な文字がない。
- 対比や例外がタイトルの中心なら、短いコピーにもその対比が残っている。
- 文字と主役が切れていない。
- 最終1280×670pxで、意味の核が見た目の文字高64px相当以上、理解に必要な補助部分が48px相当以上ある。
- 実際の約320×168px表示で、意味の核を拡大や凝視なしで一目で読める。「文字があると分かる」「時間をかければ判読できる」「元画像では読める」だけでは通さない。
- 小表示でも主役からcopyへ視線が自然につながり、強い色や別の要素がcopyから視線を奪い続けない。
- 同じ画像とlayoutを、同ジャンルの別記事へcopyだけ変えて流用しにくい。
- visualとcopyが別々の層ではなく、記事固有の意味を一緒に作っている。
- 目を引くが、本文にない煽りや安いclickbaitになっていない。
- 汎用的なAI画像に見える青紫発光、意味のない粒子、人型ロボット、過剰な3Dアイコンへ逃げていない。

中心的な問題があれば、直す要素を一つに絞って一度だけ再生成する。利用者へデザイン選択を尋ねず、比較sheetや候補画像を見せず、通過した完成画像一枚だけを返す。

## 参照

- note見出し画像の推奨サイズ: https://www.help-note.com/hc/ja/articles/360000231642
- note画像とタイトルのヒント: https://www.help-note.com/hc/ja/articles/360012426353
- OpenAI image generation: https://learn.chatgpt.com/docs/image-generation