Özellikler

Slash command'ları

İş akışlarını otomatikleştirmek ve ekip uygulamalarını standartlaştırmak için özel slash command'ları oluştur.

Başlamak için Bob Shell'de / yaz ve mevcut tüm komutları gör ya da .bob/commands/ veya ~/.bob/commands/ dizinine bir markdown dosyası ekleyerek kendi komutlarını oluştur.

Yerleşik komutlar

Bob Shell aşağıdaki yerleşik slash command'larını içerir:

KomutTakma adlarAçıklama
/helpMevcut tüm slash command'ları göster
/clearEkranı temizle ve konuşma geçmişini sıfırla
/condenseAlan açmak için bağlam penceresini akıllıca sıkıştır
/copyKonuşma geçmişinden bir öğeyi panoya kopyala
/modeEtkin modu değiştir (seçici açar)
/resumeÖnceki bir konuşmaya göz at ve devam ettir
/settingsBob Shell ayarlarını görüntüle ve düzenle
/mcpYapılandırılmış MCP sunucularını yönet
/manage-secretsMCP sunucu yapılandırmalarında kullanılan gizli anahtarları yönet
/skillsPrompta bir skill referansı ekle
/initBob'u mevcut çalışma alanında başlat
/status/infoOturum durumunu, kullanımı ve sürüm bilgilerini görüntüle
/teamTakım seç
/logsSon log dosyasını sistem görüntüleyicisiyle aç
/docsTarayıcında Bob Shell belgelerini aç
/bugHata raporu gönder
/exit/quit, /closeCLI'dan çık

/manage-secrets alt komutları

Gizli anahtarlar, hassas değerleri (API key'ler gibi) depolamana ve bunları MCP sunucu yapılandırmalarında doğrudan yazıya geçirmeden referans almana olanak tanır.

Alt komutKullanımAçıklama
set/manage-secrets set KEY VALUEBir gizli anahtar değeri kaydet
list/manage-secrets listKayıtlı tüm gizli anahtar anahtarlarını listele
rm/manage-secrets rm KEYKayıtlı bir gizli anahtarı kaldır

Gizli anahtarlar ~/.bob/settings/ içinde şifreli olarak depolanır ve MCP sunucu yapılandırmalarında ${KEY} söz dizimi kullanılarak referans alınabilir.

Slash command'ları neden kullanmalısın?

Slash command'ları birçok önemli avantaj sağlar:

  • İş akışı otomasyonu: Karmaşık çok adımlı süreçleri tek komutlara dönüştür
  • Ekip standardizasyonu: Tutarlı uygulamalar için ekibinde komutları paylaş
  • Bağlam koruma: Her komuta projeye özgü bağlam ekle
  • Hızlı erişim: Anlık komut keşfi için bulanık arama ve otomatik tamamlama

Slash command'lar nasıl çalışır

Bob Shell'de / yazdığında, mevcut tüm komutları gösteren bir menü açılır. Bu komutlar iki kaynaktan gelir:

Komut TürüKaynakAmaç
Özel iş akışı komutları.bob/commands/ veya ~/.bob/commands/Belirli görevler için kullanıcı tarafından oluşturulan otomasyon
Mod komutlarıYerleşik ve özel modlarBob'un operasyonel bağlamını değiştir

Özel komutlar oluşturma

Özel komutlar, belirli dizinlere markdown dosyaları ekleyerek Bob'un işlevselliğini genişletir:

KonumKapsamYol
Projeye özgüYalnızca mevcut projede kullanılabilirÇalışma alanı kökünde .bob/commands/
GlobalTüm projelerde kullanılabilirAna dizinde ~/.bob/commands/

Dosya adı komut adı olur. Örneğin:

.bob/commands/
├── review.md         → /review
├── test-api.md       → /test-api
└── deploy-check.md   → /deploy-check

Komut adı işleme

UI üzerinden komut oluştururken Bob Shell, komut adlarını otomatik olarak işler:

  • Küçük harfe dönüştürür
  • Boşlukları çizgilerle değiştirir
  • Özel karakterleri kaldırır
  • Baştaki ve sondaki çizgileri kaldırır

Örnek: "My Cool Command!" → my-cool-command

Temel komut biçimi

Bir markdown dosyası ekleyerek basit bir komut oluştur:

Help me review this code for security issues and suggest improvements.

Ön madde içeren gelişmiş komut

Gelişmiş işlevsellik için frontmatter kullanarak meta veri ekle:

---
description: Create a new API endpoint
argument-hint: <endpoint-name> <http-method>
---
Create a new API endpoint called $1 that handles $2 requests.
Include proper error handling and documentation.

Frontmatter alanları

AlanAmaçÖrnek
descriptionKomut menüsünde görünür"Create a new API endpoint"
argument-hintBeklenen argümanları gösterir"<endpoint-name> <http-method>"

Araç onay iletişim kutusu

Bob Shell bir araç kullanmak istediğinde bir onay iletişim kutusu görünür. İletişim kutusu şu seçenekleri sunar:

SeçenekAçıklama
Approve OnceBu belirli araç çağrısının devam etmesine izin ver. Gelecekteki çağrılar için tekrar sorulacaksın.
Approve <group> tools for taskGörevin geri kalanı için aynı araç grubundaki tüm araçlara izin ver. MCP araçları için gösterilmez.
Always Allow Command for taskGörevin geri kalanı için belirli bir shell komutuna izin ver.
RejectAraç çağrısını reddet. Bob Shell işlemi sürdürmez.

Bir araç çağrısını onaylarken veya reddederken isteğe bağlı bir not da ekleyebilirsin. Not, konuşma bağlamına dahil edilir; bu sayede Bob Shell davranışını buna göre ayarlayabilir.

Bob Shell bitirmeden önce akış yanıtını kesmek için Esc'ye bas.

Bob Shell'de komut yönetimi

Bob Shell, Bob IDE ile aynı slash command'ları destekler. Bob Shell'in komutları yönetmek için özel bir UI'ı olmasa da şunları yapabilirsin:

  1. Komut dosyalarını projendeki .bob/commands/ dizinine veya ana dizinindeki ~/.bob/commands/ dizinine manuel olarak oluştur
  2. Mevcut komut dosyalarını herhangi bir metin editörüyle düzenle

Slash command'ları kullanma

Aşağıdaki komut türlerini içeren birleşik bir menü görmek için Bob Shell'de / yaz:

  1. Birleşik menü: Özel komutlar ve mod geçiş komutları birlikte görünür
  2. Otomatik tamamlama: Komutları filtrelemek için yazmaya başla (örn. /sam, sample-command-name'i gösterir)
  3. Bulanık arama: Kısmi eşleşmelerle bile komutları bul
  4. Açıklama önizleme: Menüde komut açıklamalarını gör
  5. Görsel göstergeler: Mod komutları, özel komutlardan özel simgelerle ayırt edilir
/mode code     Switch to Code mode
/mode ask      Switch to Ask mode
/review        Review code for security issues
/api-endpoint  <endpoint-name> <http-method>

Argüman ipuçları

Argüman ipuçları, bir komut ek girdi beklediğinde ne tür bilgi sağlaman gerektiğini göstererek slash command'lar için anında yardım sunar.

Komut menüsünü açmak için / yazdığında, argüman bekleyen komutların yanında açık gri bir ipucu görünür. Bu ipucu, komutun ne tür bir argüman beklediğini söyler.

Örneğin:

  • /mode <mode_slug> - <mode_slug> ipucu, code veya debug gibi bir mod adı sağlaman gerektiğini belirtir
  • /api-endpoint <endpoint-name> <http-method> - Hem endpoint adı hem de HTTP yöntemine ihtiyaç duyduğunu gösterir

Komutu seçtikten sonra sohbet girişine ardından bir boşlukla eklenir. İpucu eklenmez; yalnızca sırada ne yazman gerektiğini bilmene yardımcı olan görsel bir kılavuzdur. Ardından komuttan sonra argümanı manuel olarak yazman gerekir.

Özel komutlara argüman ipuçları ekleme

Özel komutlarına frontmatter'daki argument-hint alanını kullanarak argüman ipuçları ekleyebilirsin:

---
description: Create a new API endpoint
argument-hint: <endpoint-name> <http-method>
---
Create a new API endpoint called $1 that handles $2 requests.
Include proper error handling and documentation.

Bu, komut menüsünde /api-endpoint <endpoint-name> <http-method> olarak görünür.

Argüman ipuçları için en iyi uygulamalar

  • Spesifik ol: <arg> gibi genel yer tutucular yerine <file-path> gibi açıklayıcı yer tutucular kullan
  • Birden fazla argümanı göster: Komutun birden fazla girdi gereksinimi varsa hepsini göster: <source> <destination>
  • Tutarlı biçim kullan: Yer tutucuları her zaman açılı parantez içine al: <placeholder>
  • Kısa tut: İpuçları kısa ve anlaşılır olmalı

Argümanlar hakkında sık sorulan sorular

SoruYanıt
Argümanı sağlamazsam ne olur?Komut beklendiği gibi çalışmayabilir ya da daha fazla bilgi isteyebilir. İpucu, ilk seferinde doğru yapman için oradadır.
Tüm komutların ipucu var mı?Hayır, yalnızca argüman almak üzere tasarlanmış komutların ipucu vardır. Ek girdi gerektirmeyen komutlar ipucu göstermez.
Bir komutu ipucunu değiştirmeden kullanabilir miyim?<mode_slug> gibi ipucu metninin gerçek değerlerle değiştirilmesi gerekir. İpucu metnini olduğu gibi bırakmak komutun başarısız olmasına veya beklenmedik davranışlara yol açabilir.

En iyi uygulamalar

Komut adlandırma

  • Açıklayıcı, eylem odaklı adlar kullan
  • Adları kısa ama anlaşılır tut
  • Çok kelimeli komutlar için kısa çizgi kullan
  • help veya test gibi genel adlardan kaçın
  • Not: Adlar otomatik olarak slug'a dönüştürülür (küçük harf, özel karakterler kaldırılır)
  • .md uzantısı gerektiği şekilde otomatik olarak eklenir/kaldırılır

Komut içeriği

  • Açık bir direktifle başla
  • Yapılandırılmış biçimler kullan (listeler, bölümler)
  • Belirli gereksinimleri dahil et
  • Proje kurallarına atıfta bulun
  • Komutları tek bir göreve odaklı tut

Organizasyon

  • İlgili komutları alt dizinlerde gruplandır
  • Tutarlı adlandırma desenleri kullan
  • Karmaşık komutları belgele
  • Komutlarını sürüm kontrolüne al
  • Ekip komutlarını proje repository'sinde paylaş

Sorun giderme

Komutlar görünmüyor

Komutların menüde görünmemesi durumunda:

  • Dosya konumunu kontrol et: Özel komut dosyalarının .bob/commands/ veya ~/.bob/commands/ içinde olduğundan emin ol
  • Dosya uzantısını doğrula: Özel komutlar .md dosyası olmalı

Komut bulunamadı

Bir slash command bulunamadığında, LLM şunu görür:

The slash command '/unknown-command' was not found. Please check the command name and try again.

Komut çakışmaları

  • Özel proje komutları, aynı ada sahip global özel komutları geçersiz kılar
  • Çakışmaları önlemek için benzersiz adlar kullan
  • UI üzerinden yinelenen ad oluştururken sayılar eklenir (örn. new-command-1, new-command-2)

Mod komutları hakkında

Slash menüsü, /mode code, /mode ask gibi mod geçiş komutlarını içerir; bunlar yapay zekanın operasyonel modunu temelden değiştirir — yalnızca metin eklemekle kalmaz, tüm yapay zeka bağlamını değiştirir. Oluşturduğun özel modlar da slash command'ları olarak görünür (örn. reviewer slug'ına sahip bir mod /reviewer olur). Bu mod komutları, özel iş akışı komutlarıyla geçersiz kılınamaz.

Platformlar arası uyumluluk

Slash command'ları hem Bob Shell hem de Bob IDE'de tamamen aynı şekilde çalışır. Bu şu anlama gelir:

  • Bir ortamda oluşturulan komutlar diğerinde de kullanılabilir
  • Aynı komut söz dizimi ve davranışı her iki ortamda da geçerlidir
  • Ekipte paylaşılan komutlar, ekip üyeleri hangi arayüzü kullanırsa kullansın tutarlı şekilde çalışır
Bu konu nasıl?