Tworzenie i używanie skillów
Utwórz wielokrotnie używalny skill, który uczy Boba powtarzalnego workflow dla wpisów changelog, a następnie wywołaj go wprost lub pozwól Bobowi aktywować go automatycznie.
Skill to wielokrotnie używalny zestaw instrukcji, który uczy Boba wyspecjalizowanego, powtarzalnego workflow. Zamiast przepisywać te same zasady formatowania lub listę kontrolną w każdym prompcie, definiujesz workflow raz w pliku SKILL.md. Bob następnie stosuje się do tych instrukcji za każdym razem, gdy skill ma zastosowanie – niezależnie od tego, czy wywołujesz go bezpośrednio, czy Bob aktywuje go sam.
W tym samouczku tworzysz skill, który dodaje wpisy do pliku CHANGELOG.md w formacie Keep a Changelog, tworząc plik, jeśli jeszcze nie istnieje. Wywołujesz skill wprost za pomocą polecenia slash, następnie wprowadzasz drugą zmianę i prosisz Boba o jej zalogowanie bez podawania nazwy skilla, aby zobaczyć, jak Bob aktywuje go automatycznie na podstawie jego opisu.
Wymagania wstępne
Aby ukończyć ten samouczek, potrzebujesz:
- Jeśli jeszcze go nie masz, sklonuj demo kod Galaxium Travels.
git clone https://github.com/IBM/galaxium-travels- Bob IDE z otwartym demo kodem Galaxium Travels.
- Choć nie jest to wymagane, rozważ wcześniejsze ukończenie Uruchamianie projektu z /init i AGENTS.md i Pisanie skutecznych promptów dla Boba.
Tworzenie skilla dla wpisów changelog
Otwieranie interfejsu czatu
Otwórz interfejs czatu Boba, klikając ikonę Boba obok paska nawigacji, lub użyj skrótu Option + Command + B (macOS) lub Ctrl + Alt + B (Windows).
Przełącz się do trybu Agent za pomocą selektora trybu w interfejsie czatu. Tryb Agent daje Bobowi dostęp do narzędzi potrzebnych do aktywowania skillów i edytowania plików.
Otwieranie ustawień Skills
Istnieje kilka sposobów tworzenia skilla w Bobie. Możesz użyć interfejsu użytkownika (UI) lub polecenia /create-skill w czacie Boba dla konfiguracji z przewodnikiem.
W tym samouczku używasz karty Skills w ustawieniach Boba do tworzenia skilla.
- Pod interfejsem czatu kliknij Bob Settings.
- Kliknij Skills na lewym pasku bocznym.
- Kliknij przycisk +, aby utworzyć nowy skill.
Wypełnianie szczegółów skilla
Wprowadź następujące wartości w formularzu tworzenia skilla:
| Pole | Wartość |
|---|---|
| Skill Name | changelog-entry |
| Description | Adds an entry to CHANGELOG.md using the Keep a Changelog format, creating the file if it does not exist, so change history stays consistent and release-ready. |
| Allow Bob to use this skill | Włączone |
| Scope & Location | galaxium-travels |
Skill Name to to, co wpisujesz, aby wywołać skill bezpośrednio, np. /changelog-entry. Description to to, co Bob czyta, aby zdecydować, czy skill ma zastosowanie do żądania, gdy nie wywołujesz go po nazwie.
Gdy Allow Bob to use this skill jest włączone, Bob może samodzielnie używać skilla, gdy prompt tego wymaga, lub możesz wywołać go wprost. Ustawienie Scope & Location na galaxium-travels zapisuje skill w katalogu .bob/skills/ projektu, dzięki czemu git śledzi go razem z kodem, a twój zespół może mieć do niego dostęp. Wybranie zamiast tego Global (all workspaces) zapisałoby skill poza repozytorium w ~/.bob/skills/.
Wprowadź następujące treści w polu tekstowym Skill Instructions:
---
name: changelog-entry
description: Adds an entry to CHANGELOG.md using the Keep a Changelog format, creating the file if it does not exist, so change history stays consistent and release-ready.
user-invocable: true
---
Add an entry to CHANGELOG.md using the Keep a Changelog format (https://keepachangelog.com/).
- If CHANGELOG.md does not exist, create it at the project root with this structure before adding an entry:
# Changelog
All notable changes to this project are documented in this file.
The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
## [Unreleased]
- Add new entries under the `## [Unreleased]` section, under one of these subheadings: `### Added`, `### Changed`, `### Fixed`, `### Removed`. Create the subheading if it is not already present under `## [Unreleased]`.
- Write each entry as a single bullet point in the imperative mood ("Add", not "Added"), starting with a capital letter, with no trailing period.
- Base the entry on the actual diff, not on the wording of the request. Run `git diff` to review what changed before writing the entry.
- Only edit CHANGELOG.md. Do not stage or commit the change.Kliknij Create.
Bob zapisuje skill w galaxium-travels/.bob/skills/changelog-entry/SKILL.md.
Bezpośrednie wywołanie skilla
Wywołaj skill po nazwie, aby zobaczyć instrukcje, których Bob przestrzega.
Dokonanie małej zmiany
Poproś Boba o dokonanie małej, bezpiecznej edycji, abyś miał coś do zalogowania:
Add a one-line note to the end of the README.md that says "Powered by IBM Bob."Bob edytuje README.md. Zatwierdź edycję, gdy zostaniesz o to poproszony.
Rejestrowanie zmiany za pomocą skilla
W interfejsie czatu wpisz /changelog-entry i naciśnij Enter lub kliknij pojawiającą się sugestię /changelog-entry. Następnie wprowadź następujący prompt:
Add a changelog entry for this change.Bob może poprosić o pozwolenie na użycie narzędzi skilla i edycję plików. Zatwierdź, gdy zostaniesz o to poproszony. Bob ładuje skill changelog-entry, tworzy CHANGELOG.md, ponieważ projekt go nie ma, i dodaje wpis zgodny z formatem zdefiniowanym w skilla, podobny do:
## [Unreleased]
### Added
- Add "Powered by IBM Bob." note to the end of README.mdWeryfikacja wpisu
Poproś Boba, aby pokazał ci changelog.
Show me CHANGELOG.mdWpis jest zgodny z wpisem changelog wygenerowanym przez Boba w poprzednim kroku.
Pozwolenie Bobowi na automatyczne aktywowanie skilla
Uruchom nowe okno zadania, klikając przycisk + nad interfejsem czatu.
Dokonaj drugiej zmiany i poproś Boba o jej zalogowanie bez podawania nazwy skilla. Ponieważ zostawiłeś Allow Bob to use this skill włączone, Bob może rozpoznać na podstawie opisu skilla, że ma zastosowanie, i aktywować go samodzielnie.
Dokonanie kolejnej małej zmiany
Add a one-line comment above the main heading in README.md that says "Galaxium Travels".Zatwierdź edycję, gdy zostaniesz o to poproszony.
Prośba Boba o zalogowanie zmiany bez podawania nazwy skilla
Update the changelog for this edit.Bob rozpoznaje, że żądanie pasuje do opisu skilla changelog-entry i aktywuje go bez wpisywania /changelog-entry. Gdy zostaniesz o to poproszony, zatwierdź uprawnienia skilla i edycji pliku. Bob dodaje kolejny wpis w tym samym formacie.
Przy włączonej tej opcji Bob automatycznie aktywuje skille, w tym changelog-entry, za każdym razem, gdy mają zastosowanie, bez wcześniejszego pytania.
Zarządzanie skillami
Karta Skills w ustawieniach Boba, gdzie utworzyłeś changelog-entry, to również miejsce, gdzie możesz zobaczyć wszystkie skille dostępne w bieżącym i globalnym workspace'ie. Użyj jej, aby sprawdzić załadowane skille workspace'u, potwierdzić, czy skill pochodzi z projektu (.bob/skills/) czy z globalnej lokalizacji (~/.bob/skills/), oraz edytować lub usunąć skill.
Porządkowanie
Aby usunąć pliki utworzone w tym samouczku:
- W Bob Settings kliknij Skills, a następnie usuń skill
changelog-entry. - Usuń katalog
galaxium-travelssklonowany w wymaganiach wstępnych. Spowoduje to również usunięcieCHANGELOG.mdi edycjiREADME.mddokonanych w tym samouczku.
Następne kroki
W tym samouczku nauczyłeś się, jak skille pozwalają ci zdefiniować workflow raz i mieć Boba stosującego go konsekwentnie, niezależnie od tego, czy wywołujesz skill wprost za pomocą /skill-name, czy pozwalasz Bobowi aktywować go automatycznie na podstawie jego opisu.
Przejdź do Dodawanie niestandardowego trybu, aby dowiedzieć się, jak niestandardowe tryby łączą definicję roli, instrukcje behawioralne i dostęp do narzędzi w wyspecjalizowaną personę dla określonego zadania.
Pisanie skutecznych promptów dla Boba
Zmaksymalizuj output Boba, pisząc skuteczne prompty.
Dodaj możliwości Boba
Rozszerz możliwości zawodowe Boba, tworząc niestandardowy tryb menedżera produktu z dostosowaną definicją roli, instrukcjami behawioralnymi i deterministycznymi ograniczeniami dostępu do narzędzi.