---
name: scx-prompt-engineering
description: SCX-Studio-Pro projesinde görsel üretim ve düzenleme için etkili prompt yazma tekniklerini, prompt derleme mantığını ve farklı AI modellerinin prompt gereksinimlerini açıklar.
---

# SCX-Studio-Pro Prompt Mühendisliği

Bu skill, SCX-Studio-Pro projesinde yapay zeka destekli görsel üretim ve düzenleme süreçlerinde kullanılan prompt mühendisliği prensiplerini ve tekniklerini detaylandırır. Amaç, kullanıcıların ve ajanların en iyi sonuçları elde etmesi için etkili promptlar oluşturmasına yardımcı olmaktır.

## 1. Prompt Derleme Mekanizması (`prompt-compiler.ts`)

`lib/services/prompt-compiler.ts` dosyası, ham kullanıcı promptlarını farklı AI modellerinin anlayabileceği formatlara dönüştüren merkezi bir bileşendir. Bu derleyici, promptu anlamsal bileşenlere ayırır ve modelin gereksinimlerine göre optimize eder.

### 1.1. `SemanticSpec` Yapısı

`extractSemanticSpec` fonksiyonu, ham promptu aşağıdaki anlamsal bileşenlere ayırır:

| Alan Adı | Açıklama |
| :--- | :--- |
| `subject` | Promptun ana konusu. |
| `scene` | Genel sahne açıklaması. |
| `style` | Görselin sanatsal veya fotoğrafik stili (örneğin, `cinematic`, `photorealistic`). |
| `camera` | Kamera açısı ve çerçeveleme (örneğin, `close-up`, `full body`, `35mm`). |
| `lighting` | Sahnenin ışıklandırması (örneğin, `golden hour`, `studio light`). |
| `identity` | Kimlik tutarlılığı yönergeleri (özellikle referans görsellerle). |
| `textInImage` | Görselde metin olup olmadığı ve tipografi gereksinimleri. |
| `referenceOps` | Referans görsellerin nasıl kullanılacağına dair yönergeler. |
| `maskNotes` | Maskeleme veya düzenleme notları. |
| `safety` | NSFW içeriği olup olmadığına dair bilgi. |
| `rawPrompt` | Orijinal ham prompt. |

Bu anlamsal ayrıştırma, farklı model aileleri için özelleştirilmiş promptlar oluşturulmasına olanak tanır.

### 1.2. Model Ailesine Göre Prompt Derleme

`compileByFamily` fonksiyonu, `SemanticSpec` yapısını kullanarak farklı model aileleri için uygun prompt formatını seçer:

*   **`flux2` (Together FLUX.2):** JSON formatında, `intent`, `subject`, `scene`, `style`, `camera`, `lighting`, `preserve`, `text_in_image`, `references`, `mask_notes`, `safety`, `consistency_rules` ve `fail_if` gibi alanları içeren yapılandırılmış bir prompt oluşturur.
*   **`flux_kontext` / `hunyuan_instruct` (Together Kontext):** Metin tabanlı, talimat odaklı bir prompt oluşturur. `Primary request`, `Preserve strictly`, `Lighting target`, `Camera and framing`, `Style target` gibi açık yönergeler içerir.
*   **`gpt_image` (OpenAI GPT Image):** Metin tabanlı, detaylı yönergeler ve kaçınılması gerekenler (`Avoid`) içeren bir prompt oluşturur.
*   **`sdxl` (ModelsLab SDXL):** JSON formatında `positive` ve `negative` promptları içeren bir yapı kullanır.
*   **`flux1` (Pollinations, HF FLUX.1):** Basit, virgülle ayrılmış anahtar kelimeler ve ifadelerden oluşan bir prompt oluşturur.

## 2. Karakter DNA ve Prompt İlişkisi

`CharacterDNA` modeli, karakterlerin görsel özelliklerini ve referanslarını saklar. `compilePromptForModel` fonksiyonu, `characterDNA` bilgisi sağlandığında `buildFinalPrompt` fonksiyonunu kullanarak ham promptu karakterin özellikleriyle zenginleştirir. Bu, karakter tutarlılığını sağlamak için kritik öneme sahiptir.

## 3. Görsel Tutarlılık (`visual-consistency.ts`)

`lib/shared/visual-consistency.ts` dosyası, görsel tutarlılığı sağlamak için kullanılan ifadeleri ve kuralları tanımlar. `buildVisualConsistencyBundle` ve `buildNegativeConsistencyCues` gibi fonksiyonlar, promptlara eklenerek AI modellerine kimlik, perspektif, ışıklandırma ve ölçek gibi konularda tutarlı sonuçlar üretmeleri için talimat verir.

## 4. Prompt Mühendisliği İpuçları

*   **Açık ve Net Olun:** Promptlarınızda ne istediğinizi açıkça belirtin. Belirsiz ifadelerden kaçının.
*   **Detay Verin:** Stil, ışıklandırma, kamera açısı gibi görsel detayları ekleyin. `SemanticSpec` alanlarını düşünerek promptunuzu zenginleştirin.
*   **Referans Görseller Kullanın:** Karakter tutarlılığı veya belirli bir stil için referans görseller sağlamak, AI modelinin daha doğru sonuçlar üretmesine yardımcı olur.
*   **Negatif Promptları Kullanın:** İstemediğiniz öğeleri veya özellikleri belirtmek için negatif promptları kullanın (örneğin, `bad quality`, `blurry`, `deformed`).
*   **Model Ailesini Anlayın:** Kullandığınız AI modelinin prompt derleme mantığını ve yeteneklerini anlayın. Bazı modeller JSON tabanlı yapılandırılmış promptları tercih ederken, bazıları daha doğal dil ifadelerini daha iyi anlar.
*   **NSFW İçerik:** NSFW içerik üretirken, uygun sağlayıcıları ve modelleri seçtiğinizden ve gerekli onayları aldığınızdan emin olun.

Bu skill, SCX-Studio-Pro projesinde prompt mühendisliği süreçlerini standartlaştırmak ve optimize etmek için bir rehberdir.