Lesson 02 · 9 dk okuma

Custom commands tasarımı

Argüman alma, çoklu adım, tool kısıtlama, error handling, paylaşım.

Slash command sıradan bir prompt değil; çağrılabilir mini-skill. İyi tasarlanan command:

  1. Açık tetikleyici isim/release-notes, /triage (örnek anlamlı)
  2. Frontmatter description — “Use when…”
  3. $ARGUMENTS placeholder — kullanıcı argümanı
  4. Adım numaralandırması — Claude’a sırayı zorla
  5. Output format şablonu — tahmin etmesin
  6. “Yapma” listesi — sınırları belirt

İyi şablon

---
description: Use when generating release notes from latest tag
---

ADIMLAR:
1. `git log $ARGUMENTS..HEAD --oneline` ile commit listesini al
2. Her commit'i kategorile: Feature, Fix, Refactor, Docs, Other
3. Aşağıdaki şablona yerleştir

ŞABLON:
## v$NEW_VERSION

### ✨ Yeni
- ...

### 🐛 Düzeltme
- ...

KURALLAR:
- Markdown emoji'leri sadece kategori başlıkları için
- Commit hash'i yazma; sadece kısa açıklama
- "Other" kategorisi boşsa kaldır

Tool kısıtlama

Frontmatter’da tools: ile sınırla:

---
description: Lint check only — no writes
tools: Bash
---

Hata yönetimi

Claude bir komut prosedürü yarıda kalırsa kullanıcıya net mesaj versin:

EĞER `git log` boş dönerse: "Henüz commit yok, son tag'i kontrol et" yazıp dur.
EĞER `$ARGUMENTS` verilmemişse: "Önceki tag'i belirt: /release-notes v1.0.0" yazıp dur.

Sıradaki

Skills ekosistemi ve skill collection’lar.