プロンプト品質レビューワークフロー ユーザーマニュアル¶

収集 (main.py)
    ↓
YAML保存 (prompt-library/{model_type}/collected/{username}/*.yaml)
    ↓
自動レビュー (review.py --auto-review)    ← Gemini API で評価
    ↓
品質フィルタリング (quality_filter.py)    ← スコア集計・上位抽出
    ↓
テスト画像生成 (review.py --generate)     ← SD WebUI で確認
    ↓
自動改善ループ (improvement_loop.py)      ← Gemini Vision でプロンプト改善

name: "キャラクター立ち絵プロンプト"        # プロンプトの説明（自動生成）
id: "x-UNfukashigi-1234567890-sd15"         # 一意のID（収集元アカウント+ツイートID+モデル）
model_type: sd15                             # sd15 / sdxl / both
category: character                          # character / scene / style / pose / other

prompt:
  positive: "1girl, solo, ..."              # ポジティブプロンプト
  negative: "worst quality, ..."            # ネガティブプロンプト

params:
  steps: 28                                 # サンプリングステップ数
  cfg_scale: 7.0                            # CFGスケール
  sampler: "DPM++ 2M Karras"               # サンプラー
  width: 512                                # 画像幅
  height: 768                               # 画像高さ

meta:
  author: "@UNfukashigi"                    # 収集元ユーザー
  created: "2026-03-10"                     # 収集日
  updated: "2026-03-10"                     # 最終更新日
  quality_rating: 1                         # 品質評価（1〜5、初期値1）
  consistency_rating: 1                     # 一貫性評価（1〜5、初期値1）
  tags: [collected, from-UNfukashigi]       # タグ
  use_case: standalone                      # 使用ケース

review:
  last_reviewed: null                       # 最終レビュー日（null = 未レビュー）
  suggestions: []                           # 改善提案（Gemini出力）
  prompt_analysis:
    tag_order_quality: null                 # タグ順序評価（good/fair/poor）
    weight_balance: null                    # 重み付け評価（good/fair/poor）
    redundancy_notes: null                  # 重複・矛盾タグのメモ

dependencies:
  loras: []                                 # 使用LoRA
  embeddings: []                            # 使用Embedding

notes: "ソース: https://x.com/..."          # メモ（ソースURL等）

composite_score = quality_rating × 0.4
                + consistency_rating × 0.3
                + ((tag_order + weight_balance) / 2) × 0.3

1. 主被写体の数・種類（1girl, solo 等）
2. 顔・表情（beautiful face, smile 等）
3. 衣装・アクセサリー
4. ポーズ・動作
5. 背景・環境
6. 画質・スタイル指定（masterpiece, best quality 等）
7. ネガティブ強調タグ

1. 画質・スタイル（photorealistic, anime style 等）
2. 主被写体
3. 詳細描写
4. 背景・環境
5. 追加品質指定

cd projects/prompt-collector
python review.py [モード] [オプション]

# 収集済みYAML全件を表示
python review.py --list

# 未レビューのみ表示（* マーク付き）
python review.py --list --unreviewed

# モデルタイプでフィルタ（sd15 / sdxl / both）
python review.py --list --model sd15

# ユーザーでフィルタ
python review.py --list --user UNfukashigi

# 組み合わせ
python review.py --list --unreviewed --model sdxl

==========================================================================================
No.  ユーザー             モデル  品質   一貫性  最終レビュー   ファイル名
==========================================================================================
*  1  UNfukashigi         sd15   1      1       未レビュー     x-UNfukashigi-1234.yaml
   2  studiomasakaki      sdxl   4      4       2026-03-10    x-studiomasakaki-5678.yaml
==========================================================================================
合計: 2件  (* = 未レビュー)

# 未レビューファイルを全件レビュー（デフォルト動作）
python review.py --auto-review

# 特定ファイルのみレビュー
python review.py --auto-review --file x-UNfukashigi-1234.yaml

# モデルタイプ指定
python review.py --auto-review --model sd15

# レビュー済み含め全件を再レビュー
python review.py --auto-review --all

# ファイルへの書き込みをスキップして確認
python review.py --auto-review --dry-run

# 詳細ログを出力
python review.py --auto-review -v

自動レビュー開始: 3件

[1/3] x-UNfukashigi-1234.yaml
  品質評価: 4/5  一貫性: 4/5
  タグ順序: good  重み付け: fair
  重複メモ: なし
  提案: ネガティブプロンプトにembedding（EasyNegative等）の使用を検討

[2/3] x-studiomasakaki-5678.yaml
  ...

自動レビュー完了: 成功=3件, 失敗=0件 / 合計=3件

# 特定ファイルの画像を生成
python review.py --generate --file x-UNfukashigi-1234.yaml

# 未レビューファイルの全件を生成
python review.py --generate --unreviewed

# モデルタイプ指定
python review.py --generate --model sdxl

# SD WebUI のURLを指定（デフォルト: http://127.0.0.1:7860）
python review.py --generate --file foo.yaml --sd-url http://127.0.0.1:7860

python review.py --stats

============================================================
  プロンプトライブラリ レビュー統計
============================================================
  総YAMLファイル数: 42件
  レビュー済み:     35件 (83.3%)
  未レビュー:        7件 (16.7%)

  [モデル別]
    both    :  5件
    sd15    : 28件
    sdxl    :  9件

  [ユーザー別]
    @UNfukashigi        : 15件
    @studiomasakaki     :  8件
    ...

  [品質評価分布（quality_rating）]
    1=未評価/不明:   7件
    2=低品質     :   3件
    3=普通       :  12件
    4=良質       :  15件
    5=非常に良質 :   5件
============================================================

cd projects/prompt-collector
python quality_filter.py [モード] [オプション]

# 全体サマリー
python quality_filter.py --summary

# モデル別サマリー
python quality_filter.py --summary --model sdxl

# 全体の上位10件
python quality_filter.py --top 10

# SDXL限定の上位5件
python quality_filter.py --top 5 --model sdxl

# キャラクターカテゴリの上位20件
python quality_filter.py --top 20 --category character

# quality_rating <= 2 のプロンプト一覧（デフォルト）
python quality_filter.py --low-quality

# 閾値を指定（quality_rating <= 3 以下を低品質とみなす）
python quality_filter.py --low-quality --threshold 3

# 全体の上位20件をYAMLとして保存
python quality_filter.py --export-top 20

# SDXL・キャラクターカテゴリの上位10件
python quality_filter.py --export-top 10 --model sdxl --category character

python quality_filter.py --duplicates

python quality_filter.py --duplicates --model sd15

python quality_filter.py --user-ranking

python quality_filter.py --user-ranking --model sdxl

cd projects/prompt-collector

# SD WebUI と Gemini API の接続確認
python improvement_loop.py --check

# 単一ファイルの改善ループ（デフォルト: 最大3回、目標スコア7.0/10）
python improvement_loop.py --run path/to/prompt.yaml

# 最大反復回数・目標スコアを指定
python improvement_loop.py --run path/to/prompt.yaml --max-iterations 5 --target-score 8.0

# バッチ実行（未レビューの sd15 プロンプト全件）
python improvement_loop.py --run-batch --model sd15 --unreviewed

# 改善履歴を確認
python improvement_loop.py --history path/to/prompt.yaml

# 書き込みをスキップして確認
python improvement_loop.py --run path/to/prompt.yaml --dry-run

cd projects/prompt-collector

# 全体統計を確認
python review.py --stats

# 未レビュー一覧を確認
python review.py --list --unreviewed

# 未レビューファイルを全件レビュー
python review.py --auto-review

# レートリミットが懸念される場合はモデル別に分けて実行
python review.py --auto-review --model sd15
python review.py --auto-review --model sdxl

python quality_filter.py --summary

# 低品質プロンプトを確認
python quality_filter.py --low-quality

# 重複プロンプトを確認
python quality_filter.py --duplicates

# 全体の上位20件をエクスポート（AI漫画制作等に活用）
python quality_filter.py --export-top 20

# キャラクターカテゴリ限定
python quality_filter.py --export-top 10 --category character --model sd15

# 上位プロンプトのテスト画像を生成
python review.py --generate --file x-UNfukashigi-1234.yaml

cd projects/prompt-collector

# 1. レビュー統計（全体概況）
python review.py --stats

# 2. 品質サマリー（スコア分布）
python quality_filter.py --summary

# 3. 上位プロンプト一覧
python quality_filter.py --top 10

# 4. 低品質一覧（改善候補）
python quality_filter.py --low-quality

# 5. ユーザー別ランキング
python quality_filter.py --user-ranking

cd projects/prompt-collector

python review.py --stats > /tmp/review_stats.txt && \
python quality_filter.py --summary >> /tmp/review_stats.txt && \
python quality_filter.py --top 20 >> /tmp/review_stats.txt && \
python quality_filter.py --user-ranking >> /tmp/review_stats.txt

# 保存先を確認
cat /tmp/review_stats.txt

# SD1.5 の詳細レポート
python quality_filter.py --summary --model sd15
python quality_filter.py --top 10 --model sd15 --category character
python quality_filter.py --top 10 --model sd15 --category scene

# SDXL の詳細レポート
python quality_filter.py --summary --model sdxl
python quality_filter.py --top 10 --model sdxl

レートリミット。60秒待機後リトライ (1/2)

[エラー] SD WebUI (http://127.0.0.1:7860) に接続できません。

エラー: 設定ファイルが見つかりません

エラー: prompt-libraryパスが見つかりません

python quality_filter.py --duplicates

prompt-library/
├── sd15/
│   └── collected/
│       ├── UNfukashigi/
│       │   ├── x-UNfukashigi-1234567890-sd15.yaml
│       │   └── test_images/               ← テスト画像保存先
│       │       └── x-UNfukashigi-..._20260310.png
│       └── studiomasakaki/
│           └── ...
├── sdxl/
│   └── collected/
│       └── ...
├── both/
│   └── collected/
│       └── ...
└── exports/                               ← エクスポートYAML保存先
    └── top20_20260310.yaml