Tekrarlayan görevleri otomatikleştirmek, yerleşik komutları çalıştırmak ve Bob'un işlevselliğini basit markdown dosyalarıyla genişletmek için özel slash commands oluştur.

Genel Bakış

Başlamak için mevcut tüm komutları görmek üzere sohbette / yaz ya da .bob/commands/ veya ~/.bob/commands/ dizinine bir markdown dosyası ekleyerek kendi komutlarını oluştur.

Temel faydalar:

Workflow otomasyonu: Karmaşık çok adımlı süreçleri tek komutlara dönüştür

Ekip standardizasyonu: Tutarlı uygulamalar için komutları ekibinle paylaş

Bağlam koruması: Her komuta projeye özgü bağlam ekle

Hızlı erişim: Anında komut keşfi için fuzzy search ve otomatik tamamlama

Yerleşik komutlar

Bob, temel işlevsellik sağlayan çeşitli yerleşik komutlar içerir:

`/init`

Bob ile yeni bir proje veya workspace başlat. Bu komut, projenizde Bob ile çalışmak için gerekli yapılandırma ve yapının kurulmasına yardımcı olur.

`/review`

Kapsamlı analizle kod değişikliklerini incele. Bu komut birden fazla şekilde kullanılabilir:

/review – Çalışma dizinindeki yerel onaylanmamış değişiklikleri incele

/review <branch> – Bir branch'ı mevcut branch'ınla (HEAD) karşılaştır

/review #<issue-number> --issue-coverage – Yerel değişiklikleri bir GitHub issue'una karşı doğrula

/review <issue-url> --issue-coverage – Yerel değişiklikleri bir GitHub issue URL'sine karşı doğrula

Review komutu; bug tespiti, güvenlik kontrolleri, performans sorunları ve stil tutarlılığı dahil kapsamlı kod analizi gerçekleştirir.

`/create-pr`

AI tarafından oluşturulan açıklamayla bir pull request oluştur. Bu komut değişikliklerini analiz eder ve branch'lar arasındaki diff'e dayalı kapsamlı bir PR açıklaması üretir.

Özel komutlar oluşturma

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

Projeye özgü: Workspace kökündeki .bob/commands/

Global: Ev dizinindeki ~/.bob/commands/

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

review.md → /review

test-api.md → /test-api

deploy-check.md → /deploy-check

Komut adı işleme

UI aracılığıyla komut oluştururken komut adları otomatik olarak işlenir:

Küçük harfe dönüştürülür

Boşluklar tirelerle değiştirilir

Özel karakterler kaldırılır

Baştaki/sondaki tireler kaldırılır

Örnek: "Harika Komutum!" → harika-komutum

Temel komut formatı

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

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

frontmatter ile 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ı

description: Kullanıcıların komutun amacını anlamasına yardımcı olmak için komut menüsünde görünür

argument-hint: Komutu kullanırken beklenen bağımsız değişkenler hakkında ipucu sağlar

Komut yönetimi arayüzü

Bob, özel komutları yönetmek için özel bir arayüz sağlar.

Komut yöneticisini açmak için Bob panelindeki komutlar simgesine tıkla.

Yeni komut oluşturma

Giriş alanına komut adını yaz (ör. "Örnek komut adı")

Komutu oluşturmak için + düğmesine tıkla

Yeni bir dosya otomatik olarak oluşturulur ve açılır (ör. ornek-komut-adi.md)

Slash commands kullanma

Her iki komut türünü de içeren birleşik bir menü görmek için sohbette / yaz. Menü, aynı arayüzde hem özel workflow komutlarını hem de mod değiştirme komutlarını gösterir.

Birleşik menü: Hem özel komutlar hem de mod değiştirme komutları birlikte görünür

Otomatik tamamlama: Komutları filtrelemek için yazmaya başla (ör. /orn ornek-komut gösterir)

Fuzzy search: Kısmi eşleşmelerle bile komutları bul

Açıklama önizlemesi: Menüde komut açıklamalarını gör

Görsel göstergeler: Mod komutları, özel komutlardan özel simgelerle ayırt edilir

Bağımsız değişken ipuçları

Bağımsız değişken ipuçları, slash commands için anında yardım sağlar; bir komut ek girdi beklediğinde ne tür bilgi sağlayacağını gösterir.

Komut menüsünü açmak için / yazdığında, bağımsız değişken bekleyen komutlar yanlarında açık gri bir ipucu gösterir. Bu ipucu, komutun hangi tür bağımsız değişken beklediğini söyler.

Örneğin:

/mode <mode_slug> – <mode_slug> ipucu, code veya debug gibi bir mod adı sağlaman gerektiğini gösterir

/api-endpoint <endpoint-name> <http-method> – Hem bir endpoint adı hem de HTTP yöntemi gerektiğini gösterir

Komutu seçtikten sonra, sohbet girişine bir boşluk izleyerek eklenir. İpucu eklenmez; sadece bir sonraki ne yazacağını bilmene yardımcı olan görsel bir kılavuzdur. Ardından bağımsız değişkeni komuttan sonra manuel olarak yazman gerekir.

Özel komutlara bağımsız değişken ipuçları ekleme

frontmatter'daki argument-hint alanını kullanarak özel komutlarına bağımsız değişken 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.

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

Bağımsız değişken ipuçları için en iyi uygulamalar

Spesifik ol: <arg> gibi genel olanlar yerine <file-path> gibi açıklayıcı yer tutucular kullan

Birden fazla bağımsız değişkeni göster: Komutun birden fazla girdi gerektiriyorsa, hepsini göster: <source> <destination>

Tutarlı format kullan: Yer tutucuları her zaman açılı parantezle sar: <yer-tutucu>

Kısa ve öz tut: İpuçları kısa ve net olmalıdır

Sık sorulan sorular

"Bağımsız değişkeni sağlamazsam ne olur?" Komut beklendiği gibi çalışmayabilir veya daha fazla bilgi isteyebilir. İpucu, ilk seferinde doğru yapmanı sağlamak için oradadır.

"Tüm komutların ipucu var mı?" Hayır, yalnızca bağımsız değişken almak üzere tasarlanmış komutların ipucu olur. Ek girdi olmadan çalışan komutlar ipucu göstermez.

"İpucunu değiştirmeden komutu kullanabilir miyim?" İpucu metni (<mode_slug> gibi) gerçek değerlerle değiştirilmelidir. İpucu metnini bırakmak, komutun başarısız olmasına veya beklenmedik davranmasına neden olur.

En iyi uygulamalar

Komut adlandırma

Açıklayıcı, eyleme yönelik adlar kullan

Adları kısa ama net tut

Çok kelimeli komutlar için kısa çizgi kullan

help veya test gibi genel adlardan kaçın

Not: Adlar otomatik olarak slugify edilir (küçük harf, özel karakterler kaldırılır)

.md uzantısı gerektiğinde otomatik olarak eklenir/kaldırılır

Komut içeriği

Net bir direktifle başla

Yapılandırılmış formatlar kullan (listeler, bölümler)

Belirli gereksinimleri dahil et

Proje kurallarına başvur

Komutları tek bir göreve odaklı tut

Organizasyon

İlgili komutları alt dizinlerde gruplandır

Tutarlı adlandırma kalıpları kullan

Karmaşık komutları belgele

Komutlarını sürüm kontrolüne al

Ekip komutlarını proje deposunda paylaş

Sorun giderme

Komutlar görünmüyor

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 dosyaları olmalıdır

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ı adlı global özel komutları geçersiz kılar

Çakışmaları önlemek için benzersiz adlar kullan

UI aracılığıyla yinelenen adlar oluştururken sayılar eklenir (ör. yeni-komut-1, yeni-komut-2)

Mod komutları hakkında

Slash menüsü, AI'nın operasyonel modunu temelden değiştiren mod değiştirme komutları (/code, /ask gibi) içerir — bunlar yalnızca metin eklemekle kalmaz, tüm AI bağlamını değiştirir. Oluşturduğun özel modlar da slash commands olarak görünür (ör. slug'ı reviewer olan bir mod /reviewer olur). Bu mod komutları, özel workflow komutlarıyla geçersiz kılınamaz.

Daha fazla bilgi için Modlar ve Özel modlar sayfalarına bak.

Slash commands

Bu sayfada