Shrimp Task Manager

# 🚀 Task Viewer v3.0.0 Sürüm Notları *Sürüm Tarihi: 7 Ağustos 2025* ## 📑 İçindekiler - [🎉 Ana Yeni Özellikler](#-ana-yeni-özellikler) - [🤖 Ajan Yönetim Sistemi](#-ajan-yönetim-sistemi) - [🤖 AI Destekli Toplu Ajan Ataması](#-ai-destekli-toplu-ajan-ataması) - [📊 Görev Geçmişi için Git Sürüm Kontrolü](#-görev-geçmişi-için-git-sürüm-kontrolü) - [📊 Proje Geçmişi Görünümü](#-proje-geçmişi-görünümü) - [🎨 Şablon Yönetim Sistemi](#-şablon-yönetim-sistemi) - [🌍 Uluslararasılaştırma (i18n) Desteği](#-uluslararasılaştırma-i18n-desteği) - [🧭 Geliştirilmiş Navigasyon ve UI](#-geliştirilmiş-navigasyon-ve-ui) - [🔄 Önemli İyileştirmeler](#-önemli-iyileştirmeler) - [Görev Detay Navigasyonu](#görev-detay-navigasyonu) - [Performans İyileştirmeleri](#performans-iyileştirmeleri) - [Geliştirici Deneyimi](#geliştirici-deneyimi) - [UI/UX İyileştirmeleri](#uiux-iyileştirmeleri) - [🐛 Hata Düzeltmeleri](#-hata-düzeltmeleri) - [Kritik Düzeltmeler](#kritik-düzeltmeler) - [UI Düzeltmeleri](#ui-düzeltmeleri) - [Veri İşleme](#veri-i̇şleme) - [🏗️ Teknik Güncellemeler](#️-teknik-güncellemeler) - [Yeni Bağımlılıklar](#yeni-bağımlılıklar) - [API İyileştirmeleri](#api-iyileştirmeleri) - [Mimari İyileştirmeler](#mimari-iyileştirmeler) - [📝 Uyumsuz Değişiklikler](#-uyumsuz-değişiklikler) - [Yapılandırma Güncellemeleri](#yapılandırma-güncellemeleri) - [API Değişiklikleri](#api-değişiklikleri) - [🚀 Migrasyon Kılavuzu](#-migrasyon-kılavuzu) - [🎯 Özet](#-özet) ## 🎉 Ana Yeni Özellikler ### 🤖 Ajan Yönetim Sistemi **Özelleşmiş görev işleme için kapsamlı alt-ajan yönetimi** SHRIMP-TASK-MANAGER artık farklı türdeki görevler için özelleşmiş AI ajanları tanımlayıp kullanmanıza olanak sağlayan güçlü ajan yönetim yetenekleri destekliyor. Ajanlar, optimal yürütme için görevlere atanabilen özelleşmiş AI kişilikleri veya beceri setleridir. Bu özellik Claude'nin ajan sistemiyle sorunsuz entegre olur ve `.claude/agents` klasörünüzde saklanan özel ajanları kullanmanızı sağlar. Ana yetenekler şunları içerir: - **Ajan Liste Görünümü**: `.claude/agents` klasörünüzdeki tüm mevcut ajanları detaylı bilgilerle birlikte tarayın - **Ajan Atama**: Görev tablosundaki dropdown üzerinden görevlere özel ajanlar atayın - **Ajan Görüntüleyici Popup'ı**: Görev tablosundaki göz simgesine (👁️) tıklayarak farklı ajanlar arasında gezinebileceğiniz ve her görev için uygun olanı seçebileceğiniz popup ajan görüntüleyiciyi açın - **Ajan Editörü**: Ajan metadata'sı için renk özelleştirmesi bulunan yerleşik editör - **Global ve Proje Ajanları**: Projeye özel ve global ajan tanımları desteği - **Tek Tıkla AI Talimatları**: Robot emojisine tıklayarak ajana özel talimatları panoya kopyalayın - **Ajan Liste AI Talimatları**: Ajan listesinde robot emojili (🤖) yeni AI Talimat sütunu ile Claude'de doğrudan kullanım için `use subagent [agent-name] located in [path]:` kopyalar - **Ajan Bilgi Modalı**: Ajanlar arası navigasyon ile detaylı ajan bilgileri - **Metadata Entegrasyonu**: Ajan atamaları doğrudan tasks.json'a kaydedilir - **Renk Kodlama**: Özel renkler kullanarak ajanların görsel ayrımı #### Ajan Atama İş Akışı: 1. **Mevcut Ajanları Görüntüle**: `.claude/agents` klasörünüzdeki tüm ajanları görmek için Ajanlar sekmesine erişin 2. **Görevlere Ata**: Her görev için bir ajan seçmek üzere görev tablosundaki dropdown'ı kullanın 3. **Talimatları Kopyala**: Robot emojisine tıklayarak kopyalayın: `use the built in subagent located in ./claude/agents/[agent-name] to complete this shrimp task: [task-id] please when u start working mark the shrimp task as in progress` 4. **Ajanları Düzenle**: Özel renkler dahil ajan içeriği ve metadata'sını değiştirin  *Ajan Liste Görünümü AI Talimat sütunuyla birlikte tüm mevcut ajanları gösterir - `use subagent debugger.md located in ./claude/agents to perform:` gibi ajan kullanım talimatlarını doğrudan panoya kopyalamak için robot emojisine (🤖) tıklayın*  *Görev tablosundaki dropdown seçiciyi kullanarak görevlere ajan atayın*  *Göz simgesine (👁️) tıklayarak ajan görüntüleyici popup'ını açın ve görev ataması için mevcut ajanları tarayın*  *Görsel organizasyon için ajan içeriğini düzenleyin ve renklerle özelleştirin*  *Ajana özel görev talimatlarını kopyalamak için robot emojisine tıklayın*  *Detaylı bilgi ve kolay navigasyon ile ajanları tarayın*  *Sistem genelindeki ajanlara erişmek için global Claude klasör yolunu yapılandırın* ### 🤖 AI Destekli Toplu Ajan Ataması **OpenAI GPT-4 kullanarak birden çok göreve otomatik olarak en uygun ajanları atayın** Task Viewer artık görev açıklamaları ve gereksinimlerine dayalı olarak görevlere zekice ajan atamak için OpenAI'nin GPT-4'ü ile entegre oluyor. Bu özellik, çok sayıda görevi uygun ajanlarla yapılandırmak için gereken zamanı önemli ölçüde azaltıyor. Ana özellikler şunları içerir: - **Toplu Seçim**: Görev tablosundaki onay kutularını kullanarak birden çok görevi seçin - **Tek Tıkla Atama**: Seçili tüm görevlere otomatik ajan atamak için "AI Ajan Ata"ya tıklayın - **Akıllı Eşleştirme**: GPT-4 optimal atamalar yapmak için görev açıklamalarını ve ajan yeteneklerini analiz eder - **Global Ayarlar Entegrasyonu**: Global Ayarlar sekmesinde OpenAI API anahtarınızı yapılandırın - **Çevre Değişkeni Desteği**: `OPENAI_API_KEY` veya `OPEN_AI_KEY_SHRIMP_TASK_VIEWER` çevre değişkenlerini de destekler - **Hata Rehberliği**: API anahtarı yapılandırılmadıysa net talimatlar sağlanır #### Kurulum Talimatları: 1. **API Anahtarını Yapılandır**: Ayarlar → Global Ayarlar'a gidin ve OpenAI API anahtarınızı girin 2. **Görevleri Seç**: Ajan ataması gereken görevleri seçmek için onay kutularını kullanın 3. **AI Ataması**: Toplu işlem çubuğundaki "🤖 AI Ajan Ata" düğmesine tıklayın 4. **Otomatik İşleme**: GPT-4 görevleri analiz edip en uygun ajanları atayacak  *AI destekli ajan ataması için Global Ayarlar'da OpenAI API anahtarınızı yapılandırın*  *Birden çok görevi seçin ve GPT-4 kullanarak uygun ajanları otomatik atamak için "🤖 AI Ajan Ata (5 görev seçili)" düğmesine tıklayın* ### 📊 Görev Geçmişi için Git Sürüm Kontrolü **Otomatik Git commit'leri görevlerinizdeki her değişikliği takip eder** SHRIMP-TASK-MANAGER artık tasks.json dosyanızdaki tüm değişiklikleri otomatik olarak takip eden yerleşik Git entegrasyonu içeriyor. Bu, manuel müdahale olmaksızın görev değişikliklerinin tam denetim izini sağlar. Ana özellikler şunları içerir: - **Otomatik Git Repository**: İlk kullanımda veri dizininizde bir Git repository'si başlatır - **Zaman Damgalı Commit'ler**: Her görev operasyonu (oluşturma, güncelleme, silme) yerel saat dilimi zaman damgalarıyla commit oluşturur - **Açıklayıcı Mesajlar**: Commit'ler neyin değiştiğine dair açık açıklamalar içerir (örn: "Yeni görev ekle: Kullanıcı kimlik doğrulaması uygula") - **Engelleyici Değil**: Git operasyonları try-catch bloklarında sarılıdır - Git başarısız olursa görev operasyonları normal şekilde devam eder - **İzole Repository**: Git repository'si yalnızca görev geçmişi içindir, proje repository'nizden tamamen ayrıdır - **Merge Çakışması Yok**: Doğrusal geçmişli tek dosya takibi çakışmaları imkansız kılar #### Faydalar: - **Tam Geçmiş**: Standart Git araçlarını kullanarak görevlerinizin tüm evrimini inceleyin - **Değişiklik Takibi**: Görevlerin tam olarak ne zaman ve nasıl değiştirildiğini görün - **Kurtarma Seçenekleri**: Gerekirse önceki görev durumlarını geri yükleyin - **Ekip Görünürlüğü**: Görev geçmişini ekip üyeleriyle paylaşın Git entegrasyonu tamamen şeffaftır ve yapılandırma gerektirmez. Geçmişi istediğiniz zaman şu komutla görüntüleyebilirsiniz: ```bash cd <shrimp-data-directory> git log --oneline ``` #### Görev Geçmişini Görüntüleme 1. **Görev veri dizininize gidin** (`.mcp.json` dosyanızda yapılandırıldığı şekilde): ```bash cd <shrimp-data-directory> ``` 2. **Commit geçmişini görüntüle**: ```bash git log --oneline ``` 3. **Belirli değişiklikleri gör**: ```bash git show <commit-hash> ``` 4. **Sürümleri karşılaştır**: ```bash git diff HEAD~5 # 5 commit öncesiyle karşılaştır ``` 5. **Önceki durumu geri yükle** (gerekirse): ```bash git checkout <commit-hash> -- tasks.json ``` ### 📊 Proje Geçmişi Görünümü **Projenizin görev yürütme geçmişini takip edin ve analiz edin** SHRIMP-TASK-MANAGER yeni bir görev oturumu başlattığınızda tamamlanmış görevleri otomatik olarak projenizin içindeki bellek dosyalarına kaydeder. Daha önce bu değerli geçmiş verileri bu bellek dosyalarında gizliydi ve UI üzerinden erişilemiyordu. Yeni Proje Geçmişi Görünümü bu görev geçmişini açığa çıkarır ve projenizin zaman içinde nasıl evrimleştiğini keşfetmenizi sağlar. Bu özellik şunları yapmanızı sağlar: - **Geçmiş Görev Anlık Görüntüleri**: SHRIMP-TASK-MANAGER tarafından kaydedilen projenizin geçmiş durumlarını tarayın - **Görev Evrim Takibi**: Görevlerin farklı oturumlarda oluşturulması ile tamamlanması arasında nasıl ilerlediğini görün - **Not Sistemi**: Gelecek referans ve ekip bilgi paylaşımı için geçmiş girişlere kişisel notlar ekleyin - **Detaylı Görev Görünümü**: Geçmiş kararları ve uygulamaları anlamak için belirli geçmiş görev durumlarını derinlemesine inceleyin - **Zamana Dayalı Navigasyon**: Ne zaman neyin tamamlandığını görmek için projenizin zaman çizelgesinde gezinin - **Anlık Görüntü Karşılaştırması**: Proje büyümesi ve değişikliklerini takip etmek için farklı zaman dönemlerindeki görev durumlarını karşılaştırın   ### 🎨 Şablon Yönetim Sistemi **AI görev yürütme için güçlü şablon özelleştirmesi** Şablonlar, SHRIMP-TASK-MANAGER'ı farklı operasyon türlerini analiz etme ve yürütme konusunda yönlendiren temel talimatlardır. AI'nin planlama ve analizden uygulama ve doğrulamaya kadar farklı operasyon türlerine nasıl yaklaşması gerektiğini tanımlarlar. MCP-TASK-MANAGER varsayılan davranışları geçersiz kılabilen veya mevcut şablonlara ek talimatlar ekleyebilen özel şablonlara izin verir. Bu yeni Şablon Yönetim arayüzü şunlar için sezgisel bir yol sağlar: - **Şablon Editörü**: Özel AI talimatları oluşturmak için sözdizimi vurgulamalı tam özellikli markdown editörü - **Şablon Önizleme**: Gereksinimlerinizi karşıladığından emin olmak için etkinleştirme öncesi şablonların canlı önizlemesi - **Şablon Çoğaltma**: Farklı kullanım durumları için mevcut şablonların varyasyonlarını kolayca oluşturun - **Şablon Durum Takibi**: Varsayılan (orijinal), Özel (tamamen değiştirilmiş) ve Özel+Ekle (varsayılana eklemeler) durumlarını gösteren görsel göstergeler - **Varsayılana Sıfırla**: Gerektiğinde orijinal şablonları tek tıkla geri yükleme - **Şablon Dışa Aktarma**: Yedekleme, ekip üyeleriyle paylaşım veya sürüm kontrolü için özel şablonlarınızı dışa aktarın - **Etkinleştirme Diyalogu**: Kazara değişiklikleri önlemek için şablon etkinleştirme sırasında net onay  ### 🌍 Uluslararasılaştırma (i18n) Desteği **Sorunsuz dil değiştirme ile çok dilli destek** - **Desteklenen Üç Dil**: İngilizce (en), Çince (中文) ve İspanyolca (Español) - **Kalıcı Dil Seçimi**: Dil tercihiniz kaydedilir ve hatırlanır - **Tam UI Çevirisi**: Tüm UI öğeleri, düğmeler, etiketler ve mesajlar tamamen çevrilmiştir - **Dinamik Dil Değiştirme**: Sayfa yenileme olmaksızın anında dil değiştirme - **Dil Bağlam Sağlayıcısı**: Tutarlı çeviriler için merkezi dil yönetimi ### 🧭 Geliştirilmiş Navigasyon ve UI **Modern, sezgisel arayüz iyileştirmeleri** - **İç İçe Sekme Sistemi**: Birincil ve ikincil sekmelerle düzenlenmiş navigasyon - **URL Durum Senkronizasyonu**: Mevcut görünümü yansıtmak için tarayıci URL'si güncellenir - **Görev Detay Navigasyonu**: Önceki/Sonraki düğmeleri listeye dönmeden sıralı görev incelemesine olanak tanır - **Yükleme Döndürücüleri**: Veri yükleme sırasında görsel geri bildirim - **Toast Bildirimleri**: Müdahaleci olmayan başarı/hata mesajları - **Duyarlı Tasarım**: Geliştirilmiş mobil ve tablet deneyimi - **Modal İyileştirmeleri**: Daha iyi modal düzenler ve etkileşimler - **Klavye Navigasyonu**: Detay görünümünde daha hızlı görev navigasyonu için ok tuşu desteği ## 🔄 Önemli İyileştirmeler ### Görev Detay Navigasyonu **Sorunsuz görev inceleme iş akışı** Görev Detayları görünümü artık görevleri nasıl incelediğinizi ve onlarla çalıştığınızı dönüştüren Önceki/Sonraki navigasyon düğmelerini içeriyor: - **Sıralı Navigasyon**: Ana listeye dönmeden görevler arasında sırayla hareket edin - **Bağlam Korunması**: Görevler arasında geçiş yaparken detay görünümünde kalın - **Görsel Göstergeler**: Düğmeler görev numaralarını gösterir (örn: "← Önceki (Görev 3)" ve "Sonraki (Görev 5) →") - **Akıllı Sınırlar**: İlk ve son görevlerde navigasyon düğmeleri devre dışı bırakılır - **Klavye Kısayolları**: Daha da hızlı navigasyon için ok tuşlarını kullanın - **Verimlilik Artışı**: İleri geri tıklamaktan 3-5 kat daha hızlı tüm görev listesini inceleyin Bu özellik özellikle şu durumlarda değerlidir: - AI analizinden yeni oluşturulan görevleri inceleme - Bir dizi bağımlı görev üzerinde çalışma - Birden çok ilgili görevde uygulama detaylarını kontrol etme - Görev denetimleri veya incelemeler gerçekleştirme ### Performans İyileştirmeleri - **Optimize Edilmiş Yeniden Render'lar**: Daha iyi performans için React hook'ları uygun şekilde memoize edildi - **Lazy Loading**: Daha hızlı başlangıç sayfa yükleme için isteğe bağlı bileşen yükleme - **Verimli Durum Yönetimi**: Gereksiz durum güncellemeleri azaltıldı - **Batch Güncellemeler**: Daha pürüzsüz UI için çoklu durum değişiklikleri gruplandırıldı ### Geliştirici Deneyimi - **Kapsamlı Test Paketi**: Entegrasyon ve dil özellik testleri eklendi - **Test Kontrol Listeleri**: Yapılandırılmış test dokümantasyonu - **Daha İyi Hata İşleme**: Daha bilgilendirici hata mesajları - **Debug Loglama**: Geliştirme için geliştirilmiş debug yetenekleri ### UI/UX İyileştirmeleri - **Geliştirilmiş Görev Tablosu**: Daha iyi sütun boyutlandırması ve metin sarma - **Geliştirilmiş Modaller**: Tutarlı modal stillendirmesi ve davranışı - **Daha İyi Tipografi**: Güncellenmiş font boyutlarıyla geliştirilmiş okunabilirlik - **Renk Şeması Güncellemeleri**: Daha erişilebilir renk kontrastları - **İkon Tutarlılığı**: Uygulama genelinde birleşik ikon kullanımı ## 🐛 Hata Düzeltmeleri ### Kritik Düzeltmeler - **useRef Hook Hatası**: Uygulama çökmelerine neden olan eksik React hook import'u düzeltildi - **Çeviri Anahtarları**: Desteklenen tüm diller için eksik çeviri anahtarları eklendi - **Sembolik Bağlantı Döngüsü**: Screenshots dizini sonsuz döngü sorunu çözüldü - **Windows Yol İşleme**: Windows 11'de file:// URI sorunları düzeltildi - **Repository Bağlantıları**: Tüm repository referansları düzeltildi ### UI Düzeltmeleri - **Modal Z-index**: Modal katmanlama sorunları düzeltildi - **Sekme Seçimi**: Sayfa yenilemeleri boyunca sekme kalıcılığı düzeltildi - **Dil Seçici**: Durum senkronizasyon sorunları düzeltildi - **Kopyalama İşlevi**: Pano işlemlerinin güvenilirliği artırıldı - **Duyarlı Düzen**: Mobil viewport sorunları düzeltildi ### Veri İşleme - **Profil Yükleme**: Profil değiştirirken yarış koşulları düzeltildi - **Görev Yenileme**: Otomatik yenileme güvenilirliği artırıldı - **Geçmiş Yükleme**: Geçmiş görünümündeki sayfalama sorunları düzeltildi - **Şablon Kaydetme**: Şablon kalıcılık hataları çözüldü ## 🏗️ Teknik Güncellemeler ### Yeni Bağımlılıklar - `@headlessui/react`: Modern UI bileşenleri - `@tanstack/react-table`: Gelişmiş tablo işlevselliği - `@uiw/react-md-editor`: Şablonlar için Markdown düzenleme - TypeScript desteği için ek tip tanımları ### API İyileştirmeleri - **GET /api/templates**: Tüm mevcut şablonları listele - **PUT /api/templates/:name**: Şablon içeriğini güncelle - **POST /api/templates/:name/duplicate**: Şablonları çoğalt - **GET /api/history/:profileId**: Proje geçmişini getir - **Geliştirilmiş Hata Yanıtları**: Daha detaylı API hata mesajları ### Mimari İyileştirmeler - **Bileşen Modülerliği**: Daha iyi endişe ayrımı - **Özel Hook'lar**: Yeniden kullanılabilir mantık hook'lara çıkarıldı - **Bağlam Sağlayıcıları**: Merkezi durum yönetimi - **Yardımcı Fonksiyonlar**: Yaygın işlemler için paylaşılan yardımcı programlar ## 📝 Uyumsuz Değişiklikler ### Yapılandırma Güncellemeleri - **Dil Ayarları**: Yeni dil tercihi depolama formatı - **Şablon Depolama**: Şablonlar artık kullanıcı ana dizininde depolanıyor - **URL Yapısı**: Daha iyi navigasyon için güncellenmiş URL desenleri ### API Değişiklikleri - **Profil Endpoint'leri**: Daha fazla metadata içeren güncellenmiş yanıt formatları - **Görev Endpoint'leri**: Ek filtreleme seçenekleriyle geliştirildi - **Şablon Endpoint'leri**: Şablon yönetimi için yeni endpoint yapısı ## 🚀 Migrasyon Kılavuzu ### v2.1'den v3.0'a 1. **Dil Seçimi**: Varsayılan diliniz İngilizce olacak; yeni seçiciden tercih ettiğiniz dili seçin 2. **Şablonlar**: Mevcut özel şablonlar korunacak ancak yeniden etkinleştirme gerekebilir 3. **Tarayıcı Önbelleği**: Optimal performans için tarayıcı önbelleğini temizleyin 4. **Profil Verileri**: Tüm mevcut profiller değişiklik olmadan çalışmaya devam edecek ## 🎯 Özet Sürüm 3.0, Task Viewer için basit bir görev görselleştirme aracından kapsamlı bir görev yönetimi ve özelleştirme platformuna dönüşümü temsil eden büyük bir sıçramayı ifade ediyor. Tam uluslararasılaştırma desteği, güçlü şablon yönetimi, AI destekli otomasyon ve Git tabanlı geçmiş takip yetenekleri ile bu sürüm, takımlara AI destekli geliştirme iş akışları üzerinde eşi görülmemiş kontrol sağlıyor. Bu sürümün ana vurgu noktaları şunlardır: - **AI Destekli Ajan Ataması**: Görevlere en uygun ajanları otomatik atamak için GPT-4'ten yararlanın - **Git Sürüm Kontrolü**: Zaman damgalı commit'lerle tüm görev değişikliklerinin otomatik takibi - **Çok Dilli Destek**: İngilizce, Çince ve İspanyolca ile tam uluslararasılaştırma - **Şablon Yönetimi**: Şablon düzenleme yoluyla AI davranışının derinlemesine özelleştirilmesi - **Geçmiş Görünümleri**: Git commit'leri ve bellek anlık görüntüleri aracılığıyla proje evriminin tam görünürlüğü Üç dil desteğinin eklenmesi (İngilizce, Çince, İspanyolca) aracı küresel bir kitle için erişilebilir hale getirirken, şablon yönetim sistemi AI davranışının derinlemesine özelleştirilmesine olanak tanıyor. Git entegrasyonu tüm görev değişikliklerinin kalıcı denetim izini sağlar ve AI destekli toplu atama özelliği görev yapılandırmasını önemli ölçüde hızlandırır. Bu sürüm gelecekteki iyileştirmeler için temel oluşturur ve Task Viewer'ı modern AI destekli geliştirme araç kitinde vazgeçilmez bir araç olarak konumlandırır.