Tekrar kullanılabilir talimat setleri oluştur ve özel workflowlar tanımla, destekleyici dosyalar ekle ve tutarlı sonuçlar için Bob'a özel görevler öğret.

Skill'ler, Bob'a yeni workflowlar ve özel görevler öğreten yeniden kullanılabilir talimat setleridir. Bunları, Bob'un belirli iş türlerini tutarlı ve tekrarlanabilir bir şekilde tamamlamak için izlediği tarifler olarak düşün.

Neden skill kullanmalısın

Yeniden Kullanılabilirlik: Workflowları bir kez tanımla ve birden fazla konuşmada kullan.

Tutarlılık: Bob'un belirli görevler için her seferinde aynı yaklaşımı izlemesini sağla.

Uzmanlaşma: Kod incelemeleri, test, dokümantasyon ve daha fazlası için alana özgü uzmanlık oluştur.

Ekip İşbirliği: Sürüm kontrolü aracılığıyla ekibinle standart workflowları paylaş.

Esneklik: Kontrol listeleri, şablonlar ve referans materyaller gibi destekleyici dosyalar ekle.

Gereksinimler

Skill'ler yalnızca Advanced modunda kullanılabilir. Bu, Bob'un skill tabanlı workflowları etkili bir şekilde çalıştırmak için gerekli tüm araçlara erişimi olmasını sağlar.

Skill'ler nasıl çalışır

Bir skill'i etkinleştirdiğinde, Bob skill'in talimatlarını alır ve skill dizinindeki destekleyici dosyalara erişim kazanır. Bob daha sonra tanımlanan workflow'a göre görevini tamamlamak için bu talimatları izler.

Skill'ler yinelenen promptları önlemek için her konuşmada bir kez yüklenir. Bob, isteğine ve skill'in açıklamasına göre bir skill'i ne zaman etkinleştireceğini otomatik olarak belirler.

Skill oluşturma

Temel kurulum

Proje kökündeki .bob/skills/ içinde bir klasör oluştur veya global skill'ler için ~/.bob/skills/ kullan.

O klasörün içine bir SKILL.md dosyası ekle.

Örnek yapı:

SKILL.md

SKILL.md formatı

SKILL.md dosyası, YAML frontmatter'ın ardından skill talimatlarını içerir:

---
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.

Zorunlu alanlar:

name: Bob arayüzünde kullanılan skill'in görünen adı

description: Bob'un bu skill'i ne zaman etkinleştireceğine karar vermesine yardımcı olan açık bir özet — açıklaması olmayan skill'ler göz ardı edilir

Talimat bölümü: --- sınırlayıcısının altındaki her şey, skill etkinleştirildiğinde Bob'un aldığı talimatlara dönüşür.

Destekleyici dosya ekleme

Referans materyalleri, şablonlar, kontrol listeleri, betikler veya diğer kaynaklar sağlamak için SKILL.md'nin yanına ek dosyalar ve alt klasörler ekleyebilirsin. Skill etkinleştirildiğinde Bob bu dosyaları otomatik olarak okuyabilir.

Destekleyici dosyalarla örnek:

SKILL.md

checklist.md

severity-guide.md

analyze.sh

report-generator.py

Destekleyici dosya ve klasörler şunları içerebilir:

Kontrol listeleri ve şablonlar

Referans belgeleri

Yapılandırma örnekleri

Alt klasörlerdeki betikler ve araçlar

Stil kılavuzları

Skill için gereken diğer kaynaklar

Skill konumları

Skill'ler iki düzeyde tanımlanabilir:

Konum	Kapsam	Kullanım durumu
`<project>/.bob/skills/`	Projeye özgü	Bu projeye özgü workflowlar
`~/.bob/skills/`	Global	Kişisel veya kuruluş genelindeki workflowlar

Öncelik: Her iki konum da aynı adda bir skill içeriyorsa, proje düzeyindeki skill öncelik kazanır.

Skill'leri onaylama

Varsayılan olarak, Bob bir skill'i etkinleştirmeden önce iznini ister. Bu, özel workflowların ne zaman uygulanacağı üzerinde kontrol sağlar.

Onay promptunu atlamak için:

Bob Ayarları'nı aç.

Otomatik Onay bölümüne git.

Skills için geçişi aç.

Bu ayar etkinleştirildiğinde, Bob izin istemeden uygun olduğunda skill'leri otomatik olarak etkinleştirir.

Skill'ler ayarlar sekmesi

Bob Ayarları'ndaki Skills sekmesi, workspace'inde kullanılabilen skill'leri görüntülemek ve yönetmek için merkezi bir yer sağlar. Hangi skill'lerin yüklendiğini görmek, konumlarını kontrol etmek ve proje veya global dizinlerindeki skill'lerin doğru şekilde algılandığını doğrulamak için kullan.

Etkili skill'ler yazma

Net açıklamalar

Skill'in ne zaman kullanılması gerektiğini açıkça belirten açıklamalar yaz. Bob, skill'in ilgisini belirlemek için bu açıklamalara güvenir.

İyi: "Review code for bugs, security issues, and best practices"

Kaçın: "Code review skill"

Odaklı talimatlar

Ana SKILL.md dosyasını temel workflow'a odaklı tut. Ayrıntılı referans materyallerini, örnekleri ve kontrol listelerini destekleyici dosyalara taşı.

Örnek:

---
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`.

Uygulanabilir adımlar

Talimatları Bob'un sistematik olarak takip edebileceği net, uygulanabilir adımlar olarak yapılandır.

Örnek:

---
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`.

Örnek skill'ler

Kod inceleme skill'i

---
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.

Dokümantasyon skill'i

---
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`.

İpuçları ve en iyi uygulamalar

Basit başla: Temel talimatlarla başla ve sonuçlara göre iyileştir.

Destekleyici dosyalar kullan: Ayrıntılı içeriği yardımcı dosyalara taşıyarak SKILL.md'yi kısa tut.

Kapsamlı test et: Skill'lerin ekibinle paylaşmadan önce beklendiği gibi çalıştığını doğrula.

Sürüm kontrolü: Ekip tutarlılığı için proje skill'lerini deponuza ekle.

Net isimlendirme: Amacı belirten açıklayıcı skill adları kullan.

Tek sorumluluk: Birden fazla ilgisiz workflow'u yönetmeye çalışmak yerine belirli görevler için odaklı skill'ler oluştur.

Skills

Bu sayfada