菜单
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 职业分类
| 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.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>.