Temel kavramlar

Araçlar

Bob Shell'in dosya okuma, kod düzenleme, komut çalıştırma ve komut satırından geliştirme ortamınla etkileşim için özel araçları nasıl kullandığını öğren.

Araç iş akışı

Ne yapmak istediğini doğal dilde açıkladığında, Bob Shell:

  1. İsteğine göre uygun aracı seçer.
  2. İncelemeniz için aracı parametreleriyle sunar.
  3. Onaylanan aracı çalıştırır ve sonuçları gösterir.
  4. Görevin tamamlanana kadar bu süreci devam ettirir.

Araç kategorileri

Bob Shell'in araçları, birincil işlevlerine göre kategorilere ayrılmıştır. Bu kategorileri anlamak, Bob Shell'in neler yapabileceğini ve görevleri nasıl gerçekleştirdiğini bilmene yardımcı olur.

Okuma araçları

Değişiklik yapmadan dosya içeriklerine eriş ve kod yapısını anla.

AraçAmaçÖrnek kullanım
read_fileBir veya daha fazla dosyanın içeriğini okuYapılandırma dosyalarını görüntüle, kaynak kodu incele
search_filesRegex kullanarak birden fazla dosyada desen araTüm TODO yorumlarını bul, fonksiyon tanımlarını tespit et
list_filesBelirtilen bir yoldaki dosya ve dizinleri listeleProje yapısını keşfet, belirli dosya türlerini bul
list_code_definition_namesKaynak dosyalardan sınıf, fonksiyon ve metot adlarını çıkarKod organizasyonuna genel bakış edin

Bob Shell okuma araçlarını ne zaman kullanır: Kodu incelemenizi, belirli desenleri bulmanı veya proje yapısını anlamanı istediğinde.

Yazma araçları

Yeni dosyalar oluştur veya mevcut kodu hassas şekilde düzenle.

AraçAmaçÖrnek kullanım
write_to_fileYeni bir dosya oluştur veya mevcut bir dosyayı tamamen yeniden yazYeni bileşenler oluştur, yapılandırma dosyaları oluştur
apply_diffBir dosyanın belirli bölümlerinde hedeflenmiş değişiklikler yapFonksiyon mantığını güncelle, hataları düzelt, kodu yeniden yapılandır
insert_contentBir dosyadaki belirli bir konuma yeni satırlar ekleImport'lar ekle, yeni fonksiyonlar ekle

Bob Shell yazma araçlarını ne zaman kullanır: Dosya oluşturmanı, özellik uygulamanı, hata düzeltmeni veya kodu yeniden yapılandırmanı istediğinde.

Komut araçları

Terminalinde komutlar çalıştır ve sistem işlemleri gerçekleştir.

AraçAmaçÖrnek kullanım
execute_commandÇalışma alanında CLI komutları çalıştırBağımlılıkları yükle, testleri çalıştır, projeleri derle

Bob Shell komut araçlarını ne zaman kullanır: Komut çalıştırmanı, paket yüklemenı, script çalıştırmanı veya sistem işlemlerini tamamlamanı istediğinde.

MCP araçları

Model Context Protocol sunucuları aracılığıyla Bob Shell'in yeteneklerini genişlet.

AraçAmaçÖrnek kullanım
use_mcp_toolBağlı MCP sunucuları tarafından sağlanan araçlara erişVeritabanları sorgula, API'lerle etkileşim kur, harici servislere eriş

Mod araçları

Özel görevler için farklı Bob Shell modları arasında geçiş yap.

AraçAmaçÖrnek kullanım
switch_modeFarklı bir moda geç (Agent, Plan, Ask vb.)Mimari tasarım için Plan moduna, uygulama için Agent moduna geç

Bob Shell mod araçlarını ne zaman kullanır: Mevcut görev farklı bir modun özel yeteneklerinden yararlanacağında.

Soru araçları

Görevleri tamamlamak için gereken ek bilgileri topla.

AraçAmaçÖrnek kullanım
ask_followup_questionSenden açıklama veya ek ayrıntı isteTercih edilen uygulama yaklaşımını sor, eksik bilgileri talep et

Araç grupları

Araç grupları, birlikte etkinleştirebileceğin veya devre dışı bırakabileceğin ilgili araçların adlandırılmış koleksiyonlarıdır. Belirli bir oturumda Bob Shell'in neler yapabileceğini kısıtlamak için araç gruplarını kullan — örneğin yalnızca okuma amaçlı bir denetimde dosya yazmayı önlemek ya da kontrollü bir ortamda komut yürütmeyi devre dışı bırakmak için.

Mevcut araç grupları

GrupDahil edilen araçlarAgent varsayılanıPlan varsayılanıAsk varsayılanı
readDosya okuma, arama ve listeleme araçları
editDosya yazma ve diff araçları
executeShell komut yürütme araçları
mcpMCP sunucu araçları
skillSkill ile ilgili araçlar
todoYapılacaklar listesi yönetim araçları
subagentAlt ajan oluşturma araçları
modeMod geçiş araçları

Araç gruplarını devre dışı bırakma

bob run veya bob chat'e virgülle ayrılmış grup adları listesiyle --disable-tool-groups iletebilirsin:

# Komut yürütme ve MCP araçlarını devre dışı bırak
bob run --disable-tool-groups execute,mcp "Review @src/"

# Yalnızca okuma modunda çalıştır
bob run --disable-tool-groups edit,execute,mcp "Summarize the codebase"

Tüm MCP sunucularını tek adımda da devre dışı bırakabilirsin:

bob run --disable-mcp "Explain @app.js"
Bu konu nasıl?