Standaryzuj zachowanie Boba w swoim zespole, używając plików reguł na poziomie projektu, które instruują Boba, aby dokumentował swój kod i pamiętał swoje poprzednie działania.

Reguły Boba to zwykłe pliki tekstowe, które definiują instrukcje stosowane do każdej rozmowy z Bobem. Bob przechowuje reguły jako pliki w wyznaczonym folderze w projekcie lub na globalnym poziomie użytkownika i automatycznie wstrzykuje zawartość każdego pliku reguł do każdej rozmowy we wszystkich trybach. Wstrzykiwanie reguł pozwala zespołom i indywidualnym programistom egzekwować standardy kodowania, preferencje komunikacyjne i ograniczenia przepływu pracy bez powtarzania instrukcji w każdym poleceniu.

Reguły na poziomie projektu w galaxium-travels/.bob są kontrolowane wersją wraz z kodem, co oznacza:

Reguły propagują się automatycznie do wszystkich członków zespołu, którzy klonują repozytorium.

Zmiany w regułach przechodzą przez normalny proces przeglądu kodu.

Historia reguł jest śledzona w git.

W tym samouczku instruujesz Boba, aby mówił zwięźle, dokumentował swój kod i pamiętał swoje poprzednie działania, dodając pliki reguł w katalogu .bob. Ponieważ uwzględnisz te pliki w kontroli wersji, Bob zastosuje je w całym zespole.

Wymagania wstępne

Aby ukończyć ten samouczek, potrzebujesz następujących elementów:

Jeśli jeszcze go nie masz, sklonuj kod demonstracyjny Galaxium Travels. Polecenie klonowania sprawdza również gałąź bob-learning-path-branch, która zawiera kod używany w samouczkach.

git clone -b bob-learning-path-branch https://github.com/IBM/galaxium-travels

Bob IDE z otwartym kodem demonstracyjnym Galaxium Travels

Ukończ samouczek Rozpocznij projekt, aby utworzyć folder .bob.

Chociaż nie jest to wymagane, rozważ wykonanie Samouczka szybkiego startu, aby zapoznać się z interfejsem i funkcjami Boba.

Python lub Python 3. Możesz pobrać Pythona z oficjalnej strony internetowej.

Utwórz niestandardowy plik reguł Boba

Polecenie /init Boba tworzy folder .bob z plikami AGENTS.md dla każdego trybu Boba, które kierują zachowaniem Boba w każdym trybie. Utwórz własne niestandardowe reguły, dodając nowy plik do folderu rules. Bob odczyta zawartość pliku reguł, co oznacza, że dodane instrukcje będą miały zastosowanie do wszystkich interakcji z Bobem.

Utwórz folder reguł

Jeśli folder rules nie istnieje jeszcze w .bob, utwórz go.

Utwórz plik reguł

Utwórz plik w galaxium-travels/.bob/rules/ o nazwie basic_rules.md.

Plik .bob/rules/basic_rules.md utworzony w projekcie

Utwórz niestandardowe reguły Boba

W pliku basic_rules.md utwórz niestandardowe reguły, dodając następujący tekst:

Dodaj regułę standardu dokumentacji

Always include concise JSDoc strings for every public function.

Reguła standardu dokumentacji zapewnia, że Bob generuje spójną dokumentację za każdym razem, gdy Bob pisze lub modyfikuje funkcje publiczne, niezależnie od zadania.

Dodaj regułę stylu komunikacji

Be very concise in your wording.

Reguła stylu komunikacji kontroluje sposób, w jaki Bob formułuje odpowiedzi i komentarze, co jest przydatne dla zespołów, które preferują zwięzłe, bezpośrednie wyniki zamiast szczegółowych wyjaśnień.

Dodaj regułę wewnętrznego monologu

Write a summary of every interaction into the folder `internal-monologue/`.
Name the file starting with a timestamp, followed by a concise description of the interaction.
Example: 2026-01-15_update-readme.md

Wewnętrzny monolog tworzy trwały dziennik wszystkiego, co Bob zrobił we wszystkich rozmowach.

Korzyści z wewnętrznego monologu obejmują:

Ścieżka audytu: Zapis tego, jakie zmiany wprowadził Bob i kiedy.
Ciągłość między sesjami: Bob może odwoływać się do folderu wewnętrznego monologu w przyszłych rozmowach, aby zrozumieć wcześniejszą pracę.
Przejrzystość zespołu: W udostępnionych repozytoriach monolog pokazuje, co różni członkowie zespołu zrobili z Bobem.

Po dodaniu wszystkich reguł plik basic_rules.md będzie wyglądał następująco:

Plik basic_rules.md ze wszystkimi trzema dodanymi niestandardowymi regułami

Przetestuj reguły

Otwórz pasek boczny czatu agentycznego, przełącz się na tryb kodu i uruchom następujące polecenie, aby Bob edytował README.md. Bob może zasugerować takie rzeczy jak ulepszenie z lepszym rozwiązywaniem problemów, całkowite przerobienie lub naprawienie nieścisłości. Możesz wybrać sugestię, która najlepiej pasuje do Twojej wizji README.

Update the readme

Bob aktualizuje README.md i tworzy folder o nazwie internal-monologue oraz tworzy plik, który pokazuje aktualizacje, które wprowadził do README.

Bob aktualizuje README.md i tworzy plik wewnętrznego monologu

Następne kroki

W tym samouczku nauczyłeś się, jak reguły Boba pozwalają definiować trwałe instrukcje, które mają zastosowanie do każdej rozmowy i trybu. Reguły na poziomie projektu są kontrolowane wersją wraz z kodem, więc Twój zespół automatycznie dzieli te same standardy. Wzorzec wewnętrznego monologu zapewnia ścieżkę audytu działań Boba we wszystkich sesjach.

Przejdź do Dodaj możliwości Boba, aby dowiedzieć się o tworzeniu niestandardowych trybów, które definiują wyspecjalizowane persony z dostosowanymi instrukcjami i specyficznym dostępem do narzędzi.

Standaryzacja zachowania Boba