Skill oluşturma ve kullanma
Bob'a tekrarlanabilir bir changelog girişi workflow'u öğreten yeniden kullanılabilir bir skill oluştur, ardından onu açıkça çağır ya da Bob'un otomatik olarak etkinleştirmesine izin ver.
Skill, Bob'a özelleştirilmiş, tekrarlanabilir bir workflow öğreten yeniden kullanılabilir bir talimat setidir. Her prompt'ta aynı biçimlendirme kurallarını veya kontrol listesini yeniden yazmak yerine, workflow'u bir kez SKILL.md dosyasında tanımlarsın. Bob daha sonra, skill'i doğrudan çağırsan da Bob kendi kendine aktive etse de, skill geçerli olduğunda her zaman bu talimatlara uyar.
Bu eğitimde, Keep a Changelog formatını kullanarak CHANGELOG.md dosyasına girişler ekleyen bir skill oluşturuyorsun (dosya yoksa oluşturarak). Skill'i slash komutuyla açıkça çağırıyor, ardından ikinci bir değişiklik yapıyor ve Bob'dan skill adını vermeden kaydetmesini isteyerek Bob'un skill'i açıklamasına göre otomatik olarak aktive etmesini gözlemliyorsun.
Ön koşullar
Bu eğitimi tamamlamak için şunlara ihtiyacın var:
- Henüz sahip değilsen, Galaxium Travels demo kodunu klonla.
git clone https://github.com/IBM/galaxium-travels- Galaxium Travels demo kodu açık olan Bob IDE.
- Zorunlu olmasa da, önce /init ve AGENTS.md ile proje başlatma ve Bob için etkili prompt'lar yazma eğitimlerini tamamlamayı düşün.
Changelog girişi skill'i oluşturma
Sohbet arayüzünü açma
Gezinme çubuğunun yanındaki Bob simgesine tıklayarak Bob sohbet arayüzünü aç ya da Option + Command + B (macOS) veya Ctrl + Alt + B (Windows) kısayolunu kullan.
Sohbet arayüzündeki mod seçiciyi kullanarak Agent moduna geç. Agent modu, Bob'a skill'leri etkinleştirmek ve dosyaları düzenlemek için ihtiyaç duyduğu araç erişimini sağlar.
Skills ayarlarını açma
Bob'da skill oluşturmanın birden fazla yolu vardır. Kullanıcı arayüzünü (UI) kullanabilir ya da rehberli kurulum için Bob sohbetinde /create-skill komutunu kullanabilirsin.
Bu eğitimde, skill oluşturmak için Bob Ayarları'ndaki Skills sekmesini kullanırsın.
- Sohbet arayüzünün altında Bob Settings'e tıkla.
- Sol kenar çubuğunda Skills'e tıkla.
- Yeni bir skill oluşturmak için + düğmesine tıkla.
Skill ayrıntılarını doldurma
Skill oluşturma formuna aşağıdaki değerleri gir:
| Alan | Değer |
|---|---|
| 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 | Açık |
| Scope & Location | galaxium-travels |
Skill Name, skill'i doğrudan çağırmak için yazdığın şeydir, örneğin /changelog-entry. Description, skill'i adıyla çağırmadığında Bob'un bir isteğe skill'in uygulanıp uygulanmayacağına karar vermek için okuduğu şeydir.
Allow Bob to use this skill açık olduğunda, Bob bir prompt gerektirdiğinde skill'i kendi başına kullanabilir ya da açıkça çağırabilirsin. Scope & Location'ı galaxium-travels olarak ayarlamak, skill'i projenin .bob/skills/ dizinine kaydeder; böylece git onu kodla birlikte takip eder ve ekibiniz erişebilir. Bunun yerine Global (all workspaces) seçmek, skill'i depo dışındaki ~/.bob/skills/ konumuna kaydeder.
Skill Instructions metin kutusuna şunları gir:
---
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.Create'e tıkla.
Bob skill'i galaxium-travels/.bob/skills/changelog-entry/SKILL.md konumuna kaydeder.
Skill'i doğrudan çağırma
Skill'i adıyla çağırarak Bob'un uyduğu talimatlara bakabilirsin.
Küçük bir değişiklik yapma
Kaydedecek bir şeyin olması için Bob'dan küçük, düşük riskli bir düzenleme yapmasını iste:
Add a one-line note to the end of the README.md that says "Powered by IBM Bob."Bob README.md'yi düzenler. İstendiğinde düzenlemeyi onayla.
Skill ile değişikliği kaydetme
Sohbet arayüzüne /changelog-entry yaz ve Enter'a bas ya da beliren /changelog-entry önerisine tıkla. Ardından aşağıdaki prompt'ı gir:
Add a changelog entry for this change.Bob, skill araçlarını kullanmak ve dosyaları düzenlemek için izin isteyebilir. İstendiğinde onayla. Bob changelog-entry skill'ini yükler, proje CHANGELOG.md dosyasına sahip olmadığı için onu oluşturur ve skill'de tanımlanan formatı izleyen bir giriş ekler, örneğin:
## [Unreleased]
### Added
- Add "Powered by IBM Bob." note to the end of README.mdGirişi doğrulama
Bob'dan changelog'u göstermesini iste.
Show me CHANGELOG.mdGiriş, Bob'un önceki adımda oluşturduğu changelog girişiyle eşleşiyor.
Bob'un skill'i otomatik olarak etkinleştirmesine izin verme
Sohbet arayüzünün üzerindeki + düğmesine tıklayarak yeni bir görev penceresi başlat.
İkinci bir değişiklik yap ve Bob'dan skill adını vermeden kaydetmesini iste. Allow Bob to use this skill'i açık bıraktığın için, Bob skill'in açıklamasından geçerli olduğunu tanıyabilir ve kendi başına etkinleştirebilir.
Başka bir küçük değişiklik yapma
Add a one-line comment above the main heading in README.md that says "Galaxium Travels".İstendiğinde düzenlemeyi onayla.
Bob'dan skill'i adlandırmadan değişikliği kaydetmesini isteme
Update the changelog for this edit.Bob, isteğin changelog-entry skill'inin açıklamasıyla eşleştiğini tanır ve /changelog-entry yazmadan etkinleştirir. İstendiğinde skill ve dosya düzenleme izinlerini onayla. Bob aynı formatta başka bir giriş ekler.
Bu ayar açıkken, Bob changelog-entry dahil skill'leri geçerli olduklarında her zaman, önce sormadan otomatik olarak etkinleştirir.
Skill'lerini yönetme
changelog-entry'yi oluşturduğun Bob Ayarları'ndaki Skills sekmesi, aynı zamanda mevcut ve genel workspace'te kullanılabilen tüm skill'leri görüntülediğin yerdir. Workspace'in yüklü skill'lerini kontrol etmek, bir skill'in projeden (.bob/skills/) mi yoksa global (~/.bob/skills/) konumdan mı geldiğini doğrulamak ve bir skill'i düzenlemek ya da silmek için kullan.
Temizleme
Bu eğitimde oluşturulan dosyaları kaldırmak için:
- Bob Settings'de Skills'e tıkla, ardından
changelog-entryskill'ini sil. - Ön koşullarda klonlanan
galaxium-travelsdizinini sil. Bu, bu eğitimde yapılanCHANGELOG.mdveREADME.mddüzenlemelerini de kaldırır.
Sonraki adımlar
Bu eğitimde, skill'lerin bir workflow'u bir kez tanımlamanı ve Bob'un onu tutarlı biçimde uygulamasını sağladığını öğrendin; /skill-name ile skill'i açıkça çağırsan da Bob'un açıklamasına göre otomatik olarak etkinleştirmesine izin versen de.
Özel mod ekleme bölümüne geç ve özel modların belirli bir iş için rol tanımını, davranış talimatlarını ve araç erişimini nasıl uzmanlaşmış bir persona'da birleştirdiğini öğren.