Literate Coding
Pisz kod z pomocą AI bezpośrednio w edytorze, używając instrukcji w języku naturalnym dokładnie tam, gdzie kod powinien się znaleźć. Bob generuje implementację w kontekście z inline diff.
Dlaczego warto używać Literate Coding?
- Zostań w swoim workflow: Pisz kod bez przełączania się na interfejsy czatu
- Zachowaj precyzyjną kontrolę: Określ dokładnie, gdzie i jak AI ma modyfikować Twój kod
- Wyrażaj intencje naturalnie: Opisz, czego chcesz, w języku naturalnym lub pseudocode
- Przeglądaj zmiany przed zatwierdzeniem: Sprawdź diff, aby upewnić się, że wygenerowany kod spełnia Twoje wymagania
Jak to działa
Po aktywowaniu trybu Literate Coding możesz pisać instrukcje w języku naturalnym, pseudocode, adnotacje lub fragmenty kodu bezpośrednio w pliku źródłowym. Te instrukcje są wyróżnione na niebiesko, aby odróżnić je od zwykłego kodu.
Po uruchomieniu polecenia Generate Bob:
- Analizuje cały plik, w tym bloki Literate Coding
- Rozumie otaczający kontekst i Twoją intencję
- Zastępuje instrukcje prawdziwym, wykonywalnym kodem
- Pokazuje Ci inline diff, abyś mógł przejrzeć zmiany
To podejście łączy ekspresywność języka naturalnego z precyzją bezpośredniego edytowania kodu.
Pierwsze kroki
Podstawowe użycie
- Przełącz tryb Literate Coding:
- Naciśnij Cmd+I (Mac) lub Ctrl+I (Windows/Linux)
- Albo kliknij ikonę różdżki na pasku narzędzi edytora
- Napisz instrukcje:
- Wpisz pseudocode, instrukcje w języku naturalnym lub adnotacje
- Twój tekst pojawi się na niebiesko, oznaczając go jako zawartość Literate Coding
- Wygeneruj kod:
- Naciśnij Cmd+Enter (zalecane) lub kliknij przycisk Generate
- Bob przekształca Twoje instrukcje w prawdziwy kod i pokazuje inline diff
- Przejrzyj i zastosuj:
- Zaakceptuj zmiany: Cmd+Enter
- Odrzuć zmiany: Cmd+Shift+Backspace
- Zmiany są zapisywane do pliku przed akceptacją, co pozwala przetestować je przed podjęciem decyzji
Dowiedz się, jak generować kod z komentarzy używając Literate Coding.
Wskazówki i najlepsze praktyki
- Bądź konkretny w swoich wymaganiach zawartych w instrukcjach
- Dołącz istotny kontekst, taki jak typy zmiennych lub parametry funkcji
- Dla złożonej logiki podziel instrukcje na mniejsze, skoncentrowane bloki
- Używaj Literate Coding zarówno do tworzenia nowego kodu, jak i modyfikowania istniejącego
Aktualne ograniczenia
- Zakres pojedynczego pliku: Aktualnie działa na jednym pliku na raz (obsługa wielu plików planowana)
- Funkcja w wersji zapoznawczej: Spodziewaj się ciągłych ulepszeń w stylizacji, diffingu i zachowaniu AI
Pull requesty
Generuj pull requesty i opisy PR bezpośrednio z twojego IDE. Bob analizuje zmiany, tworzy szczegółowe opisy i usprawnia przepływ pracy.
Skills
Twórz wielokrotnego użytku zestawy instrukcji dla wyspecjalizowanych workflows. Definiuj niestandardowe workflows, dodawaj pliki pomocnicze i ucz Boba wyspecjalizowanych zadań dla spójnych wyników.