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.

Wymagania

Skills są dostępne wyłącznie w trybie Advanced. Zapewnia to, że Bob ma dostęp do wszystkich niezbędnych narzędzi do efektywnego uruchamiania workflows opartych na skills.

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:

SKILL.md

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 Boba

description: 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:

SKILL.md

checklist.md

severity-guide.md

analyze.sh

report-generator.py

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.md zwię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.

Skills

Na tej stronie