Wzmianki kontekstowe (Context mentions)
Odwołuj się do konkretnych elementów swojego projektu bezpośrednio w rozmowach z Bobem, używając @mentions, aby uzyskać precyzyjną pomoc uwzględniającą kontekst.
Typy wzmianek
Dzięki wzmiankom kontekstowym możesz odwoływać się do różnych elementów swojego projektu:
| Typ wzmianki | Format | Opis | Przykładowe użycie |
|---|---|---|---|
| Plik | @/path/to/file.ts | Zawiera zawartość pliku w kontekście żądania | Wyjaśnij funkcję w @/src/utils.ts |
| Folder | @/path/to/folder | Zawiera zawartość wszystkich plików bezpośrednio w folderze (nierekurencyjnie) | Przeanalizuj kod w @/src/components |
| Problemy | @problems | Zawiera diagnostykę z panelu Problems w IBM Bob | @problems Napraw wszystkie błędy w moim kodzie |
| Terminal | @terminal | Zawiera ostatnie polecenie terminala i jego dane wyjściowe | Napraw błędy wyświetlone w @terminal |
| Commit Git | @a1b2c3d | Odwołuje się do konkretnego commitu za pomocą hasha | Co zmieniło się w commicie @a1b2c3d? |
| Zmiany Git | @git-changes | Pokazuje niezatwierdzone zmiany | Zasugeruj komunikat dla @git-changes |
| URL | @https://example.com | Importuje zawartość witryny internetowej | Streść @https://docusaurus.io/ |
Wzmianki o plikach
Wzmianki o plikach są najczęściej używanym typem, pozwalającym na dołączenie zawartości konkretnych plików do rozmowy z Bobem.
| Możliwość | Szczegóły |
|---|---|
| Format | @/path/to/file.ts (zawsze zaczynaj od / od katalogu głównego projektu) |
| Dostarcza | Pełną zawartość pliku wraz z numerami linii |
| Działa z | Plikami tekstowymi, plikami PDF i DOCX (z ekstrakcją tekstu) |
| Działa w | Żądaniach początkowych, odpowiedziach na informacje zwrotne i wiadomościach uzupełniających |
| Ograniczenia | Bardzo duże pliki mogą zostać obcięte; pliki binarne nie są obsługiwane |
W przypadku dużych plików możesz wskazać konkretne sekcje, używając ścieżki pliku, po której następują numery linii, np. @/src/app.js:10-20, aby dołączyć tylko linie 10-20.
Wzmianki o folderach
Dzięki wzmiankom o folderach możesz odwoływać się do wielu plików naraz, zapewniając szerszy kontekst z danego katalogu.
| Możliwość | Szczegóły |
|---|---|
| Format | @/path/to/folder (bez ukośnika na końcu) |
| Dostarcza | Pełną zawartość wszystkich plików w katalogu |
| Zawiera | Zawartość niebinarnych plików tekstowych bezpośrednio w folderze (nierekurencyjnie) |
| Najlepsze do | Dostarczania kontekstu z wielu plików w jednym katalogu |
| Wskazówka | Pamiętaj o limitach context window przy przywoływaniu dużych katalogów |
Wzmianki o folderach są nierekurencyjne, co oznacza, że zawierają tylko pliki znajdujące się bezpośrednio w określonym folderze, a nie w jego podfolderach.
Wzmianka o problemach (problems)
Wzmianka o problemach importuje diagnostykę z panelu Problems w IBM Bob, pomagając w rozwiązywaniu wielu problemów jednocześnie.
| Możliwość | Szczegóły |
|---|---|
| Format | @problems |
| Dostarcza | Wszystkie błędy i ostrzeżenia z panelu problemów w IBM Bob |
| Zawiera | Ścieżki plików, numery linii i komunikaty diagnostyczne |
| Grupuje | Problemy uporządkowane według plików dla większej jasności |
| Najlepsze do | Naprawiania błędów bez ręcznego kopiowania |
Przykładowe użycie: @problems Czy możesz pomóc mi naprawić wszystkie te błędy?
Wzmianka o terminalu (terminal)
Wzmianki o terminalu rejestrują dane wyjściowe ostatniego polecenia, pomagając w debugowaniu błędów budowania lub analizowaniu wyników poleceń.
| Możliwość | Szczegóły |
|---|---|
| Format | @terminal |
| Rejestruje | Ostatnie polecenie i jego pełne dane wyjściowe |
| Zachowuje | Stan terminala (nie czyści terminala) |
| Ograniczenie | Ograniczone do widocznej zawartości bufora terminala |
| Najlepsze do | Debugowania błędów budowania lub analizowania danych wyjściowych poleceń |
Podczas rozwiązywania problemów z błędem kompilacji, wypróbuj:
Co jest nie tak z @terminal?, aby uzyskać natychmiastowy wgląd w błąd bez konieczności ręcznego kopiowania danych wyjściowych.
Wzmianki Git
Wzmianki Git pomagają w pracy z kontrolą wersji poprzez odwoływanie się do commitów i zmian.
| Typ | Format | Dostarcza | Ograniczenia |
|---|---|---|---|
| Commit | @a1b2c3d | Komunikat commitu, autora, datę i pełny diff | Działa tylko w repozytoriach Git |
| Robocze zmiany | @git-changes | Dane wyjściowe git status i diff niezatwierdzonych zmian | Działa tylko w repozytoriach Git |
Przykładowe użycie: Jaki jest cel @a1b2c3d? lub Zaproponuj komunikat commitu dla @git-changes
Wzmianki o adresach URL
Wzmianki o adresach URL pozwalają na odwoływanie się do zewnętrznych treści internetowych w rozmowach z Bobem.
| Możliwość | Szczegóły |
|---|---|
| Format | @https://example.com |
| Przetwarzanie | Używa bezgłowej przeglądarki (headless browser) do pobierania zawartości |
| Oczyszczanie | Usuwa skrypty, style i elementy nawigacyjne |
| Wyjście | Konwertuje treść na Markdown dla lepszej czytelności |
| Ograniczenie | Złożone strony mogą nie zostać idealnie skonwertowane |
Wzmianki o adresach URL są przydatne do powoływania się na dokumentację.
Wypróbuj Czy możesz wyjaśnić @https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise, aby uzyskać pomoc w zrozumieniu pojęcia z oficjalną dokumentacją jako kontekstem.
Używanie wzmianek kontekstowych
Wpisz @ w polu wejściowym czatu, aby wywołać dropdown z sugestiami.
Pisz dalej, aby przefiltrować sugestie, lub użyj klawiszy strzałek do nawigacji.
Wybierz za pomocą klawisza Enter lub kliknięcia myszą.
Połącz kilka wzmianek w jednym żądaniu: „Napraw @problems w @/src/component.ts”
Zaznacz tekst i użyj skrótu klawiszowego ⌘ + L, aby dodać go do czatu.
Dropdown automatycznie sugeruje:
- Ostatnio otwierane pliki
- Widoczne foldery
- Ostatnie commity Git
- Specjalne słowa kluczowe (
problems,terminal,git-changes) - Wszystkie aktualnie otwarte pliki (niezależnie od ustawień ignorowania lub filtrów katalogów)
Dropdown automatycznie odfiltrowuje popularne katalogi, takie jak node_modules, .git, dist i out, aby ograniczyć szum, choć nadal możesz uwzględnić ich zawartość, jeśli wpiszesz ją ręcznie.
Możesz łączyć wiele wzmianek w jednym żądaniu. Wypróbuj Porównaj @/src/v1/api.js z @/src/v2/api.js i wyjaśnij różnice.
Ważne zachowania
Interakcja z ignorowanymi plikami
Wzmianki kontekstowe mają określone zachowanie podczas interakcji z ignorowanymi plikami:
| Zachowanie | Opis |
|---|---|
Ominięcie .bobignore | @mentions plików i folderów omijają sprawdzenia .bobignore podczas pobierania zawartości do kontekstu. Zawartość z ignorowanych plików zostanie dołączona, jeśli zostanie bezpośrednio przywołana. |
Ominięcie .gitignore | Podobnie, @mentions plików i folderów nie respektują reguł .gitignore podczas pobierania zawartości. |
| Poszanowanie poleceń Git | Wzmianki związane z Git (@git-changes, @commit-hash) respektują .gitignore, ponieważ opierają się na poleceniach Git. |
Wzmianki kontekstowe omijają reguły ignorowania, dzięki czemu możesz odwoływać się do konkretnych plików, które normalnie byłyby ignorowane przez Boba lub Gita. Ta funkcja jest szczególnie przydatna, gdy musisz omówić wygenerowane pliki lub inne typowo ignorowane treści.
Podsumowanie
Wzmianki kontekstowe usprawniają interakcje z Bobem, dostarczając precyzyjne odniesienia do elementów Twojego projektu. Zamiast kopiować i wklejać kod lub opisywać lokalizacje plików, możesz bezpośrednio wskazać to, o czym dyskutujesz.
Skuteczne kombinacje różnych typów wzmianek:
Napraw @problems w @/src/components i wyjaśnij, co było nie takPrzejrzyj @git-changes i zaproponuj ulepszeniaPorównaj @/v1/api.js z @https://api-docs.example.com i sprawdź pod kątem niespójności
Efektywnie korzystając ze wzmianek kontekstowych, możesz precyzyjniej komunikować się z Bobem i otrzymywać lepiej dopasowaną pomoc.
Subagents
Dowiedz się, jak Bob używa subagents do obsługi skoncentrowanych, samodzielnych zadań w izolowanych kontekstach bez zaśmiecania głównej rozmowy.
Wskazówki Bob
Wskazówki Bob wykrywają problemy z jakością kodu w czasie rzeczywistym, dostarczając sugestie refaktoryzacji oparte na AI dla złożonych funkcji. Redukuj dług techniczny podczas pisania kodu.