cli-skills

Umiejętność zawierająca best practices do tworzenia interfejsów wiersza poleceń w Go. Obejmuje wzorce dla frameworka Cobra (obsługa komend i flag), biblioteki Bubbletea (interfejsy tekstowe) oraz Lipgloss (stylizacja terminala). Rozszerza podstawowe umiejętności Go o konkretne implementacje dla CLI, strukturę katalogów, obsługę błędów i zarządzanie stanem. Idealna dla deweloperów pracujących nad narzędziami CLI w ekosystemie LlamaFarm.

1. Zainstaluj umiejętność w swoim projekcie LlamaFarm, umieszczając ją w katalogu .claude/skills/. Upewnij się, że masz Go 1.24+ oraz wymagane zależności: Cobra, Bubbletea, Lipgloss i Bubbles.

2. Przejrzyj strukturę katalogów opisaną w umiejętności — cli/cmd/ dla implementacji komend Cobra, cli/internal/tui/ dla komponentów interfejsu tekstowego. Zapoznaj się z konwencjami nazewnictwa i organizacją kodu.

3. Podczas implementacji nowych komend Cobra używaj RunE zamiast Run dla lepszej obsługi błędów. Rejestruj flagi w funkcjach init() i wykorzystuj persistent flags dla opcji wspólnych dla wielu komend.

4. Jeśli budujesz interfejs tekstowy, implementuj interfejs Bubbletea z metodami Init(), Update() i View(). Zarządzaj stanem za pomocą typów wiadomości i zwracaj tea.Cmd dla operacji asynchronicznych.

5. Do stylizacji terminala definiuj style jako stałe na poziomie pakietu przy użyciu lipgloss.NewStyle(). Obsługuj dynamiczną szerokość terminala i umożliwij zmianę motywu kolorów poprzez zmienne stylów.

6. Rozszerzaj umiejętność o dodatkowe wzorce z dokumentacji shared Go skills — szczególnie sekcje dotyczące obsługi błędów, współbieżności i idiomatycznych wzorców Go, które stanowią fundament dla CLI.