| name | gunluk-ozet |
| description | O gün yapılan tüm değişiklikleri (git commit'leri + commit'lenmemiş değişiklikler) toplayıp, başkalarının anlayabileceği sade bir Türkçe özet olarak markdown dosyasına yazar. Dosya isimleri değil, NE yapıldığını ve NEDEN yapıldığını anlatır. Kullanıcı "günlük özet", "bugün ne yaptım", "gün sonu raporu", "değişiklikleri md yap" gibi bir şey istediğinde kullan. |
Günlük Değişiklik Özeti
Amaç: Bir günün sonunda yapılan işleri, teknik olmayan biri bile anlayabilecek şekilde
özetleyip paylaşılabilir bir markdown dosyasına yazmak. Ham git çıktısı değil, insan dili.
Adım 1 — O günün değişikliklerini topla
Bugünün commit'lerini al:
git log --since="00:00" --until="now" --pretty=format:"%h %s" --stat
Commit'lenmemiş (henüz devam eden) değişiklikleri de dahil et:
git status --short
git diff --stat
Değişikliklerin ne olduğunu gerçekten anlamak için ilgili diff'lere bak (sadece dosya
adına bakma):
git log --since="00:00" -p
git diff
Not: Eğer bugün hiç değişiklik yoksa, kullanıcıya bildir ve son değişiklik gününü öner
(git log -1 --format=%cd), o günü özetlemeyi teklif et.
Adım 2 — Anlamlı grupla ve sadeleştir
Değişiklikleri konuya göre grupla, dosya dosya listeleme:
- Yeni özellikler / endpoint'ler
- Düzeltmeler (bug fix)
- Altyapı / yapılandırma (Docker, migration, config)
- Dokümantasyon
Her madde için:
- Ne yapıldığını sade dille yaz (ör. "Kategoriler için tam CRUD API'si eklendi")
- Gerekiyorsa neden yapıldığını ekle (ör. "aynı isimde kategori engellensin diye unique kısıtı eklendi")
- Teknik jargonu minimuma indir; kullanılan teknoloji adı gerekliyse parantezle ver
Yapma:
app.module.ts değiştirildi gibi dosya-seviyesi ifadeler (bunun yerine "modül sisteme bağlandı")- Ham commit hash'leri listesi
- İç içe teknik ayrıntı yığını
Adım 3 — Markdown dosyasına yaz
Dosyayı docs/gunluk/YYYY-MM-DD.md yoluna yaz (klasör yoksa oluştur). Tarihi bugünün
gerçek tarihinden al.
Şablon:
# Günlük Özet — <GG.AA.YYYY>
## Özet
<2-3 cümlelik, o günün en önemli çıktısı>
## Yapılanlar
### ✨ Yeni Özellikler
- ...
### 🐛 Düzeltmeler
- ...
### 🔧 Altyapı / Yapılandırma
- ...
### 📄 Dokümantasyon
- ...
## Notlar / Sıradaki İşler
- <varsa yarım kalan işler veya bir sonraki adım>
Boş olan bölümleri (o gün o kategoride iş yoksa) şablondan çıkar — sadece dolu başlıklar kalsın.
Adım 4 — Kullanıcıya bildir
Dosyayı oluşturduktan sonra:
- Dosyanın yolunu ver
- Özetin markdown önizlemesini sohbete de yaz ki kullanıcı hemen görsün
- İstenirse PR açıklamasına / issue yorumuna yapıştırılabilir formatta olduğunu belirt
Notlar
- Tek bir kişinin o günkü işini özetliyorsun; "biz" yerine sade, nötr bir dil kullan.
- Tarih/gün belirsizse bugünü varsay; kullanıcı "dün" veya belirli bir tarih derse
--since/--until aralığını ona göre ayarla.
- Amaç ekip içi paylaşım — okuyan kişi kodu görmeden ne olduğunu anlayabilmeli.
