Funkcje

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:

PolecenieAliasyOpis
/helpPokaż wszystkie dostępne slash commands
/clearWyczyść ekran i zresetuj historię konwersacji
/condenseInteligentnie skondensuj okno kontekstu, aby zwolnić miejsce
/copySkopiuj element z historii konwersacji do schowka
/modePrzełącz aktywny tryb (otwiera wybierak)
/resumePrzeglądaj i wznawiaj poprzednią konwersację
/settingsPrzeglądaj i edytuj ustawienia Bob Shell
/mcpZarządzaj skonfigurowanymi serwerami MCP
/manage-secretsZarządzaj sekretami używanymi w konfiguracjach serwera MCP
/skillsWstaw odwołanie do umiejętności w zapytaniu
/initZainicjuj Bob w bieżącym obszarze roboczym
/status/infoWyświetl status sesji, użycie i informacje o wersji
/teamWybierz zespół
/logsOtwórz najnowszy plik dziennika za pomocą przeglądarki systemowej
/docsOtwórz dokumentację Bob Shell w przeglądarce
/bugPrześlij raport o błędzie
/exit/quit, /closeWyjdź 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.

PodpolecenieUżycieOpis
set/manage-secrets set KEY VALUEZapisz wartość sekretu
list/manage-secrets listWyświetl wszystkie przechowywane klucze sekretów
rm/manage-secrets rm KEYUsuń 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łoCel
Niestandardowe polecenia workflow'u.bob/commands/ lub ~/.bob/commands/Automatyzacja stworzona przez użytkownika dla konkretnych zadań
Polecenia trybówWbudowane i niestandardowe trybyPrzełączają kontekst operacyjny Bob

Tworzenie niestandardowych poleceń

Niestandardowe polecenia rozszerzają funkcjonalność Bob poprzez dodawanie plików markdown do określonych katalogów:

LokalizacjaZakresŚcieżka
Specyficzne dla projektuDostępne tylko w bieżącym projekcie.bob/commands/ w katalogu głównym obszaru roboczego
GlobalneDostę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-check

Przetwarzanie 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

PoleCelPrzykład
descriptionWyświetlane w menu poleceń"Create a new API endpoint"
argument-hintPokazuje 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:

OpcjaOpis
Approve OnceZezwól na wykonanie tego konkretnego wywołania narzędzia. Zostaniesz ponownie zapytany przy kolejnych wywołaniach.
Approve <group> tools for taskZezwó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 taskZezwól na konkretne polecenie powłoki na czas trwania zadania.
RejectOdrzuć 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:

  1. Tworzyć pliki poleceń ręcznie w katalogu .bob/commands/ w swoim projekcie lub ~/.bob/commands/ w katalogu domowym
  2. 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ń:

  1. Zunifikowane menu: Niestandardowe polecenia i polecenia przełączania trybów pojawiają się razem
  2. Autouzupełnianie: Zacznij pisać, aby filtrować polecenia (np. /sam pokazuje sample-command-name)
  3. Rozmyte wyszukiwanie: Znajdź polecenia nawet przy częściowych dopasowaniach
  4. Podgląd opisu: Wyświetlaj opisy poleceń w menu
  5. 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ą jak code lub debug
  • /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

PytanieOdpowiedź
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 help lub test
  • Uwaga: Nazwy są automatycznie konwertowane na slug (małe litery, usunięte znaki specjalne)
  • Rozszerzenie .md jest 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
Jak oceniasz ten temat?