Özel kurallar, Bob'un isteklerinize nasıl yanıt vereceğini etkiler ve çıktıyı belirli tercihleriniz ve proje gereksinimlerinizle uyumlu hale getirir. Bob'un kodlama stilini, dokümantasyon yaklaşımını ve karar verme süreçlerini kontrol etmek için özel kurallar yapılandırın.

Özel kurallar nedir?

Özel kurallar, Bob'un görevlere nasıl yaklaştığını ihtiyaçlarınıza uyacak şekilde yönlendiren tercihler, kısıtlamalar ve yönergeler tanımlayarak Bob'un varsayılan davranışını genişletir.

Yaygın kullanımlar şunları içerir:

Kodlama stili tercihleri (girinti, adlandırma kuralları)

Dokümantasyon formatları ve standartları

Test metodolojileri ve gereksinimleri

Proje iş akışları ve süreçleri

Ekibe özel kurallar

Bir mod için özel kurallar ekleme

Modlara özel kurallar eklemenin iki yolu vardır:

Kullanıcı arayüzü üzerinden

Tüm projelerinizde geçerli olan kuralları yapılandırın:

Bob kenar çubuğunun sağ üst köşesindeki üç noktaya tıklayın.

Modlar'a tıklayın.

Kurallarını düzenlemek istediğiniz modu seçin.

Düzenle'ye tıklayın.

Moda özel özel talimatlar (isteğe bağlı) bölümüne gidin.

Kurallarınızı yazın.

Kaydet'e tıklayın.

Moda özel kural dosyaları üzerinden

Modlar ayrıca .bob/rules-{mode-slug}/ dizininde saklanan ek kural dosyalarına sahip olabilir:

01-style-guide.md

02-formatting.txt

Dizindeki dosyalar alfabetik olarak yüklenir ve mod yapılandırmanızdaki customInstructions özelliği ile birleştirilir. Daha fazla ayrıntı için Özel modlar bölümüne bakın.

Proje düzeyinde kurallar kullanarak Bob'un davranışını standartlaştırma hakkında daha fazla bilgi edinin.

Kural kapsamları

Bob, kurallarınızın nerede uygulanacağını belirleyen iki kural kapsamını destekler:

Global kurallar: Tüm projelerinizde otomatik olarak uygulanır

Çalışma alanı kuralları: Yalnızca mevcut projenizde uygulanır

Kişisel veya kuruluş genelindeki standartlar için global kuralları kullanın. Projeye özel gereksinimler için çalışma alanı kurallarını kullanın.

Konfigürasyon yöntemleri

Dizin tabanlı konfigürasyon

Çalışma alanı kökünüzün .bob/ altında dizinler kullanın:

Çalışma alanı yapısı:

coding-style.md

typescript.md

rules/ - Tüm modlar için genel kurallar

rules-agent/ - Agent moduna özel kurallar

Global yapı:

Linux/macOS: ~/.bob/rules/ Windows: %USERPROFILE%\.bob\rules\

Çalışma alanı kuralları oluşturun:

mkdir -p .bob/rules
echo "# Proje standartları" > .bob/rules/coding-style.md

Global kurallar oluşturun:

# Linux/macOS
mkdir -p ~/.bob/rules
echo "# Global standartlar" > ~/.bob/rules/coding-standards.md

# Windows
mkdir %USERPROFILE%\.bob\rules
echo # Global standartlar > %USERPROFILE%\.bob\rules\coding-standards.md

Kural önceliği

Bob, birden fazla kaynaktan gelen kuralları şu sırayla birleştirir:

Global kurallar (~/.bob/rules/)

Çalışma alanı kuralları (.bob/rules/)

Her seviyede, moda özel kurallar genel kurallardan önce yüklenir. Çalışma alanı kuralları global kuralları geçersiz kılabilir.

# Kod Stili
- Değişkenler için camelCase kullan
- Sınıflar için PascalCase kullan

# Test
- Tüm genel fonksiyonlar için birim testleri yaz
- Test framework'ü olarak Jest kullan

# Dokümantasyon
- Genel API'ler için JSDoc yorumları ekle

Etkili kural örnekleri

"Girinti için her zaman 4 boşluk genişliğinde boşluklar kullan"

"Değişken adları için camelCase kullan"

"Tüm yeni fonksiyonlar için birim testleri yaz"

"Kod sağlamadan önce mantığınızı açıklayın"

"Web sitelerine özellikler eklerken, duyarlı ve erişilebilir olduklarından emin olun"

Gelişmiş konfigürasyon

Moda özel kurallar

Özel dizinlerle belirli modları hedefleyin:

Dizin	Amaç
`rules/`	Tüm modlar için genel kurallar
`rules-agent/`	Yalnızca Agent modu
`rules-plan/`	Yalnızca Plan modu
`rules-ask/`	Yalnızca Ask modu
`rules-{mode}/`	Herhangi bir özel mod

`AGENTS.md` dosyalarını kullanma

Ekip standardizasyonu için çalışma alanı kökünüzde bir AGENTS.md dosyası kullanabilirsiniz:

# Ekip Standartları
- Şirket kodlama yönergelerini takip edin
- Yalnızca onaylanmış kütüphaneleri kullanın
- Tüm API değişikliklerini belgeleyin

Önemli detaylar:

Varsayılan olarak otomatik yüklenir

Projenizle birlikte sürüm kontrolü

Ayarlarda "bob-code.useAgentRules": false ile devre dışı bırakın

Moda özel kurallardan sonra, ancak genel çalışma alanı kurallarından önce yüklenir

Dosya davranışı

Özyinelemeli okuma: Bob, alt dizinler dahil kural dizinlerindeki tüm dosyaları okur

Alfabetik sıra: Dosyalar dosya adına göre alfabetik sırayla işlenir

Otomatik filtreleme: Önbellek dosyalarını hariç tutar (.DS_Store, *.bak, *.cache, *.log, *.tmp, Thumbs.db)

Sembolik bağlantılar: Maksimum 5 derinlikle desteklenir

Boş dosyalar: Sessizce atlanır

Ekip standardizasyonu

Proje düzeyinde standartlar

Sürüm kontrolü altında çalışma alanı .bob/rules/ dizinlerini kullanın:

# Sürüm kontrolüne ekle
git add .bob/rules/
git commit -m "Bob özel kurallarını ekle"

Bu, belirli projeler için ekip üyeleri arasında tutarlı davranış sağlar.

Kuruluş genelinde standartlar

Ekip üyelerine global kuralları dağıtın:

Paylaşılan bir kural deposu oluşturun

Ekip üyeleri ~/.bob/rules/ konumuna klonlar

Tutarlılık için düzenli olarak güncelleyin

Hibrit yaklaşım

Her iki yaklaşımı da birleştirebilirsiniz:

Kuruluş standartları için global kurallar

Projeye özel gereksinimler için çalışma alanı kuralları

Gerektiğinde çalışma alanı kuralları global kuralları geçersiz kılar

Özel kurallar