Membuat dan menggunakan skill
Buat skill yang dapat digunakan kembali untuk mengajarkan Bob alur kerja changelog yang berulang, lalu panggil secara eksplisit dan biarkan Bob mengaktifkannya secara otomatis.
Sebuah skill adalah kumpulan instruksi yang dapat digunakan kembali untuk mengajarkan Bob alur kerja khusus yang berulang. Daripada mengetik ulang aturan pemformatan atau checklist yang sama di setiap prompt, kamu mendefinisikan alur kerja sekali dalam file SKILL.md. Bob kemudian mengikuti instruksi tersebut setiap kali skill berlaku, baik kamu memanggilnya secara langsung maupun Bob mengaktifkannya sendiri.
Dalam tutorial ini, kamu membuat skill yang menambahkan entri ke file CHANGELOG.md menggunakan format Keep a Changelog, membuat file tersebut jika belum ada. Kamu memanggil skill secara eksplisit dengan slash command, kemudian membuat perubahan kedua dan meminta Bob untuk mencatatnya tanpa menyebut nama skill, untuk melihat Bob mengaktifkannya secara otomatis berdasarkan deskripsinya.
Prasyarat
Untuk menyelesaikan tutorial ini, kamu membutuhkan:
- Jika belum ada, clone kode demo Galaxium Travels.
git clone https://github.com/IBM/galaxium-travels- Bob IDE dengan kode demo Galaxium Travels yang sudah dibuka.
- Meskipun tidak wajib, pertimbangkan untuk menyelesaikan Memulai proyek dengan /init dan AGENTS.md dan Menulis prompt yang efektif untuk Bob terlebih dahulu.
Membuat skill changelog-entry
Buka antarmuka chat
Buka antarmuka chat Bob dengan mengklik ikon Bob di sebelah bilah navigasi, atau gunakan pintasan Option + Command + B (macOS) atau Ctrl + Alt + B (Windows).
Alihkan ke Agent mode menggunakan pemilih mode di antarmuka chat. Agent mode memberi Bob akses alat yang dibutuhkan untuk mengaktifkan skill dan mengedit file.
Buka pengaturan Skills
Ada beberapa cara untuk membuat skill di Bob. Kamu dapat menggunakan antarmuka pengguna (UI), atau menggunakan perintah /create-skill di chat Bob untuk pengaturan terpandu.
Dalam tutorial ini, kamu menggunakan tab Skills di Bob Settings untuk membuat skill.
- Di bawah antarmuka chat, klik Bob Settings.
- Klik Skills di bilah sisi kiri.
- Klik tombol + untuk membuat skill baru.
Isi detail skill
Masukkan nilai berikut dalam formulir pembuatan skill:
| Field | Value |
|---|---|
| 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 | On |
| Scope & Location | galaxium-travels |
Skill Name adalah yang kamu ketik untuk memanggil skill secara langsung, misalnya /changelog-entry. Description adalah yang dibaca Bob untuk memutuskan apakah skill berlaku untuk suatu permintaan ketika kamu tidak memanggilnya berdasarkan nama.
Ketika Allow Bob to use this skill aktif, Bob dapat menggunakan skill sendiri ketika sebuah prompt membutuhkannya, atau kamu memanggilnya secara eksplisit. Mengatur Scope & Location ke galaxium-travels menyimpan skill di direktori .bob/skills/ proyek, sehingga git melacaknya bersama codebase dan timmu dapat mengaksesnya. Memilih Global (all workspaces) sebagai gantinya akan menyimpan skill di luar repositori ke ~/.bob/skills/.
Masukkan yang berikut di kotak teks 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.Klik Create.
Bob menyimpan skill ke galaxium-travels/.bob/skills/changelog-entry/SKILL.md.
Memanggil skill secara langsung
Panggil skill berdasarkan nama agar kamu dapat melihat instruksi yang diikuti Bob.
Buat perubahan kecil
Minta Bob untuk membuat pengeditan kecil dan berisiko rendah agar kamu memiliki sesuatu untuk dicatat:
Add a one-line note to the end of the README.md that says "Powered by IBM Bob."Bob mengedit README.md. Setujui pengeditan jika diminta.
Catat perubahan dengan skill
Di antarmuka chat, ketik /changelog-entry dan tekan Enter atau klik saran /changelog-entry yang muncul. Kemudian, masukkan prompt berikut:
Add a changelog entry for this change.Bob mungkin meminta izin untuk menggunakan alat skill dan mengedit file. Setujui jika diminta. Bob memuat skill changelog-entry, membuat CHANGELOG.md karena proyek belum memilikinya, dan menambahkan entri yang mengikuti format yang didefinisikan dalam skill, serupa dengan:
## [Unreleased]
### Added
- Add "Powered by IBM Bob." note to the end of README.mdVerifikasi entri
Minta Bob untuk menampilkan changelog.
Show me CHANGELOG.mdEntri tersebut cocok dengan entri changelog yang dibuat Bob pada langkah sebelumnya.
Biarkan Bob mengaktifkan skill secara otomatis
Mulai jendela tugas baru dengan mengklik tombol + di atas antarmuka chat.
Buat perubahan kedua dan minta Bob untuk mencatatnya tanpa menyebut nama skill. Karena kamu membiarkan Allow Bob to use this skill aktif, Bob dapat mengenali dari deskripsi skill bahwa skill tersebut berlaku dan mengaktifkannya sendiri.
Buat perubahan kecil lainnya
Add a one-line comment above the main heading in README.md that says "Galaxium Travels".Setujui pengeditan jika diminta.
Minta Bob mencatat perubahan, tanpa menyebut nama skill
Update the changelog for this edit.Bob mengenali bahwa permintaan tersebut cocok dengan deskripsi skill changelog-entry dan mengaktifkannya tanpa kamu mengetik /changelog-entry. Jika diminta, setujui izin skill dan pengeditan file. Bob menambahkan entri lain dalam format yang sama.
Dengan pengaturan ini aktif, Bob secara otomatis mengaktifkan skill, termasuk changelog-entry, setiap kali berlaku, tanpa bertanya terlebih dahulu.
Mengelola skill kamu
Tab Skills di Bob Settings, tempat kamu membuat changelog-entry, juga tempat kamu melihat setiap skill yang tersedia di workspace saat ini dan global. Gunakan untuk memeriksa skill yang dimuat workspace, mengonfirmasi apakah skill berasal dari lokasi proyek (.bob/skills/) atau global (~/.bob/skills/), serta mengedit atau menghapus skill.
Pembersihan
Untuk menghapus file yang dibuat dalam tutorial ini:
- Di Bob Settings, klik Skills, lalu hapus skill
changelog-entry. - Hapus direktori
galaxium-travelsyang di-clone pada prasyarat. Ini juga menghapusCHANGELOG.mddan pengeditanREADME.mdyang dilakukan dalam tutorial ini.
Langkah selanjutnya
Dalam tutorial ini, kamu mempelajari bagaimana skill memungkinkan kamu mendefinisikan alur kerja sekali dan Bob menerapkannya secara konsisten, baik kamu memanggil skill secara eksplisit dengan /skill-name maupun membiarkan Bob mengaktifkannya secara otomatis berdasarkan deskripsinya.
Lanjutkan ke Menambahkan mode kustom untuk mempelajari cara mode kustom menggabungkan definisi peran, instruksi perilaku, dan akses alat menjadi persona khusus untuk pekerjaan tertentu.