Özel Agent'lar

Claude Code ile Yazılım Geliştirme

Dani Zysman

AI Curriculum Manager @ DataCamp

Agent Nedir?

Farklı araçlara sahip uzman robot asistanlardan oluşan bir ekip

Agent'lar, Claude Code içinde uzmanlaşmış yapay zeka asistanlarıdır:

Her birinin belirli yetenekleri vardır, bağımsız çalışır
Yerleşik olabilir veya özel oluşturulabilir

Yerleşik Agent'lar

Agent	Amaç	Ne Zaman Kullanılır
Explore	Salt-okunur codebase inceleme	"Bu mimariyi haritala"
Plan	Araştır ve strateji oluştur	"Buna nasıl yaklaşmalıyız?"
General	Tam araçlarla görev yürütme	Çoğu iş için varsayılan

Tüm mevcut agent'ları listelemek için /agents kullan

Neden Özel Agent Oluşturulur?

Özelleşmiş görevler için özel agent'lar

Faydalar: Tekrar kullanılabilir, tutarlı, ekiple paylaşılabilir
Yaygın kullanım alanları:
- Code review - ekip standartlarını uygula
- Güvenlik denetimi - açıkları kontrol et
- Dokümantasyon - tutarlı doküman üret
- Test - test vakaları öner

Bir Agent Dosyası Oluşturma

Dosya konumu:
- .claude/agents/code-reviewer.md
Gerekli bölümler:
- name: Agent tanımlayıcısı
- description: Ne tetiklediği
- Gövde: Markdown içinde talimatlar

___
# code-reviewer.md
name: code-reviewer
description: Reviews code for 
best practices
___
Check for:
1. Clear naming conventions
2. Proper error handling
3. Performance concerns

Code Reviewer Özel Agent'ı Oluşturma

> /agents

> [Select] Create new agent

> [Select] Project level (.claude/agents)

> [Select] Generate with Claude (recommended)

>  Create a code reviewer agent that reviews code for naming, error handling, 
and performance.

Oluşturulan dosyayı incele ve onayla.

Şu Ana Kadarki Proje

music-analytics-api/
  app.py
  routes.py        # <- Bu dosyayı inceleyeceğiz
  models.py
  analytics.py
  CLAUDE.md
  .claude/
    agents/
      code-reviewer.md  # <- Özel agent'ımız

Agent'lar Ne Zaman Ürer?

Alt agent yok (doğrudan çalışır):

"routes.py'deki hatayı düzelt"
  -> Claude halleder

"Buraya doğrulama ekle"
  -> Claude halleder

Alt agent başlatır:

"Mimariyi haritala"
  -> Explore agent

"Nasıl refactor etmeliyiz?"
  -> Plan agent

Özel Agent'ımızı Kullanma

> @code-reviewer review @routes.py

İnceleme Tamamlandı

Hızlı Düzeltmeler:
- Kullanılmayan `session` import'unu kaldır (satır 3)
- Sabit `* 5` popülerlik metriğini adlandırılmış bir sabitle değiştir

Yapısal Sorunlar:
- get_album_stats() ve get_average_tracks() içinde albüm sözlükleri iki kez oluşturuluyor; ortak bir yardımcıya çıkar
- get_artist_albums() sanatçı yoksa boş liste döndürüyor; önce sanatçıyı doğrula
- artist_id parametresinde aralık doğrulaması yok
Bunlardan herhangi birini düzeltmemi ister misin?

Agent Faydaları

Güvenli keşif için koruyucu kalkanlı bir büyüteç

Ayrı bağlam
- Agent'lar yalıtılmış çalışır
- Ana konuşma temiz kalır
Güvenli keşif
- Explore agent salt-okunurdur
- Yabancı codebase'ler için idealdir

Agent'ları Ne Zaman Kullanmalı

Soru Türü	Ne Olur
"Bu fonksiyon ne yapar?"	Claude doğrudan yanıtlar
"Auth bu codebase'de nasıl çalışıyor?"	Explore agent araştırır
"Bunu refactor etmek için en iyi yaklaşım ne?"	Plan agent araştırır
"code review @routes.py"	Özel agent tarafından ele alınır

Hadi pratik yapalım!

Claude Code ile Yazılım Geliştirme