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:
| Komut | Takma adlar | Açıklama |
|---|---|---|
/help | Mevcut tüm slash command'ları göster | |
/clear | Ekranı temizle ve konuşma geçmişini sıfırla | |
/condense | Alan açmak için bağlam penceresini akıllıca sıkıştır | |
/copy | Konuşma geçmişinden bir öğeyi panoya kopyala | |
/mode | Etkin modu değiştir (seçici açar) | |
/resume | Önceki bir konuşmaya göz at ve devam ettir | |
/settings | Bob Shell ayarlarını görüntüle ve düzenle | |
/mcp | Yapılandırılmış MCP sunucularını yönet | |
/manage-secrets | MCP sunucu yapılandırmalarında kullanılan gizli anahtarları yönet | |
/skills | Prompta bir skill referansı ekle | |
/init | Bob'u mevcut çalışma alanında başlat | |
/status | /info | Oturum durumunu, kullanımı ve sürüm bilgilerini görüntüle |
/team | Takım seç | |
/logs | Son log dosyasını sistem görüntüleyicisiyle aç | |
/docs | Tarayıcında Bob Shell belgelerini aç | |
/bug | Hata raporu gönder | |
/exit | /quit, /close | CLI'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 komut | Kullanım | Açıklama |
|---|---|---|
set | /manage-secrets set KEY VALUE | Bir gizli anahtar değeri kaydet |
list | /manage-secrets list | Kayıtlı tüm gizli anahtar anahtarlarını listele |
rm | /manage-secrets rm KEY | Kayı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ü | Kaynak | Amaç |
|---|---|---|
| Ö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 modlar | Bob'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:
| Konum | Kapsam | Yol |
|---|---|---|
| Projeye özgü | Yalnızca mevcut projede kullanılabilir | Çalışma alanı kökünde .bob/commands/ |
| Global | Tüm projelerde kullanılabilir | Ana dizinde ~/.bob/commands/ |
Dosya adı komut adı olur. Örneğin:
.bob/commands/
├── review.md → /review
├── test-api.md → /test-api
└── deploy-check.md → /deploy-checkKomut 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ı
| Alan | Amaç | Örnek |
|---|---|---|
description | Komut menüsünde görünür | "Create a new API endpoint" |
argument-hint | Beklenen 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çenek | Açıklama |
|---|---|
| Approve Once | Bu belirli araç çağrısının devam etmesine izin ver. Gelecekteki çağrılar için tekrar sorulacaksın. |
Approve <group> tools for task | Gö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 task | Görevin geri kalanı için belirli bir shell komutuna izin ver. |
| Reject | Araç ç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:
- Komut dosyalarını projendeki
.bob/commands/dizinine veya ana dizinindeki~/.bob/commands/dizinine manuel olarak oluştur - 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:
- Birleşik menü: Özel komutlar ve mod geçiş komutları birlikte görünür
- Otomatik tamamlama: Komutları filtrelemek için yazmaya başla (örn.
/sam,sample-command-name'i gösterir) - Bulanık arama: Kısmi eşleşmelerle bile komutları bul
- Açıklama önizleme: Menüde komut açıklamalarını gör
- 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,codeveyadebuggibi 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
| Soru | Yanı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
helpveyatestgibi 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)
.mduzantı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
.mddosyası 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
MCP
Bob Shell, Model Context Protocol'ü (MCP) destekler ve harici hizmetlere ve araçlara bağlanarak Bob'un yeteneklerini genişletmenize olanak tanır. Bu kılavuz, Bob Shell ile MCP sunucularını nasıl yapılandıracağınızı ve kullanacağınızı açıklar.
Modlar
Modlar, Bob'un davranışını senin belirli görevlerine göre şekillendiren uzmanlaşmış personelardır. Her mod, belirli hedefleri daha verimli şekilde gerçekleştirmene yardımcı olmak için farklı yetenekler ve erişim düzeyleri sunar.