prompt-xray

プロンプト Xray - プロンプトリバースエンジニアリングシステム

設計哲学: ブラックボックスを分解し、曖昧さを明確にする 中核機能: 「Xをどのように行うか」という質問に答える

---

🎯 解決する問題

問題: プロンプトはブラックボックスです → 次のことがわかりません：

• 色をどのように制御するか？
• 空間レイアウトをどのように制御するか？
• 特徴的なシンボルをどのように追加するか？
• タイポグラフィをどのように調整するか？
• 素材をどのように制御するか？
• 光と影をどのように制御するか？

解決策: N個の優れたプロンプトからパターンを抽出 → ナレッジベースを生成

---

📋 使用方法

方法1：単一の次元の知識を抽出

从已分析的提示词中，提取"如何控制颜色"的知识

方法2：すべての次元の知識を抽出

从已分析的提示词中，构建完整知识库

方法3：範囲を指定

分析moss_terrarium系列，提取配色知识

---

🔄 実行フロー

ユーザーが知識の抽出を依頼した場合は、次の手順に従います：

Step 1: データを読み込む

ツールを使って extracted_results/ 配下のすべての *_extracted.json ファイルを読み込みます：

from xray_helper import load_prompts
prompts = load_prompts(pattern="*_extracted.json")

Step 2: 次元ごとに分析する

ユーザーが依頼した次元に応じて、対応するモジュールを分析します：

ユーザーが「色」の知識を求める場合：

• すべての color_scheme モジュールを抽出
• 配色の公式、キーワード、テクニックを分析
• 以下のテンプレートに従ってMarkdownを生成

ユーザーが「レイアウト」の知識を求める場合：

• すべての composition モジュールを抽出
• 視点、構図のルール、配置方法を分析
• テンプレートに従ってMarkdownを生成

ユーザーが「シンボル」の知識を求める場合：

• constraints と detail_enhancers モジュールを抽出
• テキストの記述法、ロゴの追加方法を分析
• テンプレートに従ってMarkdownを生成

ユーザーが「素材」の知識を求める場合：

• detail_enhancers と関連する記述を抽出
• 表面の特徴、物理的特性、質感を表すキーワードを分析
• テンプレートに従ってMarkdownを生成

ユーザーが「光と影」の知識を求める場合：

• technical_parameters.lighting と mood_atmosphere を抽出
• 光源の種類、ライティング方法、雰囲気の効果を分析
• テンプレートに従ってMarkdownを生成

ユーザーが「タイポグラフィ」の知識を求める場合（デザイン関連）：

• composition と visual_style を抽出
• グリッドシステム、視覚的階層、整列ルールを分析
• テンプレートに従ってMarkdownを生成

Step 3: ナレッジカードを生成する

ツールを使って結果を保存します：

from xray_helper import save_knowledge_card
save_knowledge_card(dimension="color", content=markdown_content)

---

📝 出力テンプレート

テンプレート1: 色をどのように制御するか？

# 如何控制颜色？

**分析时间**: {当前时间}
**样本数量**: {分析了多少个提示词}
**数据来源**: {哪些提示词}

---

## 🎨 配色公式

### 公式1: 冷暖对立（7:3黄金比例）
- **公式**: `70% cool base + 30% warm accent`
- **来源**: moss_terrarium_001
- **效果**: 自然和谐 + 视觉层次

### 公式2: ...

---

## 📚 颜色关键词库

### 冷色系
- `rich forest greens`
- `deep ocean blues`
- `ice whites`

### 暖色系
- `warm amber wood tones`
- `sunset orange`
- `golden hour light`

### 中性色
- `grayscale`
- `pristine whites`

---

## 🛠️ 配色技巧

1. **温度对比** - 冷色环境 + 暖色焦点 = 视觉层次
2. **7:3比例** - 主色70%，焦点色30%
3. **单色调+焦点色** - 极简风格

---

## 💡 应用案例

### 案例1: moss_terrarium_001
**配色方案**: rich forest greens (70%) + warm amber wood (30%)
**效果**: Natural harmony, clear focal point
**适用场景**: 自然场景、植物摄影

### 案例2: ...

テンプレート2: 空間レイアウトをどのように制御するか？

# 如何控制空间布局？

**分析时间**: {当前时间}
**样本数量**: {分析了多少个提示词}

---

## 🎥 视角选择

### `slight top-down angle`
**适用场景**: 微缩场景、产品摄影、生态瓶
**关键词**: `top-down view`, `bird's eye view`, `overhead angle`
**案例**: moss_terrarium_001, moss_terrarium_002
**效果**: 展示全貌，适合平铺布局

### `isometric view`
**适用场景**: 3D产品、游戏场景、建筑
**关键词**: `isometric`, `45-degree angle`
**效果**: 保持平行线，无透视变形

---

## 📐 构图规则

### Golden Ratio（黄金比例）
**关键词**: `golden ratio composition`, `phi grid`
**效果**: 经典和谐比例，视觉平衡
**使用频率**: 3次

### Rule of Thirds（三分法）
**关键词**: `rule of thirds`, `thirds grid`
**效果**: 动态平衡，引导视线

### Centered Symmetry（中心对称）
**关键词**: `centered`, `perfectly symmetrical`
**效果**: 稳定、庄重感

---

## 🎯 定位方法

### 相对位置描述
- `iPhone placed next to notebook`
- `floating in 3D space`
- `bottom-left quadrant`

### 精确坐标（高级）
- `Subject A [X: 20-40, Y: 60-100] (Bottom-Left)`
- `Subject B [X: 60-80, Y: 0-40] (Top-Right)`

---

## 💡 应用案例

### 案例1: moss_terrarium_001
**视角**: slight top-down angle
**构图**: centered in frame, golden ratio
**定位**: terrarium centered, cottage as focal point

テンプレート3: 特徴的なシンボルをどのように追加するか？

# 如何添加标志性符号？

---

## ✍️ 文字添加语法

### 基础语法

text "HELLO" in bold serif large bold sans-serif text "SALE" in red neon red cursive script "OPEN"

### 位置控制
- `lower left corner`
- `centered at top`
- `floating in 3D space`

---

## 🏷️ Logo/水印添加

### 正确示例

small square watermark in lower left corner simple logo in top-right, 10% opacity brand symbol integrated into design

### ❌ 反面案例（避免）
- `exactly 10x10 pixels` → AI无法保证像素精度
- `Gothic font AND Arial font` → 矛盾指令
- `mandatory mandatory mandatory` → 重复无效

---

## 🎨 符号风格

### 材质效果
- `neon` - 霓虹灯效果
- `embossed` - 浮雕效果
- `metallic sheen` - 金属光泽
- `glowing` - 发光效果

### 字体风格
- `bold serif` - 粗体衬线
- `sans-serif` - 无衬线
- `cursive script` - 草书
- `calligraphy` - 书法体

テンプレート4: 素材をどのように制御するか？

# 如何控制材质？

---

## 🔍 表面特征

### 金属材质
- `brushed titanium` - 拉丝钛金属
- `polished chrome` - 抛光镀铬
- `metallic sheen` - 金属光泽

### 有机材质
- `living green textures` - 生机勃勃的绿色质感
- `natural wood grain` - 天然木纹
- `rough bark` - 粗糙树皮

### 玻璃/透明
- `under glass` - 玻璃下
- `translucent` - 半透明
- `crystal clear` - 晶莹剔透

---

## ⚙️ 物理属性

- `glossy` / `matte` - 光泽/哑光
- `reflective` / `absorptive` - 反射/吸收
- `weathered` / `pristine` - 风化/原始
- `soft` / `rigid` - 柔软/坚硬

---

## ✨ 光学效果

- `morning dew droplets` - 晨露水珠
- `soft sunlight reflections on glass` - 玻璃上的柔和阳光反射
- `condensation` - 冷凝水汽
- `refraction` - 折射

テンプレート5: 光と影をどのように制御するか？

# 如何控制光影？

---

## 💡 光源类型

### 自然光
- `soft diffused daylight` - 柔和漫射日光
- `golden hour light` - 黄金时段光线
- `morning sunlight` - 晨光
- `harsh noon sun` - 正午强光

### 人工光
- `studio lighting` - 影棚灯光
- `neon lights` - 霓虹灯
- `rim light` - 轮廓光
- `softbox overhead` - 头顶柔光箱

---

## 🎬 布光方案

### Rembrandt Lighting（伦勃朗布光）
**效果**: 戏剧性，适合人像
**关键词**: `Rembrandt light`, `triangle highlight`, `dramatic shadows`

### Soft Diffused Light（柔和漫射光）
**效果**: 自然、清新、无硬影
**关键词**: `soft diffused`, `natural ambient`, `no harsh shadows`

### Rim Light（轮廓光）
**效果**: 勾勒边缘，分离主体和背景
**关键词**: `rim lighting`, `backlight`, `edge highlight`

---

## 🌤️ 光线+氛围公式

### 清新宁静

soft diffused daylight + morning dew = fresh, peaceful atmosphere

### 戏剧张力

Rembrandt light + rim light = dramatic portrait with depth

### 科技未来

neon accent lights + volumetric fog = cyberpunk atmosphere

---

## 🌫️ 大气效果

- `volumetric fog` - 体积雾
- `misty` - 雾蒙蒙
- `hazy` - 朦胧
- `clear crisp air` - 清澈空气

---

🛠️ ツール関数

xray_helper.py のツール関数を使用します：

プロンプトを読み込む

from xray_helper import load_prompts

# 加载所有提示词
all_prompts = load_prompts()

# 加载特定范围
moss_prompts = load_prompts(pattern="moss_terrarium*")

ナレッジカードを保存する

from xray_helper import save_knowledge_card

save_knowledge_card(
    dimension="color",
    content=markdown_content,
    metadata={
        'samples': 10,
        'source': 'moss_terrarium + ethereal_deity'
    }
)

---

💡 重要な原則

1. パターンを見つける。列挙するのではない

❌ 誤り：すべての色のキーワードを列挙するだけ ✅ 正しい：配色の公式を見つける（例：70% cool + 30% warm）

2. 説明ではなく、テクニックを抽出する

❌ 誤り：「このプロンプトはフォレストグリーンを使っています」 ✅ 正しい：「寒色の環境 + 暖色の焦点 = 視覚的な階層」

3. そのまま再利用できる事例を示す

❌ 誤り：「補色を使う」という曖昧な説明 ✅ 正しい：具体例 rich forest greens + warm amber wood

4. 優れた事例からも、誤りからも学ぶ

• Aランクのプロンプトからベストプラクティスを学ぶ
• Dランクのプロンプト（例：pencil_sketch_idol）から反面教師を学ぶ

---

📊 分析手順（詳細）

ユーザーが「色をどのように制御するかという知識を抽出して」と言った場合

Step 1: データを読み込む

prompts = load_prompts()

Step 2: すべてのプロンプトを確認し、color_scheme モジュールを抽出

color_data = []
for prompt in prompts:
    if 'color_scheme' in prompt['modules']:
        color_data.append({
            'id': prompt['prompt_id'],
            'scheme': prompt['modules']['color_scheme']
        })

Step 3: 配色の公式を分析

• primary_palette フィールドを検索
• temperature の説明を確認（例：「balanced - cool greens + warm wood」）
• 比率を特定（70%/30%）
• concept を抽出（例：「Cold Shell, Warm Heart」）

Step 4: キーワードを分類

• すべての色の説明を確認
• 寒色／暖色／中性色に分類
• 重複を削除し、並べ替え

Step 5: テクニックを抽出

• 温度差によるコントラストか？
• 高コントラスト／低コントラストか？
• 単色調 + 焦点色か？

Step 6: 事例を作成

• 最適な事例を3〜5件選ぶ
• 配色、効果、適用場面を含める

Step 7: Markdownを生成

• テンプレートに沿って内容を記入
• save_knowledge_card() を使って保存

---

🎯 出力先

すべてのナレッジカードは次の場所に保存します：

knowledge_base/
├── how_to_control_color.md
├── how_to_control_layout.md
├── how_to_add_symbols.md
├── how_to_control_materials.md
├── how_to_control_lighting.md
└── how_to_control_typography.md (针对设计类)

---

✅ 完了基準

生成されたナレッジカードは、次の条件を満たす必要があります：

1. ✅ 「Xをどのように行うか」という質問に答える
2. ✅ 具体的なキーワードと公式を含む
3. ✅ 実例を3件以上含む
4. ✅ 新しいプロンプトにそのまま再利用できる
5. ✅ 良い事例と悪い事例から得た教訓の両方を含む

---

スキルの状態: ✅ 設計完了 最終更新: 2026-01-04 使用ツール: xray_helper.py