@hd-agent-kit/cli 1.0.0

package/templates/.agents/skills/commit/SKILL.md

@@ -0,0 +1,257 @@
+# /commit — Akıllı Commit Skill'i
+
+> **Tetikleyici:** `/commit`
+> **Amaç:** Mevcut değişiklikleri analiz ederek uygun, anlamlı bir commit mesajı önermek ve kullanıcı onayıyla commit oluşturmak.
+> **Çıktı:** Commit mesaj önerisi → Onay → Commit
+
+---
+
+## Temel İlkeler
+
+- **Commit mesajı her zaman İngilizce olmalı** (proje kurallarında farklı bir dil belirtilmediği sürece).
+- **Proje kuralları öncelikli.** `project-rules.md` dosyasında Git/commit kuralları varsa onlara uy.
+- **Conventional Commits formatı varsayılan.** Proje kurallarında farklı bir format belirtilmediği sürece.
+- **Asla otomatik commit yapma.** Önce öneri sun, onay al, sonra commit et.
+
+---
+
+## Uygulama Adımları
+
+### Adım 1: Proje Commit Convention Tespiti
+
+Önce projedeki mevcut commit kurallarını tespit et:
+
+```
+Kontrol sırası:
+1. project-rules.md → "Git Kuralları" bölümü var mı?
+2. .commitlintrc / commitlint.config.js → Commitlint kuralları var mı?
+3. .czrc / .cz.json / package.json "config.commitizen" → Commitizen config var mı?
+4. Son 10-15 commit mesajını incele (git log --oneline -15) → Mevcut pattern ne?
+5. CONTRIBUTING.md → Commit format rehberi var mı?
+6. Husky / lint-staged → Pre-commit hook'lar var mı?
+```
+
+**Tespit sonuçlarını not al:**
+- Commit format: [Conventional Commits / Gitmoji / Serbest / Özel format]
+- Dil: [İngilizce / Türkçe / Karma]
+- Scope zorunlu mu: [Evet / Hayır]
+- Body/footer convention: [var/yok]
+- Breaking change formatı: [var/yok]
+- Issue/ticket referansı: [var/yok, format: #123 / JIRA-123 / LINEAR-123]
+
+### Adım 2: Değişiklikleri Analiz Et
+
+Aşağıdaki git komutlarını çalıştır:
+
+```bash
+# Staged ve unstaged değişiklikleri gör
+git status
+
+# Staged değişikliklerin detayı
+git diff --cached
+
+# Unstaged değişikliklerin detayı (staged yoksa)
+git diff
+
+# Yeni eklenen dosyalar
+git ls-files --others --exclude-standard
+```
+
+**Değişiklik analizi:**
+- Hangi dosyalar değişmiş?
+- Değişiklik tipi ne? (yeni özellik, bug fix, refactor, stil, test, docs, chore)
+- Kaç dosya etkilenmiş?
+- Breaking change var mı?
+- Birden fazla bağımsız değişiklik var mı? (ayrı commit önerisi gerekebilir)
+
+### Adım 3: Commit Mesajı Oluştur
+
+#### Conventional Commits Formatı (Varsayılan)
+
+```
+<type>(<scope>): <description>
+
+[optional body]
+
+[optional footer(s)]
+```
+
+**Type seçimi:**
+
+| Type | Kullanım |
+|------|----------|
+| `feat` | Yeni özellik ekleme |
+| `fix` | Bug düzeltme |
+| `refactor` | Kod yapısı değişikliği (davranış değişmez) |
+| `style` | Formatlama, boşluk, noktalama (kod değişmez) |
+| `docs` | Dokümantasyon değişikliği |
+| `test` | Test ekleme/düzeltme |
+| `chore` | Build, CI, dependency, config değişiklikleri |
+| `perf` | Performans iyileştirmesi |
+| `ci` | CI/CD pipeline değişiklikleri |
+| `build` | Build sistemi veya bağımlılık değişiklikleri |
+| `revert` | Önceki commit'i geri alma |
+
+**Scope belirleme:**
+- Değişiklik tek bir modül/feature'a aitse: `feat(auth): add login form validation`
+- Değişiklik genel ise: `fix: resolve memory leak in event listeners`
+- Proje scope convention'ı varsa ona uy
+
+**Description kuralları:**
+- İngilizce, küçük harfle başla
+- Imperative mood kullan ("add" not "added", "fix" not "fixed")
+- 50 karakteri geçme (type ve scope dahil ~72 karakter)
+- Nokta ile bitirme
+- "Ne" yapıldığını değil "neden" yapıldığını vurgula (mümkünse)
+
+**Body kuralları (opsiyonel):**
+- Description yeterli değilse detay ekle
+- "Ne" ve "neden" sorusuna cevap ver
+- 72 karakter satır limiti
+- Boş satırla description'dan ayır
+
+**Footer kuralları (opsiyonel):**
+- Breaking change: `BREAKING CHANGE: <açıklama>`
+- Issue referansı: `Closes #123`, `Fixes #456`, `Refs JIRA-789`
+
+### Adım 4: Öneriyi Sun
+
+Kullanıcıya şu formatta sun:
+
+```
+📋 Değişiklik Özeti:
+- [N] dosya değişti
+- [kısa açıklama]
+
+💬 Commit Mesajı Önerisi:
+
+feat(auth): add email validation to login form
+
+Add Zod schema validation for email and password fields.
+Display inline error messages on invalid input.
+
+Closes #42
+
+---
+Bu mesajı kullanmak ister misiniz?
+(E) Onayla | (D) Düzenle | (İ) İptal
+```
+
+**Birden fazla bağımsız değişiklik varsa:**
+
+```
+⚠️ Birden fazla bağımsız değişiklik tespit ettim.
+Bunları ayrı commit'lere ayırmayı öneriyorum:
+
+Commit 1: feat(auth): add email validation to login form
+  Dosyalar: src/features/auth/LoginForm.tsx, src/schemas/auth.ts
+
+Commit 2: fix(ui): resolve button hover state on mobile
+  Dosyalar: src/components/Button.tsx
+
+Ayrı commit'ler olarak mı, tek commit mi oluşturalım?
+```
+
+### Adım 5: Commit Oluştur
+
+Kullanıcı onayladıktan sonra:
+
+```bash
+# Değişiklikleri stage'le (henüz staged değilse)
+git add <ilgili dosyalar>
+
+# Commit oluştur
+git commit -m "<onaylanan mesaj>"
+```
+
+**Dikkat:**
+- `git add .` veya `git add -A` kullanma — sadece ilgili dosyaları stage'le
+- Sensitive dosyaları (.env, credentials) commit'leme, uyar
+- Pre-commit hook varsa ve başarısız olursa, sorunu düzelt ve YENİ commit oluştur (amend yapma)
+
+---
+
+## Özel Durumlar
+
+### Gitmoji Projesi
+
+Projede gitmoji kullanılıyorsa:
+
+```
+🎨 :art: — Kod yapısı/formatı iyileştirme
+⚡ :zap: — Performans iyileştirme
+🔥 :fire: — Kod/dosya silme
+🐛 :bug: — Bug düzeltme
+✨ :sparkles: — Yeni özellik
+📝 :memo: — Dokümantasyon
+🚀 :rocket: — Deploy
+💄 :lipstick: — UI/stil güncelleme
+🎉 :tada: — İlk commit
+✅ :white_check_mark: — Test ekleme/düzeltme
+🔒 :lock: — Güvenlik düzeltme
+♻️ :recycle: — Refactor
+➕ :heavy_plus_sign: — Dependency ekleme
+➖ :heavy_minus_sign: — Dependency silme
+🔧 :wrench: — Config değişikliği
+```
+
+### Monorepo Projeleri
+
+Scope olarak paket/app adını kullan:
+
+```
+feat(web): add dark mode toggle
+fix(ui-kit): resolve button focus ring color
+chore(shared): update zod to v4
+```
+
+### Boş Değişiklik
+
+Stage'de veya working tree'de değişiklik yoksa:
+
+```
+ℹ️ Commit edilecek değişiklik bulunamadı.
+Tüm değişiklikler zaten commit edilmiş görünüyor.
+```
+
+### Merge Conflict Sonrası
+
+```
+⚠️ Merge sonrası commit tespit ettim.
+Varsayılan merge commit mesajını kullanmanızı öneriyorum:
+
+Merge branch 'feature/auth' into develop
+
+Özelleştirmek ister misiniz?
+```
+
+---
+
+## Kötü vs İyi Commit Mesajları
+
+```
+❌ Kötü:
+- "fix bug"
+- "update code"
+- "changes"
+- "wip"
+- "asdfgh"
+- "fix: fixed the thing that was broken"
+
+✅ İyi:
+- "fix(cart): prevent duplicate items on rapid add-to-cart clicks"
+- "feat(search): add debounced search with 300ms delay"
+- "refactor(api): extract auth middleware into separate module"
+- "chore(deps): upgrade next.js from 14.2 to 15.0"
+- "docs(readme): add environment setup instructions"
+```
+
+---
+
+## Çıktı Formatı
+
+1. **Proje convention tespiti** — Mevcut commit formatı ne?
+2. **Değişiklik özeti** — Hangi dosyalar, ne tip değişiklik
+3. **Commit mesaj önerisi** — Convention'a uygun, anlamlı mesaj
+4. **Kullanıcı onayı** — Onayla / Düzenle / İptal
+5. **Commit oluşturma** — Onay sonrası git commit

package/templates/.agents/skills/document/SKILL.md

@@ -0,0 +1,322 @@
+# /document — Dokümantasyon Skill'i
+
+> **Tetikleyici:** `/document [dosya/modül/proje]`
+> **Amaç:** JSDoc/TSDoc comment'leri, README veya API dokümantasyonu üretmek.
+> **Çıktı:** Mevcut dokümantasyon stiline uygun, kapsamlı dokümantasyon
+
+---
+
+## Temel İlkeler
+
+- **Mevcut dokümantasyon stiline uy.** Projede JSDoc varsa JSDoc, TSDoc varsa TSDoc devam et.
+- **Gereksiz yorum yazma.** Kodu açıklayan değil, "neden"i açıklayan yorumlar yaz.
+- **Güncel tut.** Kod değiştiğinde dokümantasyonun da güncellenmesi gerektiğini belirt.
+- **Tutarlılık.** Tüm dokümantasyon aynı formatta ve dilde olsun.
+
+---
+
+## Kullanım Formatları
+
+```
+/document src/components/Button.tsx       ← Dosya seviyesi JSDoc/TSDoc
+/document src/hooks/                      ← Klasör seviyesi (tüm dosyalar)
+/document src/services/api.ts             ← API service dokümantasyonu
+/document project                         ← Proje README oluştur
+/document api                             ← API endpoint dokümantasyonu
+/document UserService                     ← Modül adı ile
+```
+
+---
+
+## Uygulama Adımları
+
+### Adım 1: Hedef Analizi
+
+```
+📋 Dokümantasyon Hedefi:
+├── Hedef: [dosya / klasör / proje / API]
+├── Mevcut dokümantasyon: [var/yok, format]
+├── Dokümantasyon dili: [Türkçe / İngilizce — projeden tespit et]
+├── Mevcut JSDoc/TSDoc stili: [format örneği]
+└── Hedef kitle: [Geliştirici / Son kullanıcı / Her ikisi]
+```
+
+### Adım 2: Dokümantasyon Tipi Belirleme
+
+Hedefe göre uygun dokümantasyon tipini seç:
+
+| Hedef | Dokümantasyon Tipi |
+|-------|-------------------|
+| Tekil dosya (component/hook/util) | JSDoc/TSDoc inline comment'leri |
+| Service/API katmanı | API dokümantasyonu + JSDoc |
+| Tüm proje | README.md + CONTRIBUTING.md |
+| Kütüphane/paket | API reference + kullanım örnekleri |
+| Klasör | Her dosya için JSDoc + klasör INDEX.md |
+
+---
+
+## Dosya Seviyesi Dokümantasyon (JSDoc/TSDoc)
+
+### Component Dokümantasyonu
+
+```typescript
+/**
+ * Kullanıcı profil kartını görüntüler.
+ *
+ * Avatar, isim, rol bilgisi ve aksiyonları içerir.
+ * Responsive tasarıma sahiptir ve mobilde stack layout'a geçer.
+ *
+ * @example
+ * ```tsx
+ * <UserCard
+ *   user={userData}
+ *   onEdit={handleEdit}
+ *   variant="compact"
+ * />
+ * ```
+ *
+ * @see {@link UserCardProps} — Props detayları
+ * @see {@link useUser} — İlgili hook
+ */
+```
+
+### Props/Interface Dokümantasyonu
+
+```typescript
+/**
+ * UserCard component'inin prop tanımları.
+ */
+interface UserCardProps {
+  /** Görüntülenecek kullanıcı verisi */
+  user: User;
+
+  /** Kart görünüm varyantı
+   * - `default`: Tam genişlik, tüm bilgiler
+   * - `compact`: Küçük boyut, sadece temel bilgiler
+   * - `minimal`: Sadece avatar ve isim
+   * @default 'default'
+   */
+  variant?: 'default' | 'compact' | 'minimal';
+
+  /** Düzenleme butonuna tıklandığında çağrılır */
+  onEdit?: (userId: string) => void;
+
+  /** Kartın yüklenme durumunu gösterir
+   * @default false
+   */
+  isLoading?: boolean;
+}
+```
+
+### Hook Dokümantasyonu
+
+```typescript
+/**
+ * Kullanıcı kimlik doğrulama state'ini ve işlemlerini yönetir.
+ *
+ * Login, logout, token yenileme ve kullanıcı bilgisi sorgulama
+ * işlemlerini tek bir hook altında toplar.
+ *
+ * @example
+ * ```tsx
+ * function LoginPage() {
+ *   const { user, login, logout, isAuthenticated } = useAuth();
+ *
+ *   if (isAuthenticated) {
+ *     return <Dashboard user={user} onLogout={logout} />;
+ *   }
+ *   return <LoginForm onSubmit={login} />;
+ * }
+ * ```
+ *
+ * @returns Auth state ve işlemleri
+ * @throws {AuthError} Token geçersiz olduğunda
+ *
+ * @see {@link AuthProvider} — Gerekli context provider
+ * @see {@link usePermissions} — İlgili yetki hook'u
+ */
+```
+
+### Utility/Service Dokümantasyonu
+
+```typescript
+/**
+ * Tarih değerini kullanıcı dostu formata dönüştürür.
+ *
+ * Locale-aware formatlama yapar ve relative time desteği sunar.
+ *
+ * @param date - Formatlanacak tarih (Date, string veya timestamp)
+ * @param options - Formatlama seçenekleri
+ * @param options.format - Çıktı formatı ('short' | 'long' | 'relative')
+ * @param options.locale - Hedef locale (varsayılan: 'tr-TR')
+ * @returns Formatlanmış tarih string'i
+ *
+ * @example
+ * ```ts
+ * formatDate(new Date()) // "17 Şubat 2026"
+ * formatDate('2026-01-01', { format: 'relative' }) // "47 gün önce"
+ * formatDate(1708128000, { format: 'short' }) // "17.02.2026"
+ * ```
+ *
+ * @throws {TypeError} Geçersiz tarih değeri verildiğinde
+ */
+```
+
+---
+
+## Proje Seviyesi Dokümantasyon
+
+### README.md Şablonu
+
+```markdown
+# Proje Adı
+
+Kısa açıklama — projenin ne yaptığı, 1-2 cümle.
+
+## Özellikler
+
+- Özellik 1
+- Özellik 2
+- Özellik 3
+
+## Teknolojiler
+
+| Kategori | Teknoloji |
+|----------|-----------|
+| Framework | Next.js 15 |
+| Styling | Tailwind CSS 4 |
+| State | Zustand |
+| Test | Vitest + Testing Library |
+
+## Başlangıç
+
+### Gereksinimler
+
+- Node.js >= 20
+- pnpm >= 9
+
+### Kurulum
+
+\```bash
+pnpm install
+cp .env.example .env.local
+pnpm dev
+\```
+
+### Ortam Değişkenleri
+
+| Değişken | Açıklama | Zorunlu |
+|----------|----------|---------|
+| `DATABASE_URL` | PostgreSQL bağlantı URL'i | Evet |
+| `NEXT_PUBLIC_API_URL` | API base URL | Evet |
+
+## Proje Yapısı
+
+\```
+src/
+├── app/          → Next.js App Router sayfaları
+├── components/   → Paylaşılan UI component'leri
+├── features/     → Feature-based modüller
+├── hooks/        → Custom React hook'ları
+├── lib/          → Utility ve helper fonksiyonlar
+├── services/     → API service katmanı
+├── store/        → Global state yönetimi
+└── types/        → TypeScript tip tanımları
+\```
+
+## Script'ler
+
+| Komut | Açıklama |
+|-------|----------|
+| `pnpm dev` | Development server başlat |
+| `pnpm build` | Production build oluştur |
+| `pnpm test` | Test'leri çalıştır |
+| `pnpm lint` | Linting kontrolü |
+
+## Katkıda Bulunma
+
+[CONTRIBUTING.md](./CONTRIBUTING.md) dosyasına bakın.
+```
+
+### API Dokümantasyonu Şablonu
+
+```markdown
+# API Dokümantasyonu
+
+## Base URL
+\`\`\`
+Development: http://localhost:3000/api
+Production: https://api.example.com
+\`\`\`
+
+## Endpoints
+
+### Users
+
+#### GET /api/users
+Tüm kullanıcıları listeler.
+
+**Query Parameters:**
+| Parametre | Tip | Zorunlu | Açıklama |
+|-----------|-----|---------|----------|
+| page | number | Hayır | Sayfa numarası (varsayılan: 1) |
+| limit | number | Hayır | Sayfa başına kayıt (varsayılan: 20) |
+| search | string | Hayır | İsim veya email ile arama |
+
+**Response (200):**
+\`\`\`json
+{
+  "data": [{ "id": "1", "name": "John", "email": "john@example.com" }],
+  "meta": { "total": 100, "page": 1, "limit": 20 }
+}
+\`\`\`
+
+**Error Responses:**
+| Status | Code | Açıklama |
+|--------|------|----------|
+| 401 | UNAUTHORIZED | Token eksik veya geçersiz |
+| 500 | INTERNAL_ERROR | Sunucu hatası |
+```
+
+---
+
+## Dokümantasyon Kalite Kuralları
+
+### YAPILACAKLAR
+- Her public fonksiyon/component'e `@example` ekle
+- Parametre ve return tiplerini açıkla
+- Side effect'leri belirt (`@throws`, `@fires`, `@emits`)
+- İlgili dosyalara cross-reference ver (`@see`)
+- Deprecation uyarılarını ekle (`@deprecated`)
+
+### YAPILMAYACAKLAR
+- Kodun ne yaptığını tekrar etme (kodu oku zaten anlarsın)
+- Getter/setter gibi trivial fonksiyonları dokümante etme
+- Private/internal fonksiyonları aşırı dokümante etme
+- Tarihi bilgi ekleme ("Bu fonksiyon v2.0'da eklendi" gibi — git log var)
+
+### İyi vs Kötü Dokümantasyon
+
+```typescript
+// ❌ Kötü — kodu tekrar ediyor
+/** Kullanıcı ID'sini döndürür */
+function getUserId(): string { ... }
+
+// ✅ İyi — "neden" ve "ne zaman" açıklıyor
+/**
+ * Oturum açmış kullanıcının ID'sini döndürür.
+ * Auth context'ten okur; context dışında kullanılırsa hata fırlatır.
+ * @throws {AuthError} AuthProvider dışında çağrıldığında
+ */
+function getUserId(): string { ... }
+```
+
+---
+
+## Çıktı Formatı
+
+1. **Dokümantasyon planı** — Ne dokümante edilecek, hangi formatta
+2. **Mevcut stil analizi** — Projedeki dokümantasyon convention'ı
+3. **Kullanıcı onayı** — Plan uygun mu?
+4. **Dokümantasyon üretimi** — İnline JSDoc veya ayrı dosya
+5. **Gözden geçirme** — Eksik/tutarsız yer var mı kontrolü