Bob'a kodunu belgelemesini ve önceki eylemlerini hatırlamasını söyleyen proje düzeyinde kural dosyaları kullanarak ekibiniz genelinde Bob'un davranışını standartlaştırın.

Bob kuralları, her Bob konuşmasına uygulanan talimatları tanımlayan düz metin dosyalarıdır. Bob, kuralları proje içindeki belirlenmiş bir klasörde veya global kullanıcı düzeyinde dosyalar olarak saklar ve her kural dosyasının içeriğini tüm modlarda her konuşmaya otomatik olarak enjekte eder. Kural enjeksiyonu, ekiplerin ve bireysel geliştiricilerin her istemde talimatları tekrarlamadan kodlama standartlarını, iletişim tercihlerini ve iş akışı kısıtlamalarını uygulamasına olanak tanır.

galaxium-travels/.bob içindeki proje düzeyindeki kurallar kodunuzla birlikte sürüm kontrolü altındadır, bu şu anlama gelir:

Kurallar, depoyu klonlayan tüm ekip üyelerine otomatik olarak yayılır.

Kurallardaki değişiklikler normal kod inceleme sürecinden geçer.

Kural geçmişi git'te izlenir.

Bu eğitimde, .bob dizinine kural dosyaları ekleyerek Bob'a kısa ve öz konuşmasını, kodunu belgelemesini ve önceki eylemlerini hatırlamasını söylersiniz. Bu dosyaları sürüm kontrolüne dahil edeceğiniz için Bob bunları ekibiniz genelinde uygulayacaktır.

Ön koşullar

Bu eğitimi tamamlamak için aşağıdakilere ihtiyacınız vardır:

Henüz yoksa, Galaxium Travels demo kodunu klonlayın. Klonlama komutu ayrıca eğitimlerde kullandığınız kodu içeren bob-learning-path-branch dalını da kontrol eder.

git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels

Galaxium Travels demo kodu açık olan Bob IDE

.bob klasörünü oluşturmak için Bir proje başlatın eğitimini tamamlayın.

Zorunlu olmasa da, Bob'un arayüzü ve özellikleri hakkında bilgi edinmek için Hızlı başlangıç eğitimini yapmayı düşünün.

Python veya Python 3. Python'u resmi web sitesinden indirebilirsiniz.

Özel bir Bob kural dosyası oluşturun

Bob'un /init komutu, her Bob modu için Bob'un her moddaki davranışını yönlendiren AGENTS.md dosyalarını içeren bir .bob klasörü oluşturur. rules klasörüne yeni bir dosya ekleyerek kendi özel kurallarınızı oluşturun. Bob kural dosyasının içeriğini okuyacaktır, bu da eklediğiniz talimatların Bob ile tüm etkileşimlere uygulanacağı anlamına gelir.

Kurallar klasörünü oluşturun

.bob içinde henüz bir rules klasörü yoksa, bir tane oluşturun.

Kural dosyasını oluşturun

galaxium-travels/.bob/rules/ içinde basic_rules.md adlı bir dosya oluşturun.

Projede oluşturulan .bob/rules/basic_rules.md dosyası

Özel Bob kuralları oluşturun

basic_rules.md dosyasında, aşağıdaki metni ekleyerek özel kurallar oluşturun:

Bir dokümantasyon standardı kuralı ekleyin

Always include concise JSDoc strings for every public function.

Dokümantasyon standardı kuralı, Bob'un görevden bağımsız olarak genel fonksiyonları her yazdığında veya değiştirdiğinde tutarlı dokümantasyon oluşturmasını sağlar.

Bir iletişim stili kuralı ekleyin

Be very concise in your wording.

İletişim stili kuralı, Bob'un yanıtları ve yorumları nasıl ifade ettiğini kontrol eder; bu, ayrıntılı açıklamalar yerine kısa ve doğrudan çıktıları tercih eden ekipler için kullanışlıdır.

Bir iç monolog kuralı ekleyin

Write a summary of every interaction into the folder `internal-monologue/`.
Name the file starting with a timestamp, followed by a concise description of the interaction.
Example: 2026-01-15_update-readme.md

İç monolog, Bob'un tüm konuşmalarda yaptığı her şeyin kalıcı bir kaydını üretir.

İç monologun faydaları şunları içerir:

Denetim izi: Bob'un hangi değişiklikleri ne zaman yaptığının kaydı.
Oturumlar arası süreklilik: Bob, önceki çalışmaları anlamak için gelecekteki konuşmalarda iç monolog klasörüne başvurabilir.
Ekip şeffaflığı: Paylaşılan depolarda, monolog farklı ekip üyelerinin Bob ile ne yaptığını gösterir.

Tüm kuralları ekledikten sonra, basic_rules.md dosyanız şöyle görünecektir:

Üç özel kuralın tümü eklenmiş basic_rules.md dosyası

Kuralları test edin

Ajantik sohbet kenar çubuğunu açın, Kod moduna geçin ve Bob'un README.md'yi düzenlemesi için aşağıdaki istemi çalıştırın. Bob, daha iyi sorun giderme ile geliştirme, tam revizyon veya yanlışlıkları düzeltme gibi önerilerde bulunabilir. README için vizyonunuza en uygun öneriyi seçebilirsiniz.

Update the readme

Bob README.md'yi günceller ve internal-monologue adlı bir klasör oluşturur ve README'ye yaptığı güncellemeleri gösteren bir dosya oluşturur.

Bob README.md'yi günceller ve bir iç monolog dosyası oluşturur

Sonraki adımlar

Bu eğitimde, Bob kurallarının her konuşma ve moda uygulanan kalıcı talimatları tanımlamanıza nasıl izin verdiğini öğrendiniz. Proje düzeyindeki kurallar kodunuzla birlikte sürüm kontrolü altındadır, bu nedenle ekibiniz otomatik olarak aynı standartları paylaşır. İç monolog deseni, tüm oturumlarda Bob'un eylemlerinin bir denetim izini sağlar.

Özelleştirilmiş talimatlar ve belirli araç erişimi ile özelleşmiş kişilikler tanımlayan özel modlar oluşturma hakkında bilgi edinmek için Bob yetenekleri ekleyin bölümüne ilerleyin.

Bob'un davranışını standartlaştırın

Bu sayfada