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.
Skills to wielokrotnego użytku zestawy instrukcji, które uczą Boba nowych workflows i wyspecjalizowanych zadań. Pomyśl o nich jak o przepisach, które Bob stosuje, aby wykonywać określone rodzaje pracy w spójny i powtarzalny sposób.
Dlaczego warto używać skills
- Wielokrotnego użytku: Definiuj workflows raz i używaj ich w wielu rozmowach.
- Spójność: Zapewnij, że Bob będzie stosował to samo podejście za każdym razem dla konkretnych zadań.
- Specjalizacja: Twórz specjalistyczną wiedzę domenową dla przeglądów kodu, testowania, dokumentacji i więcej.
- Współpraca zespołowa: Udostępniaj standardowe workflows zespołowi przez kontrolę wersji.
- Elastyczność: Dołączaj pliki pomocnicze, takie jak listy kontrolne, szablony i materiały referencyjne.
Jak działają skills
Gdy aktywujesz skill, Bob otrzymuje instrukcje skilla i uzyskuje dostęp do plików pomocniczych w katalogu skilla. Bob następnie stosuje te instrukcje, aby wykonać twoje zadanie zgodnie ze zdefiniowanym workflow.
Skills są ładowane raz na rozmowę, aby unikać zduplikowanych promptów. Bob automatycznie określa, kiedy aktywować skill na podstawie twojego żądania i opisu skilla.
Tworzenie skilla
Podstawowa konfiguracja
Utwórz folder w .bob/skills/ w katalogu głównym projektu lub użyj ~/.bob/skills/ dla globalnych skills.
Dodaj plik SKILL.md wewnątrz tego folderu.
Przykładowa struktura:
Format SKILL.md
Plik SKILL.md używa frontmatter YAML, po którym następują instrukcje skilla:
---
name: code-review
description: Review code for bugs, security issues, and best practices
---
When reviewing code, check for:
- Security vulnerabilities
- Performance issues
- Missing error handling at API boundaries
- Unused imports and dead code
Provide a summary with severity levels for each finding.Wymagane pola:
name: Nazwa wyświetlana skilla w interfejsie Bobadescription: Jasne podsumowanie, które pomaga Bobowi zdecydować, kiedy aktywować ten skill — skills bez opisów są ignorowane
Sekcja instrukcji:
Wszystko poniżej ogranicznika --- staje się instrukcjami, które Bob otrzymuje po aktywacji skilla.
Dodawanie plików pomocniczych
Możesz dodawać pliki i podfoldery obok SKILL.md, aby dostarczyć materiały referencyjne, szablony, listy kontrolne, skrypty lub inne zasoby. Bob może automatycznie odczytywać te pliki po aktywacji skilla.
Przykład z plikami pomocniczymi:
Pliki i foldery pomocnicze mogą zawierać:
- Listy kontrolne i szablony
- Dokumentację referencyjną
- Przykłady konfiguracji
- Skrypty i narzędzia w podfolderach
- Przewodniki stylu
- Wszelkie inne zasoby potrzebne dla skilla
Lokalizacje skills
Skills można definiować na dwóch poziomach:
| Lokalizacja | Zakres | Przypadek użycia |
|---|---|---|
<project>/.bob/skills/ | Specyficzny dla projektu | Workflows unikalne dla tego projektu |
~/.bob/skills/ | Globalny | Osobiste lub ogólnoorganizacyjne workflows |
Priorytet: Jeśli oba miejsca zawierają skill o tej samej nazwie, skill na poziomie projektu ma pierwszeństwo.
Zatwierdzanie skills
Domyślnie Bob pyta o pozwolenie przed aktywacją skilla. Daje ci to kontrolę nad tym, kiedy stosowane są wyspecjalizowane workflows.
Aby pominąć prompt zatwierdzania:
Otwórz ustawienia Boba.
Przejdź do sekcji Automatyczne zatwierdzanie.
Włącz przełącznik dla Skills.
Po włączeniu tego ustawienia Bob automatycznie aktywuje skills, gdy to właściwe, bez proszenia o pozwolenie.
Zakładka ustawień Skills
Zakładka Skills w ustawieniach Boba zapewnia centralne miejsce do przeglądania i zarządzania skills dostępnymi w twoim workspace. Użyj jej, aby zobaczyć, które skills są załadowane, sprawdzić ich lokalizacje i zweryfikować, że skills z katalogów projektu lub globalnych są poprawnie wykrywane.
Pisanie efektywnych skills
Jasne opisy
Pisz opisy, które wyraźnie wskazują, kiedy skill powinien być używany. Bob polega na tych opisach, aby określić trafność skilla.
Dobrze: "Review code for bugs, security issues, and best practices"
Unikaj: "Code review skill"
Skupione instrukcje
Trzymaj główny plik SKILL.md skupiony na głównym workflow. Przenieś szczegółowe materiały referencyjne, przykłady i listy kontrolne do plików pomocniczych.
Przykład:
---
name: api-documentation
description: Generate API documentation following OpenAPI standards
---
Generate API documentation that includes:
- Endpoint descriptions
- Request/response schemas
- Authentication requirements
- Example requests and responses
Follow the style guide in `api-style-guide.md` and use the template in `api-template.md`.Wykonalne kroki
Strukturuj instrukcje jako jasne, wykonalne kroki, które Bob może systematycznie stosować.
Przykład:
---
name: feature-implementation
description: Implement new features following team standards
---
<Steps>
<Step>
Review the feature requirements.
</Step>
<Step>
Create a plan with file changes needed.
</Step>
<Step>
Implement the feature with tests.
</Step>
<Step>
Update documentation.
</Step>
<Step>
Verify all tests pass.
</Step>
</Steps>
Follow coding standards in `coding-standards.md`.Przykładowe skills
Skill przeglądu kodu
---
name: security-review
description: Review code for security vulnerabilities and best practices
---
Perform a security-focused code review:
<Steps>
<Step>
Check for common vulnerabilities:
- SQL injection risks
- XSS vulnerabilities
- Authentication/authorization issues
- Sensitive data exposure
</Step>
<Step>
Review security best practices:
- Input validation
- Output encoding
- Secure configuration
- Error handling
</Step>
<Step>
Provide findings with:
- Severity level (Critical, High, Medium, Low)
- Location in code
- Recommended fix
- Reference to security standards
</Step>
</Steps>
Use the severity guide in `severity-levels.md` for classification.Skill dokumentacji
---
name: api-docs
description: Generate comprehensive API documentation
---
Create API documentation that includes:
<Steps>
<Step>
Overview section:
- Purpose and use cases
- Authentication requirements
- Base URL and versioning
</Step>
<Step>
For each endpoint:
- HTTP method and path
- Description and purpose
- Request parameters
- Request body schema
- Response codes and schemas
- Example requests and responses
</Step>
<Step>
Additional sections:
- Error handling
- Rate limiting
- Pagination
</Step>
</Steps>
Follow the template in `api-doc-template.md` and examples in `api-examples.md`.Wskazówki i najlepsze praktyki
- Zacznij prosto: Zacznij od podstawowych instrukcji i udoskonalaj na podstawie wyników.
- Używaj plików pomocniczych: Trzymaj
SKILL.mdzwięzłym, przenosząc szczegółową zawartość do plików towarzyszących. - Dokładnie testuj: Sprawdź, czy skills działają zgodnie z oczekiwaniami przed udostępnieniem ich swojemu zespołowi.
- Kontrola wersji: Dołącz skills projektu do repozytorium dla spójności zespołu.
- Jasne nazewnictwo: Używaj opisowych nazw skills, które wskazują ich cel.
- Pojedyncza odpowiedzialność: Twórz skupione skills dla konkretnych zadań, zamiast próbować obsługiwać wiele niezwiązanych workflows.