2026 Yılında Herkesin Kullanması Gereken AI Ajan Bellek Yığını (Geliştirici Kılavuzu)

modeliniz ve koşum takımınız artık önemli değil.

asıl önemli olan şey.....

paylaştığınız kişisel bağlam/bellek

Giriş

Size, kodlama ajanlarınız için nasıl paylaşımlı bir bellek oluşturacağınızı göstereceğim... böylece bir sonraki araç, daha önce verdiğiniz kararları bulabilecek.

Claude'daki mimari tartışması, Codex'teki hata ayıklama oturumu, Cursor'da gömülü olan açıklama... araçları değiştirdiğinizde, başka bir oturum başlattığınızda veya bir ay sonra projeye geri döndüğünüzde hâlâ kullanılabilir olması gereken faydalı çalışmalar.

Kısacası; 3.845 kelimenin tamamını okumak istemiyorsanız, bu GitHub deposunu ajanınıza verin ➡️ https://github.com/codejunkie99/agentic-stack-desktop

Tüm bunları Codex Harness'te Kimi K3 kullanarak oluşturdum. Video, Bilgisayar Kullanımı için Cua ile Kimi K3 kullanılarak yapıldı ve düzenlendi.

Bu, ilk içe aktarmanızdan, bir ajanın daha önceki bir kararı kurtarabildiği, bunu mevcut kodla kontrol edebildiği, sınırlı bir değişiklik yapabildiği ve arkasında faydalı bir şey bırakabildiği bir iş akışına kadar, agentic stack desktop için bir geliştirici rehberidir.

İşte alacağınız şeyler:

1. temel: araçları değiştirdiğinizde ne hayatta kalır
2. en hızlı yol: değerlendirebileceğiniz bir çalışma alanı oluşturun
3. çalışan kurulum: araştırmayı uygulamadan ayırın
4. proje alıştırması: tüm döngü boyunca yinelenen bir hatayı ele alın
5. paylaşılan katman: diğer araçlarınıza getirmeyi dahil edin
6. dayanıklı katman: neyin derse dönüşmeyi hak ettiği
7. işletim kuralları: kısa, sınırlı, denetlenebilir
8. özel yapı: çalışma alanını gerçek bir sürtünme noktası etrafında değiştirin
9. ölçeklendirme: önceki döngünün bir boşluk ortaya çıkardığı yere kapsam ekleyin
10. yapım sayfası

1. temel: araçları değiştirdiğinizde ne hayatta kalır

Bir öğleden sonranızı bir özelliğin nasıl çalışması gerektiğine karar vererek geçirdiğinizi hayal edin. Alternatifleri keşfettiniz, bir kısıtlama buldunuz, bariz çözümü reddettiniz ve sonunda uygun olan bir şeye karar verdiniz.

Uygulama kaydedilir. Açıklama bir sohbette kalır.

Bir hafta sonra, başka bir ajan koda bakar ve daha önce reddettiğiniz yaklaşımın aynısını önerir. Kendisine sunulan bilgilerle bu makul bir öneri bile olabilir. Eksik parça, sizi farklı seçmeye iten tartışmadır.

Mantık yürütmeyi kurtarılabilir kılın

Buradan başlayın: bu tartışmayı kurtarılabilir kılın, ardından bir sonraki ajanın harekete geçmeden önce kontrol etmesini sağlayın.

Agentic stack, Claude Code, Codex, OpenCode ve Cursor'dan aranabilir, seçilmiş geçmişe sahip yerel bir macOS çalışma alanı sağlar. Claude Code ve Codex ayrıca resmi CLI'leri aracılığıyla da yürütülür; Cursor ve OpenCode şu anda yalnızca bağlam sağlar. depoya genel bakış

Aşağıdaki iş akışı, bu yetenekleri nasıl kullanacağımı gösteriyor. Kısa bilgiler, sorumluluk dağılımı ve proje alıştırması, uyarlayabileceğiniz önerilen çalıştırma uygulamalarıdır.

2. en hızlı yol: değerlendirebileceğiniz bir çalışma alanı oluşturun

Anladığınız bir depoyla başlayın. Önemli dosyaları bildiğiniz, yakın zamanda verdiğiniz bir kararı hatırladığınız ve kötü bir tavsiyeyi tanıyabileceğiniz bir şey seçin.

Bildiğiniz bir proje size bir referans noktası verir. Alışılmadık kod ve alışılmadık geçmişle başlarsanız, aynı anda hem aracı doğrulamaya hem de sistemi öğrenmeye çalışıyor olursunuz.

Bir kaynak derlemesi için belgelenen gereksinimler arasında macOS 14+, Python 3.10+, Xcode Komut Satırı Araçları ve bir Swift 6 araç zinciri bulunur. Çalıştırmak istediğiniz kodlama CLI'sını kurun ve oturum açın. gereksinimler

1git clone https://github.com/codejunkie99/agentic-stack-desktop.git
2cd agentic-stack-desktop
3./install.sh desktop --build

Deponuzu uygulamada açın ve Rehberli kurulumu tamamlayın. Bu, geçici imzalama ile bir önizlemedir, bu nedenle macOS ilk başlatmada onay gerektirebilir. kurulum

İlk kabul kontrolünü ayarlayın

Herhangi bir şeyi içe aktarmadan önce, ilk ajanın cevaplamasını istediğiniz soruyu yazın. Örneğin: dışa aktarma işimiz neden kayıtları gruplar halinde işliyor ve mevcut uygulama hâlâ bu sınıra ihtiyaç duyuyor mu?

Bu soru ilk kabul kontrolünüz olur. Doğru kararı, doğru destekleyici kodu ve ajanın belirleyemediği her şeyin dürüst bir açıklamasını arıyorsunuz.

2.1 ilk içe aktarma: bulmaya değer bir karar verin

Bilgi Grafiği → Grafik → Belleği İçe Aktar'ı açın, kaynakları önizleyin ve dahil edilmesini istediğiniz materyali seçin.

Grafik, konulara, depo bağlantılarına ve kaynağa dayalı bağlantılarla SQLite tam metin araması kullanır; orijinal sohbet depoları değişmeden kalır. içe aktarma davranışı

Hatırladığınız bir kararı içeren tamamlanmış bir sohbetle başlardım. Özellikle de nihai koddan belli olmayacak bir kısıtlama nedeniyle çekici bir şeyi reddettiğiniz bir sohbet.

İçe aktardıktan sonra bu kararı arayın. Sonucu açın ve kaynağı inceleyin. Almak istediğiniz sohbete baktığınızdan ve ne olduğunu anlamak için yeterli açıklamaya sahip olduğunuzdan emin olun.

Tekrar bulup bulamayacağınızı test edin

Ardından, gelecek ay doğal olarak kullanacağınız kelime dağarcığını kullanarak ikinci bir arama yapın. Özellik adını hatırlayabilirsiniz, ancak sohbet dahili bir modül adı kullanmış olabilir. Bu uyumsuzluğu şimdi bulmak, materyali daha sonra nasıl alacağınızı anlamanıza yardımcı olur.

İlk koleksiyonu manuel olarak inceleyebileceğiniz kadar küçük tutardım. Bilinen bir kaynaktan gelen doğru bir cevap, iş akışının çalıştığına dair faydalı bir kanıttır.

Büyük bir içe aktarma sayısı, sisteme ne kadar materyal girdiğini söylerken, kullanışlılığının test edilmesini sağlar.

Başka bir görev size bir neden verdiğinde koleksiyonu genişletin.

2.2 ilk çalışma oturumu: deneyi bitirebilecek kadar küçük yapın

Başka bir yapılandırma ekranı açmadan önce ilk kuruluma bir bitiş çizgisi koyardım. Oturumun sonunda, bilinen bir kararı kurtarmış, depoya karşı kontrol etmiş ve başka birine açıklayabileceğiniz bir inceleme üretmiş olmalısınız.

Dar bir sınıra sahip bir örnek seçin. Tek bir dışa aktarma davranışını incelemek, tüm veri platformunu incelemekten daha kolaydır. Bir bileşenle ilgili daha önceki bir seçimi doğrulamak, mimarinin iyi olup olmadığına dair geniş bir sorudan daha kolaydır.

Alıştırmanın yanında kısa bir not tutun: soru, beklenen kaynak, mevcut uygulama ve muhakeme gerektiren kısım. Bu, cevabı değerlendirmek için referansınızdır.

Doğru hatayı teşhis edin

• İncelemeci yanlış sohbeti kurtarırsa, getirme üzerinde çalışın.
• Doğru sohbeti bulur ancak kodu yanlış okursa, araştırma üzerinde çalışın.
• Bulgular sağlam ancak uygulama gereksinimi karşılamıyorsa, devir teslimi iyileştirin.

Bu ayrım önemlidir çünkü her başarısızlık farklı bir düzeltme gerektirir. Daha fazla bellek eklemek, net olmayan bir kısa bilgiyi mutlaka düzeltmez ve kısa bilgiyi yeniden yazmak, hiç içe aktarılmamış bir kaynağı kurtarmaz.

En küçük tam döngüyü bitirin, neyin başarısız olduğunu kaydedin ve bir sonraki iyileştirmeyi seçmek için bu kanıtı kullanın.

3. çalışan kurulum: araştırmayı uygulamadan ayırın

Önerdiğim ilk kurulum, salt okunur bir incelemeye ve proje düzenleme erişimine sahip bir uygulayıcıya sahiptir. Her birine net bir çıktı verin ve devir teslimi, herhangi bir değişiklik başlamadan önce okuyabileceğiniz bir şey haline getirin.

Ajan profilleri bir çalıştırıcı, model, çaba, talimatlar ve dosya erişimini destekler. Sohbetler projelere aittir ve takipler, temel CLI oturumlarını sürdürür. sohbet modeli

1. Ajan 1: incelemeci ilk soruyu alır: neye karar verdik, kod şu anda ne yapıyor ve ele alınmaya değer bir boşluk var mı?
2. Ajan 2: uygulayıcı incelenen cevabı ve sınırlı bir talebi alır: bu davranış değişikliğini bu kapsamda yapın ve bu şekilde doğrulayın.

Rolleri ayrı tutun

Her iki rol için de aynı çalıştırıcıyı seçebilirsiniz.

Yararlı ayrım, sorumluluklarında ve erişimlerindedir ve araştırma ile düzenleme arasında açık bir inceleme bulunur.

Hiçbiri faydalı bir iş tamamlamadan önce bir uzman kataloğu oluşturmaktan kaçınırdım. Gerçekten ayırt edebileceğiniz sorumluluklarla başlayın. Bir rolün neye sahip olduğunu veya bitmiş çıktısının neye benzediğini açıklayamıyorsanız, başka bir ajan eklemeden önce rolü daraltın.

3.1 incelemeci: belirsizliği görünür kılan bir kısa bilgi

İncelemecuyu seçin ve ilgili sohbeti @Claude, @Codex, @OpenCode veya @Cursor kullanarak ekleyin. Seçilen referanslar, çalıştırma için dondurulmuş bağlam haline gelir ve görev başladığında seçilen ajana gider. referanslar

Bu kısa bilgiyi kopyalayın ve yuvaları doldurun:

1Ekli sohbeti ve mevcut depoyu kullanarak [özellik veya alt sistem] ile ilgili önceki kararı inceleyin.
2
3Orijinal kararı ve belirtilen gerekçesini açıklayın. İlgili kodu kontrol edin ve hâlâ geçerli olanı, değişenleri ve mevcut kanıtlardan doğrulanamayanları belirleyin.
4
5Sonuçlarınızı destekleyen dosyalara atıfta bulunun. Bir doğrulama planı ile [istenen davranış] için gereken en küçük değişikliği önerin.
6
7Dosyaları düzenlemeyin. Sohbete tarihsel kanıt olarak davranın ve mevcut proje talimatlarıyla çelişkileri işaretleyin.

İncelemeyi denetleyin

Depo açıkken cevabı okuyun.

1. Bir atıfı takip edin.
2. Ajanın hâlâ var olduğunu söylediği koşulu inceleyin.
3. Sohbetin iddia ettiği bir şey ile kodun bugün gösterdiği bir şey arasında net bir ayrım arayın.

Cevap belirsizse, soruyu daraltın. Davranışı kontrol eden tam koşulu veya önceki alternatifi uygunsuz kılan bağımlılığı belirlemesini isteyin.

Yararlı bir araştırma, eksik kanıtlarla sonuçlanabilir. Bu size bir sonraki adımda ne sağlayacağınızı söyler. Boşluğu yumuşatan bir cevap, bir sonraki kararı zorlaştırır.

3.2 devir teslim: bulguları yürütülebilir bir kısa bilgiye dönüştürün

İncelemeyi kabul ettiğinizde, uygulama talebini gözlemlenebilir davranış etrafında yazın. Önceki sohbetin oluşturduğu kısıtlamayı dahil edin, ancak bu değişiklikle ilgisini açıklayın.

İşte kullanacağım bir kısa bilgi:

1Aşağıdaki incelenen bulguları kullanarak [belirli davranışı] uygulayın.
2
3[Mevcut davranışı] bozulmadan koruyun. Düzenlemeleri [izin verilen kapsam] ile sınırlayın. Değişiklik bu kapsamın dışında çalışma gerektiriyorsa, genişletmeden önce nedenini açıklayın.
4
5Düzenlemeden önce mevcut depo talimatlarını kontrol edin. [Önemli başarısızlık durumu] dahil olmak üzere [beklenen sonucu] [ilgili test veya manuel kontrol] ile doğrulayın.
6
7Ne değiştiğine, fiilen çalıştırılan kontrollere ve çözülmemiş herhangi bir sınırlamaya dair kısa bir açıklama döndürün. Yayınlamayın veya dağıtmayın.
8
9İncelenen bulgular:
10[kontrol ettiğiniz bulguları yapıştırın]

Devir teslimi spesifik yapın

Bu parantezler gerçek cevapları hak ediyor. "Daha iyi hale getir" ifadesi, ajanın hedefi icat etmesine neden olur. "Orijinal hatayı korurken, başarısız dışa aktarmayı bir yeniden deneme eylemiyle göster" ifadesi, ikinize de inceleyecek somut bir şey verir.

İncelenen bulguyu göreve yakın tutun. Önemli kısıtlama uzun bir transkriptin içine gömülüyse, kısa bilgide açıkça belirtin ve destekleyici sohbeti ekleyin.

Kaynak, kısıtlamanın nereden geldiğini açıklar. Mevcut talebiniz, bugünün çalışmasını nasıl yönettiğini açıklar.

4. proje alıştırması: tüm döngü boyunca yinelenen bir hatayı ele alın

İş akışını somutlaştırmak için varsayımsal bir alıştırma. Projenizin ara sıra bir ağ kesintisinden sonra yinelenen dışa aktarmalar oluşturduğunu ve daha eski bir sohbetin yeniden deneme davranışıyla ilgili bir araştırma içerdiğini hayal edin.

1. Adım 1: önce, bu sohbeti alın. İncelemeciden önceki araştırmanın neyi ortaya koyduğunu belirlemesini isteyin, ardından mevcut yeniden deneme yolunu buna karşı kontrol edin.
2. Adım 2: diyelim ki eski tartışma, isteklerin belirsiz bir yanıttan sonra tekrarlanabileceğini söylüyor. İncelemeci, mevcut uygulamanın buna hâlâ izin verip vermediğini, hangi kodun bunu kontrol ettiğini ve yinelenenleri önlemeyi amaçlayan bir mekanizmanın zaten var olup olmadığını belirlemelidir.
3. Adım 3: kanıtlar bir değişikliği destekliyorsa, uygulayıcıya başarısızlık durumu etrafında kısa bilgi verin. Tekrarlanan bir isteğin ne yapması gerektiğini, hangi mevcut dışa aktarma davranışının kalması gerektiğini ve kesintiye uğramış bir yanıtı nasıl doğrulayacağınızı belirtin.
4. Adım 4: ardından değişikliği inceleyin ve ilgili yolu test edin. Hem başarılı dışa aktarmayı hem de belirsizlikten sonraki yeniden denemeyi kontrol edin. Ortam kesintiyi yeniden oluşturamıyorsa, bu sınırlamayı kaydedin ve daha fazla doğrulamanın gerekip gerekmediğine karar verin.
5. Adım 5: son olarak, saklayabileceğiniz dersi gözden geçirin: yinelenene neden olan koşullar, bunu ele alan mekanizma ve düzeltmeyi destekleyen kanıtlar.

Bu örnek, önerilen bir alıştırmadır, agentic stack'teki bir hata iddiası değildir. Kendi projenizden gerçek bir başarısızlık kullanın ve aynı sırayı koruyun.

5. paylaşılan katman: diğer araçlarınıza getirmeyi dahil edin

Masaüstü, entegrasyonu Araçlar → Bağlantılar → Araçlarda @ kullan → Dört aracın tümünde etkinleştir yoluyla kurabilir. Komut eşdeğeri şudur:

1agentic-stack context install

Ardından araçları yeniden başlatın. MCP girişi, sohbet arama, seçili sohbet okuma ve paylaşılan bellek aramasını kullanıma sunar. entegrasyon

Seçici davranışı istemciye bağlıdır; kaynak tamamlama mevcut olmadığında, ajan eşleşen sohbetleri arayabilir ve sunabilir. istemci davranışı

Araçlar arasında sürekliliği test edin

İlk kontrolüm, başka bir araçtan az önce incelediğiniz kararın aynısını bulmasını istemek olurdu. Konuyu verin, eşleşen kaynağı sunmasını isteyin ve bir analiz istemeden önce seçimi onaylayın.

Ardından sonucu masaüstünde incelediğiniz kaynakla karşılaştırın. Araçlar arasında bağlam sürekliliğini test ediyorsunuz, bu nedenle soruyu sabit tutarken sorduğunuz yeri değiştirin.

Ayrıca, bir karar işi maddi olarak etkilediğinde, nihai görev kısa bilgisine kaynağı da dahil ederdim. "Bunu daha önce tartışmıştık" ifadesi ajana bir arama problemi verir. "Bu incelenen sohbeti kullanın ve bu koşulu doğrulayın" ifadesi ona belirli bir sorumluluk verir.

6. dayanıklı katman: neyin derse dönüşmeyi hak ettiği

Getirme, eski materyali tekrar görünür hale getirir. Yine de bu materyalin hangi otoriteyi taşıması gerektiğine karar vermelisiniz.

Bir sohbet, terk edilmiş bir plan, yanlış bir teşhis veya proje değişmeden önce makul olan bir cevap içerebilir. Onu korumak, mantık yürütmeyi daha sonra incelemenizi sağlar; bir dersi kabul etmek ayrı bir karardır.

Görevler, yürütme kayıtlarını tutar. Bilgi → Dersler, dersleri gerekçeleriyle birlikte aşamalandırmayı, kabul etmeyi, reddetmeyi ve yeniden gözden geçirmeyi desteklerken, içe aktarılan geçmiş kabul edilen derslerden ayrı kalır. inceleme yaşam döngüsü

Meydan okuyabileceğiniz bir ders yazın

Meydan okunabilecek kadar ayrıntılı bir ders önerisi yazardım: uygulandığı koşul, önerdiği davranış, gerekçe ve kanıt.

Varsayımsal dışa aktarma hatası için "her zaman güvenli bir şekilde yeniden dene" ifadesi yardımcı olamayacak kadar belirsizdir. Yararlı bir not, bir yeniden denemeyi neyin belirsiz kıldığını ve bu projenin uygulamasının tekrarlanan işi nasıl tanıması gerektiğini belirler.

Ardından dersi neyin geçersiz kılacağını sorun. Farklı bir arka uç, değişen bir sözleşme veya değiştirilen bir alt sistem, orijinal kısıtlamayı ortadan kaldırabilir. Gelecekteki incelemenin başlayacak bir yeri olması için bu sınırı dahil edin.

Yararlı bir düzeltmenin, gerekçesinden daha uzun yaşayan bir kural haline gelmesini bu şekilde önlerdim.

6.1 bellek yapısı: her bilgi türünü yerine koyun

Masaüstünün altında, taşınabilir .agent/ mimarisi, çalışma durumunu, önceki bölümleri, dayanıklı kalıpları ve kişisel tercihleri ayırır. Beceriler yeniden kullanılabilir prosedürler sağlarken, protokoller izinleri ve yetki devrini tanımlar. mimari

• Mevcut araştırma, devam eden çalışmaya aittir.
• Tamamlanmış hesabı, ne olduğuna dair kanıt haline gelir.
• Doğrulanmış bir kalıp, dayanıklı bir ders haline gelebilir.
• Sonuçların nasıl sunulmasını istediğinize dair bir tercih, tercihlerinize aittir.

Bu anlamları net tutmak, daha sonraki incelemeyi kolaylaştırır. Geçici bir geçici çözüm, ne zaman kaldırılabileceğini açıklamalıdır. Kişisel bir yazma tercihi, yanlışlıkla mimari bir kural haline gelmemelidir.

Doğrulanmış bir prosedürü beceriye dönüştürün

Aynısı beceriler için de geçerlidir. Bir prosedür tekrarlanacak kadar kullanışlı ve takip edilecek kadar spesifik olduğunda bir beceri oluştururdum. İhtiyaç duyduğu girdileri, önemli adımları, beklenen çıktıyı ve başka bir karar gerektiren koşulları dahil edin.

Dışa aktarma örneği için, araştırma yararlı bir regresyon kontrol prosedürü üretebilir. Bunu yalnızca adımların projenizde çalıştığını onayladıktan sonra kaydedin. Kopyalanmış bir transkript, bir sonraki ajana bir hikaye verir; incelenmiş bir prosedür, ona değerlendirebileceğiniz bir yöntem verir.

7. işletim kuralları: kısa, sınırlı, denetlenebilir

İşte ilk projeden itibaren iş akışının etrafına koyacağım kurallar.

1. Kural 1: her kısa bilgi teslim edilecek ürünü adlandırır. Bir inceleme, kanıtlarla birlikte bulguları döndürür. Bir uygulama, kontrollerle birlikte bir davranış değişikliğini döndürür. Bir ders önerisi, kabul edebileceğiniz veya reddedebileceğiniz bir iddiayı döndürür.
2. Kural 2: erişim işi takip eder. Araştırma salt okunur erişimle başlar; uygulama, üzerinde anlaşılan değişiklik için gereken kapsamı alır. Yayınlama, dağıtım ve diğer sonuç doğuran eylemleri talepte açıkça belirtin.
3. Kural 3: fiili doğrulama isteyin. Rapor, neyin çalıştırıldığını ve ne olduğunu söylemelidir. Bir kontrol mevcut değilse, bunu görünür kılın ve eksik sonucu sessizce başarı olarak ele almayın.
4. Kural 4: tarihsel bağlamı mevcut kanıtlara ve geçerli proje talimatlarına tabi tutun. Alınan bir sohbet, daha önceki bir kararı açıklayabilir, ancak yine de güncelliğini yitirmiş olabilir.
5. Kural 5: sonucu, sonucu saklamadan önce inceleyin. Bir ajanın kendi çalışmasına ilişkin açıklaması, diff ve gözlemlenen davranışla birlikte incelenecek bir şeydir.

Bunlar, tanımladığım kurulum için çalıştırma uygulamalarıdır. Bunları projenize göre ayarlayın, ancak sorumlulukları, başka bir kişinin bir görevin kısa bilgisini karşılayıp karşılamadığını söyleyebileceği kadar net tutun.

7.1 inceleme kuyruğu: işi kabul etmeyi veya geri göndermeyi kolaylaştırın

Her uygulamanın aynı biçimde bitmesini isterdim:

• ne değişti,
• ne doğrulandı,
• ne belirsizliğini koruyor,
• ve yeniden kullanılabilir bir ders önerip önermediği.

Bu, her seferinde tüm sohbeti yeniden oluşturmak zorunda kalmadan tamamlanmış işi okumak için tutarlı bir yol sağlar. Destekleyici ayrıntı, incelemeniz gereken kısım için kullanılabilir durumda kalabilir.

Bir şeyi geri gönderdiğinizde, düzeltmeyi kaçırdığı gereksinime ekleyin. "Bu yanlış" ifadesi başka bir tahmin turu başlatır. "Yeniden deneme, bu koşul altında ikinci bir dışa aktarma oluşturuyor; orijinal istek kimliğini koruyun ve bu kontrolü yeniden çalıştırın" ifadesi boşluğu belirler.

Hayatta kalmaya neyin değer olduğuna karar verin

Düzeltme geçtikten sonra, bunun yinelenen bir kısıtlama mı yoksa o görevin bir ayrıntısı mı olduğuna karar verin. Arkasında kanıt varsa, birincisini kaydedin. İkincisi, görevin geçmişinde kalabilir.

Her inceleme yorumunu kalıcı belleğe dönüştürmekten kaçınırdım. Bazı düzeltmeler yalnızca bir kez faydalıdır. Diğerleri, daha sonraki çalışmaları şekillendirmesi gereken bir kuralı ortaya çıkarır. Bu ayrımı yapmak, sistemi sürdürmenin bir parçasıdır.

Bir incelemenin sonunda sorulması gereken faydalı soru şudur: Gelecekteki bir ajan, benzer bir görevi üstlenmeden önce neyi bilmeli ve bu bilgiyi nerede doğrulayabilir?

7.2 maliyet disiplini: her çalıştırmaya bir durma koşulu verin

Genişlemeye devam edebilecek herhangi bir göreve bir durma koşulu dahil ederdim. Bir inceleme için bu, ilgili davranışın ve çözülmemiş soruların yazılı bir açıklaması olabilir. Uygulama için bu, üzerinde anlaşılan değişikliğin belirtilen kontrollerini geçmesi olabilir.

Ajan daha büyük bir sorun keşfederse, bu bulguyu ve orijinal görevle ilişkisini, bu çalışmayı mevcut değişikliğe dahil etmeden önce açıklamasını isteyin.

Bunun mevcut göreve ait olup olmadığına karar verin.

Sonuçları karşılaştırın ve sınırlamaları uygulayın

Hesabınızda fiilen mevcut olan seçenekleri kullanarak çalıştırıcıyı ve modeli seçin, ardından bunları kendi sınırlı örneklerinize göre değerlendirin. Bir konfigürasyonu varsayılan yapmadan önce bulguların kalitesini, gereken düzeltmeleri ve sağlanan doğrulamayı karşılaştırırdım.

Görevi ve kaynak materyali sabit tutarak deneyi adil tutun. Her deneme soruyu, bağlamı ve kabul kriterlerini değiştirirse, karşılaştırmayı yorumlamak zor olacaktır.

Ve herhangi bir harcama kontrolünü, araçlarınız veya sağlayıcınız tarafından fiilen uygulandıkları yere koyun. Bir ajandan ekonomik olmasını isteyen bir cümle bir tercihtir; bir sınıra güvenmeden önce mevcut kontrolleri inceleyin.

8. özel yapı: çalışma alanını gerçek bir sürtünme noktası etrafında değiştirin

Temel döngüyü tamamladığınızda, masaüstünün kendisinden ne istediğinize dair daha iyi bir fikriniz olacak. Belki tekrarlanan bir gezinme adımı sizi rahatsız ediyordur veya bir görev görünümü bir alanı olması gerekenden daha zor incelemeye tabi tutuyordur.

Bir özellik önermeden önce sürtünmeyi yazın. Gerçekleştirmeye çalıştığınız eylemi, zaman kaybettiğiniz yeri ve iyileştirilmiş davranışın size ne yapma imkanı vereceğini açıklayın.

Ardından kaynak depoyu açın ve ajanınıza sınırlı bir değişiklik talebi verin. Sonucu uygulamada nasıl incelemeyi planladığınızı dahil edin.

Değişikliği oluşturun ve inceleyin

Depo, bu geliştirme ve paketleme komutlarını belgeler:

1python3 -m pytest -q
2swift build --package-path apps/macos -c release
3python3 scripts/check-desktop-connection.py
4bash scripts/build-macos-app.sh --output ./apps/macos/dist

geliştirme komutları

SwiftUI değişiklikleri, incelemek için yeniden derleme ve yeniden başlatma gerektirir. masaüstü iş akışı

Değişikliği motive eden etkileşimi ve bozulabilecek yakındaki bir durumu test ederdim. Görev filtrelemeyi iyileştirirseniz, filtrelenmiş sonuçları, boş bir sonuç kümesini ve tam listeye dönüş yolunu inceleyin.

Dışa aktarma alıştırmasına uyguladığınız standardın aynısını kullanın: somut bir öncesi, sınırlı bir değişiklik ve gözlemlenmiş bir sonrası.

8.1 uzak seçenek: çalışmanın nerede yaşaması gerektiğine karar verin

Yerel iş akışı çalıştıktan sonra, kalıcı bir sunucuda yürütme isteyebilirsiniz. Kendi kendine barındırma yolu, yerel uygulamayı projelerine, belleğine, görev geçmişine ve CLI oturum açma bilgilerine sahip olan tek sahipli bir hizmete bağlar; ana bilgisayarı değiştirmek, Mac'inizin verilerini veya kimlik bilgilerini otomatik olarak aktarmaz. barındırma kılavuzu

İşte İngilizce'den Türkçe'ye çevrilmiş metin:

Bu hamleyi, bir projeyi ve yürütme ortamını halihazırda bakımını yaptığınız bir makinede tutmak gibi somut bir nedenle yapardım. Dağıtım işine başlamadan önce bu nedeni yazın.

Desteklenen yapılandırma, kimlik doğrulama ve doğrulama adımları için barındırma kılavuzunu izleyin. Sunucuyu, kendi durumunu inceleyebileceğiniz başka bir çalışma ortamı olarak ele alın.

Seçilen ortamı doğrulayın

Ardından orada tanıdık bir görevi tekrarlayın. Seçilen projeyi kontrol edin, aracının amaçlanan kaynağa erişebildiğini onaylayın ve sonucun seçtiğiniz sunucu ortamına ait olduğunu doğrulayın.

Bilinen bir görevi kullanmak geçişi değerlendirmeyi kolaylaştırır. Ana bilgisayarı, projeyi ve iş akışını aynı anda değiştirirseniz, hangi değişikliğin şaşırtıcı bir sonuca neden olduğunu belirlemek zorlaşır.

Temel kalıbı öğrenmek için yerel ortam yeterlidir. İş size bir neden verdiğinde altyapıyı genişletin.

9. Ölçeklendirme: önceki döngünün bir boşluk ortaya çıkardığı yere kapsam ekleyin

Bu kurulumu, gerçek görevler sırasında karşılaştığınız eksik bağlama göre genişletirdim.

• Bir inceleme daha önceki bir mimari tartışmasını gerektiriyorsa, o tartışmayı içe aktarın.
• Uygulama tekrar tekrar aynı prosedürü gerektiriyorsa, bir beceri geliştirin ve doğrulayın.
• Bir karar sürekli yeniden gündeme geliyorsa, onu destekleyen kanıtlarla birlikte kapsamlı bir ders yazın.

Cevaplarını zaten bildiğiniz küçük bir soru koleksiyonu bulundurun. İçe aktarımlarınızı veya iş akışınızı değiştirdikten sonra bunları kullanın: bu kararı bulun, bu kısıtlamayı açıklayın, onu uygulayan kodu belirleyin ve artık güncel olmayan kısmı işaretleyin.

İş haklı çıkardığında genişletin

Başka bir aracı rolünü ancak sorumluluğu işten netleştiğinde eklerdim. Tekrarlayan bir dokümantasyon incelemesi, özel bir brifingi haklı çıkarabilir. Tek seferlik bir talep, mevcut bir role mükemmel şekilde uyabilir.

Yerini hak eden parçaları genişletin. Bir şey ters gittiğinde anlayabilecek kadar basit tutun geri kalanını.

9.1 Bakım alışkanlığı: sistem değiştiğinde bilgiyi tekrar gözden geçirin

Bir alt sistem, varsayımlarını değiştirecek kadar değiştiğinde ilgili dersleri gözden geçirirdim. Değişikliğin kendisini tetikleyici olarak kullanın: yeni bir bağımlılık, değiştirilmiş bir depolama katmanı, farklı bir dağıtım ortamı veya revize edilmiş bir ürün gereksinimi.

Hangi mevcut derslerin eski davranışa bağlı olduğunu sorun, ardından bu kaynakları değişiklikle birlikte inceleyin. Hâlâ geçerli olanı koruyun, daha dar bir kapsama ihtiyaç duyanı revize edin ve artık geçerli olmayanı mevcut inceleme iş akışı aracılığıyla kullanımdan kaldırın.

Önemli olan açıklamayı korumaktır. Gelecekteki bir geliştirici, önceki kuralın neden var olduğunu ve onu değiştirmek için neyin yeterince değiştiğini anlayabilmelidir.

Prosedürleri yenileyin ve çakışmaları çözün

Beceriler için, girdilerini veya komutlarını etkileyen bir değişiklikten sonra prosedürü tekrar çalıştırın. Bir adım artık çalışmıyorsa, gözlemlenen hataya dayanarak prosedürü güncelleyin ve ilgili kontrolü tekrarlayın.

Bu, bakımı projedeki gerçek olaylara bağlı tutar. Büyük olasılıkla güncelliğini yitirmiş bilgileri, önünüzdeki güncel kanıtlarla birlikte gözden geçiriyorsunuz.

Bir görev çelişkili notlar ortaya çıkardığında, bu çelişkiyi çözmeyi incelemenin bir parçası haline getirin. Hangi ifadenin mevcut sürüm için geçerli olduğunu belirleyin ve sonucu, bir sonraki aracının tüm araştırmayı tekrarlamadan mantığı takip edebileceği kadar net bırakın.

Kullanışlı bir devir teslim bırakın

Bir sonraki oturumdan önce, doğrulanmış sonucu, açık soruyu ve başka bir aracının önce okuması gereken kaynağı açıklayan kısa bir devir teslim notu bırakın. Bunu, gerçekten incelediğiniz proje durumuna özgü tutun.

Bu, yarının çalışmasına, özellikle farklı bir araçla veya bir süre sonra geri döndüğünüzde, orijinal mantığın hâlâ mevcut olduğu, izini sürebileceğiniz bir başlangıç noktası verir.

10. Yapım sayfası

1. Tanıdık bir depo ve tanıyabileceğiniz bir karar seçin.
2. Masaüstünü oluşturun, kurulumu tamamlayın ve bu kararı içeren tamamlanmış bir konuşmayı içe aktarın.
3. Onu arayın, kaynağı inceleyin ve mevcut kodun salt okunur bir incelemesine ekleyin.
4. Bulguları kendiniz kontrol edin, ardından görünür bir kabul koşuluyla sınırlı bir uygulamayı brifingleyin.
5. Diff'i inceleyin ve çalışmayı motive eden başarısızlık durumu da dahil olmak üzere ilgili doğrulamayı çalıştırın.
6. Bir dersi ancak sonuç bunu destekliyorsa, kapsamı ve nedeni kaydederek aşamalı olarak ekleyin.
7. Tekrarlamaya değer olduğunu doğruladığınızda bir prosedürü beceriye dönüştürün.
8. Aynı almayı başka bir araçtan deneyin, ardından gerçek bir görev gerektirdiğinde bağlamınızı veya altyapınızı genişletin.

Bu hafta tek bir kararla başlayın ve tüm geçmişinizi içe aktarmadan önce onu tüm döngü boyunca taşıyın.

Bir sonraki aracı, sizin muhakemenizi miras almalıdır.