Slash commands
Twórz niestandardowe slash commands, aby automatyzować workflow'y i ustandaryzować praktyki zespołowe.
Aby zacząć, wpisz / w Bob Shell, aby zobaczyć wszystkie dostępne polecenia, lub utwórz własne, dodając plik markdown do .bob/commands/ lub ~/.bob/commands/.
Wbudowane polecenia
Bob Shell zawiera następujące wbudowane slash commands:
| Polecenie | Aliasy | Opis |
|---|---|---|
/help | Pokaż wszystkie dostępne slash commands | |
/clear | Wyczyść ekran i zresetuj historię konwersacji | |
/condense | Inteligentnie skondensuj okno kontekstu, aby zwolnić miejsce | |
/copy | Skopiuj element z historii konwersacji do schowka | |
/mode | Przełącz aktywny tryb (otwiera wybierak) | |
/resume | Przeglądaj i wznawiaj poprzednią konwersację | |
/settings | Przeglądaj i edytuj ustawienia Bob Shell | |
/mcp | Zarządzaj skonfigurowanymi serwerami MCP | |
/manage-secrets | Zarządzaj sekretami używanymi w konfiguracjach serwera MCP | |
/skills | Wstaw odwołanie do umiejętności w zapytaniu | |
/init | Zainicjuj Bob w bieżącym obszarze roboczym | |
/status | /info | Wyświetl status sesji, użycie i informacje o wersji |
/team | Wybierz zespół | |
/logs | Otwórz najnowszy plik dziennika za pomocą przeglądarki systemowej | |
/docs | Otwórz dokumentację Bob Shell w przeglądarce | |
/bug | Prześlij raport o błędzie | |
/exit | /quit, /close | Wyjdź z CLI |
Podpolecenia /manage-secrets
Sekrety pozwalają przechowywać wrażliwe wartości (takie jak klucze API) i odwoływać się do nich w konfiguracjach serwera MCP bez ich kodowania na stałe.
| Podpolecenie | Użycie | Opis |
|---|---|---|
set | /manage-secrets set KEY VALUE | Zapisz wartość sekretu |
list | /manage-secrets list | Wyświetl wszystkie przechowywane klucze sekretów |
rm | /manage-secrets rm KEY | Usuń przechowywany sekret |
Sekrety są przechowywane w zaszyfrowanej postaci w ~/.bob/settings/ i można się do nich odwoływać w konfiguracjach serwera MCP za pomocą składni ${KEY}.
Dlaczego warto używać slash commands?
Slash commands zapewniają kilka kluczowych korzyści:
- Automatyzacja workflow'u: Zamieniaj złożone, wieloetapowe procesy w pojedyncze polecenia
- Standaryzacja zespołu: Udostępniaj polecenia swojemu zespołowi dla spójnych praktyk
- Zachowanie kontekstu: Dołączaj kontekst specyficzny dla projektu do każdego polecenia
- Szybki dostęp: Rozmyte wyszukiwanie i autouzupełnianie do natychmiastowego odkrywania poleceń
Jak działają slash commands
Gdy wpiszesz / w Bob Shell, pojawia się menu pokazujące wszystkie dostępne polecenia. Te polecenia pochodzą z dwóch źródeł:
| Typ polecenia | Źródło | Cel |
|---|---|---|
| Niestandardowe polecenia workflow'u | .bob/commands/ lub ~/.bob/commands/ | Automatyzacja stworzona przez użytkownika dla konkretnych zadań |
| Polecenia trybów | Wbudowane i niestandardowe tryby | Przełączają kontekst operacyjny Bob |
Tworzenie niestandardowych poleceń
Niestandardowe polecenia rozszerzają funkcjonalność Bob poprzez dodawanie plików markdown do określonych katalogów:
| Lokalizacja | Zakres | Ścieżka |
|---|---|---|
| Specyficzne dla projektu | Dostępne tylko w bieżącym projekcie | .bob/commands/ w katalogu głównym obszaru roboczego |
| Globalne | Dostępne we wszystkich projektach | ~/.bob/commands/ w katalogu domowym |
Nazwa pliku staje się nazwą polecenia. Na przykład:
.bob/commands/
├── review.md → /review
├── test-api.md → /test-api
└── deploy-check.md → /deploy-checkPrzetwarzanie nazw poleceń
Podczas tworzenia poleceń przez UI, Bob Shell automatycznie przetwarza nazwy poleceń:
- Konwertuje na małe litery
- Zastępuje spacje myślnikami
- Usuwa znaki specjalne
- Usuwa wiodące i końcowe myślniki
Przykład: "My Cool Command!" staje się my-cool-command
Podstawowy format polecenia
Utwórz proste polecenie, dodając plik markdown:
Help me review this code for security issues and suggest improvements.Zaawansowane polecenie z frontmatter
Dodaj metadane za pomocą frontmatter dla rozszerzonej funkcjonalności:
---
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.Pola frontmatter
| Pole | Cel | Przykład |
|---|---|---|
description | Wyświetlane w menu poleceń | "Create a new API endpoint" |
argument-hint | Pokazuje oczekiwane argumenty | "<endpoint-name> <http-method>" |
Okno dialogowe zatwierdzania narzędzi
Gdy Bob Shell prosi o użycie narzędzia, pojawia się okno dialogowe zatwierdzenia. Okno dialogowe zapewnia następujące opcje:
| Opcja | Opis |
|---|---|
| Approve Once | Zezwól na wykonanie tego konkretnego wywołania narzędzia. Zostaniesz ponownie zapytany przy kolejnych wywołaniach. |
Approve <group> tools for task | Zezwól na wszystkie narzędzia w tej samej grupie narzędzi na czas trwania zadania. Nie jest wyświetlane dla narzędzi MCP. |
| Always Allow Command for task | Zezwól na konkretne polecenie powłoki na czas trwania zadania. |
| Reject | Odrzuć wywołanie narzędzia. Bob Shell nie kontynuuje akcji. |
Możesz również dodać opcjonalną notatkę podczas zatwierdzania lub odrzucania wywołania narzędzia. Notatka jest dołączana do kontekstu konwersacji, dzięki czemu Bob Shell może odpowiednio dostosować swoje zachowanie.
Aby przerwać odpowiedź strumieniową, zanim Bob Shell skończy, naciśnij Esc.
Zarządzanie poleceniami w Bob Shell
Bob Shell obsługuje te same slash commands co Bob IDE. Chociaż Bob Shell nie zapewnia dedykowanego UI do zarządzania poleceniami, możesz:
- Tworzyć pliki poleceń ręcznie w katalogu
.bob/commands/w swoim projekcie lub~/.bob/commands/w katalogu domowym - Edytować istniejące pliki poleceń za pomocą dowolnego edytora tekstu
Używanie slash commands
Wpisz / w Bob Shell, aby zobaczyć zunifikowane menu zawierające następujące typy poleceń:
- Zunifikowane menu: Niestandardowe polecenia i polecenia przełączania trybów pojawiają się razem
- Autouzupełnianie: Zacznij pisać, aby filtrować polecenia (np.
/sampokazujesample-command-name) - Rozmyte wyszukiwanie: Znajdź polecenia nawet przy częściowych dopasowaniach
- Podgląd opisu: Wyświetlaj opisy poleceń w menu
- Wskaźniki wizualne: Polecenia trybów są wyróżnione od niestandardowych poleceń specjalnymi ikonami
/mode code Switch to Code mode
/mode ask Switch to Ask mode
/review Review code for security issues
/api-endpoint <endpoint-name> <http-method>Podpowiedzi argumentów
Podpowiedzi argumentów zapewniają natychmiastową pomoc dla slash commands, pokazując, jakiego rodzaju informacji podać, gdy polecenie oczekuje dodatkowych danych wejściowych.
Gdy wpiszesz /, aby otworzyć menu poleceń, polecenia oczekujące argumentów wyświetlają jasnoszarą podpowiedź obok siebie. Ta podpowiedź informuje, jakiego rodzaju argumentu oczekuje polecenie.
Na przykład:
/mode <mode_slug>— podpowiedź<mode_slug>wskazuje, że powinieneś podać nazwę trybu, taką jakcodelubdebug/api-endpoint <endpoint-name> <http-method>— pokazuje, że potrzebujesz zarówno nazwy endpointu, jak i metody HTTP
Po wybraniu polecenia zostanie ono wstawione do pola wprowadzania czatu, a po nim pojawi się spacja. Podpowiedź nie jest wstawiana; jest jedynie wizualnym przewodnikiem, który pomoże ci wiedzieć, co wpisać dalej. Musisz ręcznie wpisać argument po poleceniu.
Dodawanie podpowiedzi argumentów do niestandardowych poleceń
Możesz dodawać podpowiedzi argumentów do swoich niestandardowych poleceń, używając pola argument-hint we frontmatter:
---
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.Zostanie to wyświetlone jako /api-endpoint <endpoint-name> <http-method> w menu poleceń.
Najlepsze praktyki dla podpowiedzi argumentów
- Bądź precyzyjny: Używaj opisowych placeholderów, takich jak
<file-path>, zamiast ogólnych, takich jak<arg> - Pokazuj wiele argumentów: Jeśli twoje polecenie wymaga wielu danych wejściowych, pokaż je wszystkie:
<source> <destination> - Używaj spójnego formatu: Zawsze owijaj placeholdery w nawiasy kątowe:
<placeholder> - Bądź zwięzły: Podpowiedzi powinny być krótkie i jasne
Częste pytania dotyczące argumentów
| Pytanie | Odpowiedź |
|---|---|
| Co się stanie, jeśli nie podam argumentu? | Polecenie może nie działać zgodnie z oczekiwaniami lub może monitować o podanie dodatkowych informacji. Podpowiedź ma pomóc ci za pierwszym razem. |
| Czy wszystkie polecenia mają podpowiedzi? | Nie, tylko polecenia zaprojektowane do przyjmowania argumentów będą miały podpowiedzi. Polecenia działające bez dodatkowych danych wejściowych nie będą ich pokazywać. |
| Czy mogę używać polecenia bez zastąpienia podpowiedzi? | Tekst podpowiedzi (np. <mode_slug>) należy zastąpić rzeczywistymi wartościami. Pozostawienie tekstu podpowiedzi prawdopodobnie spowoduje niepowodzenie polecenia lub nieoczekiwane zachowanie. |
Najlepsze praktyki
Nazewnictwo poleceń
- Używaj opisowych, zorientowanych na akcję nazw
- Nazwy powinny być zwięzłe, ale jasne
- Używaj myślników dla poleceń wielowyrazowych
- Unikaj ogólnych nazw, takich jak
helplubtest - Uwaga: Nazwy są automatycznie konwertowane na slug (małe litery, usunięte znaki specjalne)
- Rozszerzenie
.mdjest automatycznie dodawane/usuwane w razie potrzeby
Treść polecenia
- Zacznij od jasnej dyrektywy
- Używaj ustrukturyzowanych formatów (listy, sekcje)
- Dołącz konkretne wymagania
- Odwołuj się do konwencji projektu
- Utrzymuj polecenia skoncentrowane na jednym zadaniu
Organizacja
- Grupuj powiązane polecenia w podkatalogach
- Używaj spójnych wzorców nazewnictwa
- Dokumentuj złożone polecenia
- Umieszczaj polecenia pod kontrolą wersji
- Udostępniaj polecenia zespołu w repozytorium projektu
Rozwiązywanie problemów
Polecenia nie pojawiają się
Jeśli twoje polecenia nie pojawiają się w menu:
- Sprawdź lokalizację pliku: Upewnij się, że niestandardowe pliki poleceń są w
.bob/commands/lub~/.bob/commands/ - Zweryfikuj rozszerzenie pliku: Niestandardowe polecenia muszą być plikami
.md
Polecenie nie znalezione
Gdy slash command nie zostanie znalezione, LLM zobaczy:
The slash command '/unknown-command' was not found. Please check the command name and try again.Konflikty poleceń
- Niestandardowe polecenia projektu zastępują globalne niestandardowe polecenia o tej samej nazwie
- Używaj unikalnych nazw, aby unikać konfliktów
- Podczas tworzenia duplikatów nazw przez UI, do nazw są dołączane numery (np.
new-command-1,new-command-2)
O poleceniach trybów
Menu slash zawiera polecenia przełączania trybów (takie jak /mode code, /mode ask), które fundamentalnie zmieniają tryb operacyjny AI — nie tylko wstrzykują tekst, ale przełączają cały kontekst AI. Niestandardowe tryby, które tworzysz, również pojawiają się jako slash commands (np. tryb ze slugiem reviewer staje się /reviewer). Tych poleceń trybów nie można zastąpić niestandardowymi poleceniami workflow'u.
Kompatybilność między platformami
Slash commands działają identycznie zarówno w Bob Shell, jak i Bob IDE. Oznacza to:
- Polecenia utworzone w jednym środowisku mogą być używane w drugim
- Ta sama składnia i zachowanie poleceń obowiązuje w obu środowiskach
- Polecenia udostępniane przez zespół działają spójnie niezależnie od używanego interfejsu
MCP
Bob Shell obsługuje Model Context Protocol (MCP), umożliwiając rozszerzenie możliwości Boba poprzez łączenie się z zewnętrznymi usługami i narzędziami. Ten przewodnik wyjaśnia, jak konfigurować i używać serwerów MCP z Bob Shell.
Tryby
Tryby to wyspecjalizowane persony dostosowujące zachowanie Boba do twoich konkretnych zadań. Każdy tryb oferuje różne możliwości i poziomy dostępu, pomagając ci efektywniej osiągać określone cele.