メニュー
Reference for adding AI generation features using the Gemini pipeline. Covers field generation, article generation, and how to create new AI actions. Use when the user wants to add AI-powered functionality.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Reference for auth tokens, cookies, JWE decoding, max-age strategy, and the cookie-deletion pitfalls specific to this project. Apply whenever editing src/proxy.ts, src/proxy/*, src/utils/services/fetcher.ts, src/stores/{permission,user}-store.ts, login or logout flows.
Trigger automatically when adding or removing a page under src/app/(baseLayout)/*. Forces Sidebar.tsx update in the same change so the menu and route stay in lockstep.
Tamamlanan bir geliştirmeyi veya değişikliği otomatik olarak dokümante eder. docs/CHANGELOG.md [Unreleased] bölümünü günceller, gerekirse yeni bir docs/{FEATURE}.md rehber dosyası oluşturur. Commit öncesi veya sonrası, her geliştirmede /doc-changes komutu ile çalıştır.
Systematic debugging and fix workflow. Use when the user runs /debug-fix <description-of-issue>.
Scaffold a complete CRUD module (service, hook, schema, types, pages). Use when the user runs /new-module <entity-name>.
Scaffold an admin page (list, create, edit) under (baseLayout). Use when the user runs /new-page <entity-name>.
| name | ai-generate |
| description | Reference for adding AI generation features using the Gemini pipeline. Covers field generation, article generation, and how to create new AI actions. Use when the user wants to add AI-powered functionality. |
| user-invocable | false |
Bu projede AI üretimi Gemini API + Server Actions ile yapılır.
| Dosya | İşlev |
|---|---|
src/lib/gemini.ts | Gemini client (model: gemini-2.0-flash) |
src/actions/generate-field.ts | Tekil alan üretimi (slug, SEO, alt text, description) |
src/actions/generate-article.ts | 3-aşamalı makale pipeline |
src/components/ui/AiFieldButton.tsx | Inline AI buton komponenti |
src/components/posts/AiArticlePanel.tsx | Makale üretim paneli |
// src/actions/generate-{feature}.ts
'use server'
import { geminiModel } from '@/lib/gemini'
import { logger } from '@/lib/logger'
export async function generate{Feature}Action(input: InputType): Promise<{
success: boolean
data?: OutputType
error?: string
}> {
try {
const prompt = `...` // Türkçe prompt, rolü ve kuralları belirt
const result = await geminiModel.generateContent(prompt)
const text = result.response.text()
// Parse & validate output
return { success: true, data: parsedOutput }
} catch (error) {
logger.error('generate-{feature} failed', error)
// ASLA ham hata mesajı dönme — API key sızabilir
return { success: false, error: 'Üretim sırasında bir hata oluştu.' }
}
}
'use server' zorunlu, API key client'a gitmezcatch bloğunda ham error mesajını kullanıcıya dönmeconsole.log yasak, logger.error() kullanJSON.parse ile ayrıştır<AiFieldButton onClick={handler} loading={loading} /> kullanAiArticlePanel referans)Büyük içerik üretimlerinde kullan:
Her aşama ayrı generateContent çağrısı. Aşamalar arası veriyi server-side tut.
h1, h2, h3, p, ul, ol, li, strong, em, blockquote, img
Başka tag'ler (script, iframe, style, div, span) frontendAgent tarafından temizlenir.
img etiketi yalnızca <p>...</p> içinde sarmalanmış olur.img üzerinde izinli attribute'lar: src, alt, width, height, loading.src formatı (zorunlu domain — Pollinations.ai, ücretsiz AI image proxy):
https://image.pollinations.ai/prompt/{ENCODED_PROMPT}?width=1200&height=675&nologo=true
{ENCODED_PROMPT} URL-encoded İngilizce görsel prompt (6-14 kelime, fotogerçekçi/illustration/diagram stilini belirt, marka veya kişi adı içermesin)alt zorunlu, Türkçe, max ~12 kelime. Boşsa frontendAgent üretir.@tiptap/extension-image ile yüklü; başka bir TipTap extension'ı eklemeden önce StarterKit ile çakışma olmadığından emin ol.