tuzi-cover-image

カバー画像ジェネレーター

5 つのディメンションをカスタマイズして、洗練された記事のカバー画像を生成します。

使い方

# Auto-select dimensions based on content
/tuzi-cover-image path/to/article.md

# Quick mode: skip confirmation
/tuzi-cover-image article.md --quick

# Specify dimensions
/tuzi-cover-image article.md --type conceptual --palette warm --rendering flat-vector

# Style presets (shorthand for palette + rendering)
/tuzi-cover-image article.md --style blueprint

# With reference images
/tuzi-cover-image article.md --ref style-ref.png

# Direct content input
/tuzi-cover-image --palette mono --aspect 1:1 --quick
[paste content]

オプション

オプション	説明
--type <name>	hero、conceptual、typography、metaphor、scene、minimal
--palette <name>	warm、elegant、cool、dark、earth、vivid、pastel、mono、retro
--rendering <name>	flat-vector、hand-drawn、painterly、digital、pixel、chalk
--style <name>	プリセットの簡略名（スタイルプリセットを参照）
--text <level>	none、title-only、title-subtitle、text-rich
--mood <level>	subtle、balanced、bold
--font <name>	clean、handwritten、serif、display
--aspect <ratio>	16:9（デフォルト）、2.35:1、4:3、3:2、1:1、3:4
--lang <code>	タイトルの言語（en、zh、ja など）
--no-title	--text none の別名
--quick	確認を省略し、自動選択を使用
--ref <files...>	スタイルや構図の参考にする画像

5 つのディメンション

ディメンション	値	デフォルト
タイプ	hero、conceptual、typography、metaphor、scene、minimal	auto
パレット	warm、elegant、cool、dark、earth、vivid、pastel、mono、retro	auto
レンダリング	flat-vector、hand-drawn、painterly、digital、pixel、chalk	auto
テキスト	none、title-only、title-subtitle、text-rich	title-only
ムード	subtle、balanced、bold	balanced
フォント	clean、handwritten、serif、display	clean

自動選択のルール：references/auto-selection.md

ギャラリー

タイプ：hero、conceptual、typography、metaphor、scene、minimal → 詳細：references/types.md

パレット：warm、elegant、cool、dark、earth、vivid、pastel、mono、retro → 詳細：references/palettes/

レンダリング：flat-vector、hand-drawn、painterly、digital、pixel、chalk → 詳細：references/renderings/

テキストレベル：none（ビジュアルのみ） | title-only（デフォルト） | title-subtitle | text-rich（タグ付き） → 詳細：references/dimensions/text.md

ムードレベル：subtle（低コントラスト） | balanced（デフォルト） | bold（高コントラスト） → 詳細：references/dimensions/mood.md

フォント：clean（サンセリフ） | handwritten | serif | display（太字の装飾書体） → 詳細：references/dimensions/font.md

ファイル構成

default_output_dir の設定に応じた出力ディレクトリ：

• same-dir：{article-dir}/
• imgs-subdir：{article-dir}/imgs/
• independent（デフォルト）：cover-image/{topic-slug}/

<output-dir>/
├── source-{slug}.{ext}    # Source files
├── refs/                  # Reference images (if provided)
│   ├── ref-01-{slug}.{ext}
│   └── ref-01-{slug}.md   # Description file
├── prompts/cover.md       # Generation prompt
└── cover.png              # Output image

スラッグ：2～4 語、kebab-case。競合する場合：-YYYYMMDD-HHMMSS を追加

ワークフロー

進捗チェックリスト

Cover Image Progress:
- [ ] Step 0: Check preferences (EXTEND.md) ⛔ BLOCKING
- [ ] Step 1: Analyze content + save refs + determine output dir
- [ ] Step 2: Confirm options (6 dimensions) ⚠️ unless --quick
- [ ] Step 3: Create prompt
- [ ] Step 4: Generate image
- [ ] Step 5: Completion report

フロー

Input → [Step 0: Preferences] ─┬─ Found → Continue
                               └─ Not found → First-Time Setup ⛔ BLOCKING → Save EXTEND.md → Continue
        ↓
Analyze + Save Refs → [Output Dir] → [Confirm: 6 Dimensions] → Prompt → Generate → Complete
                                              ↓
                                     (skip if --quick or all specified)

ステップ 0：設定を読み込む ⛔ BLOCKING

EXTEND.md の存在を確認します（優先順位：プロジェクト → ユーザー）。

test -f .tuzi-skills/tuzi-cover-image/EXTEND.md && echo "project"
test -f "$HOME/.tuzi-skills/tuzi-cover-image/EXTEND.md" && echo "user"

結果	アクション
見つかった	読み込み、概要を表示 → 続行
見つからない	⛔ 初回セットアップを実行（references/config/first-time-setup.md）→ 保存 → 続行

重要：見つからない場合は、ほかのステップや質問を行う前に、必ずセットアップを完了してください。

ステップ 1：コンテンツを分析する

1. 参考画像を保存する（提供されている場合）→ references/workflow/reference-images.md
2. ソースコンテンツを保存する（貼り付けられている場合は source.md に保存）
3. コンテンツを分析する：トピック、トーン、キーワード、視覚的なメタファー
4. 参考画像を詳細に分析する ⚠️：具体的で明確な要素を抽出します（reference-images.md を参照）
5. 言語を検出する：ソース、ユーザー入力、EXTEND.md の設定を比較します
6. 出力ディレクトリを決定する：ファイル構成のルールに従います

ステップ 2：オプションの確認 ⚠️

確認フローの詳細：references/workflow/confirm-options.md

条件	省略される項目	引き続き確認する項目
--quick または quick_mode: true	6 つの項目	アスペクト比（--aspect が指定されていない場合）
6 項目すべてと --aspect が指定されている	すべて	なし

ステップ 3：プロンプトの作成

prompts/cover.md に保存します。テンプレート：references/workflow/prompt-template.md

重要 — Frontmatter の参照情報：

• refs/ に保存したファイル → frontmatter の references リストに追加します
• スタイルを口頭で確認した場合（ファイルなし） → references は省略し、本文に記述します
• 書き込む前 → test -f refs/ref-NN-{slug}.{ext} で確認します

本文内の参照要素は、統合方法とともに「MUST」または「REQUIRED」を付けて詳しく記述する必要があります。

ステップ 4：画像の生成

1. 既存の cover.png を再生成する場合はバックアップします
2. 画像生成スキルを確認します。複数ある場合は、どれを使うか確認します
3. プロンプトの frontmatter にある参照情報を処理します：
   • direct の使用 → --ref で渡します（参照に対応したバックエンドを使用）
   • style／palette → 特性を抽出し、プロンプトに追加します
4. 生成：プロンプトファイル、出力パス、アスペクト比を指定してスキルを呼び出します
5. 失敗した場合：自動で 1 回再試行します

ステップ 5：完了レポート

Cover Generated!

Topic: [topic]
Type: [type] | Palette: [palette] | Rendering: [rendering]
Text: [text] | Mood: [mood] | Font: [font] | Aspect: [ratio]
Title: [title or "visual only"]
Language: [lang] | Watermark: [enabled/disabled]
References: [N images or "extracted style" or "none"]
Location: [directory path]

Files:
✓ source-{slug}.{ext}
✓ prompts/cover.md
✓ cover.png

画像の変更

操作	手順
再生成	バックアップ → プロンプトファイルを先に更新 → 再生成
項目の変更	バックアップ → 新しい値を確認 → プロンプトを更新 → 再生成

構図の原則

• 余白：40～60%の余裕を持たせます
• 視覚的な焦点：主要な要素を中央または左寄りに配置します
• キャラクター：簡略化したシルエットを使用します。リアルな人物は使用しません
• タイトル：ユーザーまたはソースにあるタイトルをそのまま使用します。新たに考案しないでください

拡張機能のサポート

EXTEND.md を使ってカスタム設定を行えます。パスについてはステップ 0を参照してください。

対応項目：透かし | 優先する項目の寸法 | デフォルトのアスペクト比／出力 | クイックモード | カスタムパレット | 言語

スキーマ：references/config/preferences-schema.md

参照資料

寸法：text.md | mood.md | font.md パレット：references/palettes/ レンダリング：references/renderings/ 種類：references/types.md 自動選択：references/auto-selection.md スタイルプリセット：references/style-presets.md 互換性：references/compatibility.md 視覚要素：references/visual-elements.md ワークフロー：confirm-options.md | prompt-template.md | reference-images.md 設定：preferences-schema.md | first-time-setup.md | watermark-guide.md