Beceri ekleyerek Temsilci Modu'nu genişletme

Beceriler, uzmanlık bilgisi ve özel iş akışlarıyla Ajan Modu'nun özelliklerini geliştirmenize olanak tanır. Bu standartlar, Agent Skills açık standardına dayanır.

AGENTS.md dosyalarının aksine, beceriler talep üzerine uzmanlığı temsil eder. Bu yapı, modelin anlık bağlam penceresini karıştırmadan, belirli kitaplık sürümleri arasında geçiş yapma veya birleştirilebilir bir öğeyi farklı ekran boyutlarına uyarlama gibi çok sayıda özel yeteneğin Temsilci Modu'nda korunmasını sağlar.

Model, isteğinize ve becerinin açıklamasına göre beceriyi ne zaman kullanacağına bağımsız olarak karar verir. İlgili bir beceri tanımlandığında model, görevi tamamlamak için gereken talimatları ve kaynakları dinamik olarak çeker.

Bir beceriyi isteğe bağlı olarak etkinleştirmek için temsilciden beceriyle alakalı bir görev yapmasını isteyin. Belirli bir beceriyi tetiklemek için giriş kutusuna @ da girebilirsiniz.

Temel avantajları

  • Paylaşılan uzmanlık: Karmaşık iş akışlarını (ör. belirli bir ekibin çekme isteği inceleme süreci) herkesin kullanabileceği özel bir klasörde paketleyin.
  • Tekrarlanabilir iş akışları: Standart talimatlar sağlayarak karmaşık ve çok adımlı görevlerin tutarlı bir şekilde gerçekleştirilmesini sağlayın.
  • Kaynak paketleme: Talimatlarınızın yanı sıra komut dosyaları, şablonlar veya örnek veriler ekleyin. Böylece, aracı ihtiyacı olan her şeyi tek bir yerde bulabilir.
  • Bağlam penceresinin verimli kullanımı: Bağlam jetonlarını kaydetmek için başlangıçta yalnızca becerinin meta verileri (ad ve açıklama) yüklenir. Tam SKILL.md dosyası yalnızca etkinleştirme sırasında yüklenir. references/, scripts/ veya assets/ dizinlerindeki destekleyici dosyalar yalnızca temsilcinin özellikle ihtiyaç duyduğu durumlarda bağlama yüklenir.

Kendi becerilerinizi oluşturma

Temsilci, proje kökünüzde bulunan .skills/ veya .agent/skills/ dizinlerinden başlayarak becerileri arar. Özel beceri oluşturmak için aşağıdaki adımları uygulayın:

  1. Beceri için dizin oluşturun (örneğin, my-new-skill/).
  2. Yeni dizinde SKILL.md dosyası oluşturun (büyük/küçük harfe duyarlıdır).

Beceriler aşağıdaki kurallara uygun olmalıdır:

  • Her beceri için bir dizin: Her beceri, SKILL.md dosyasını ve ek kaynakları içeren kendine özgü bir dizine sahip olmalıdır.
  • İç içe yerleştirme: Tüm beceriler, proje kökündeki .skills/ veya .agent/skills/ dizininde olmalıdır. Ancak daha iyi düzen için alt dizinler kullanabilirsiniz (örneğin, skills/ui-flows/<skill name>/SKILL.md veya skills/testing/<skill name>/SKILL.md).
  • Kapsam: Şu anda yalnızca projenin kod tabanında bulunan beceriler desteklenmektedir.

SKILL.md dosyası, meta veriler için YAML bloğu, talimatlar için ise standart Markdown kullanır.

  • name: Beceri için benzersiz bir tanımlayıcı. Bu, dizin adıyla eşleşmelidir.
  • description: Beceri ne işe yarar ve temsilci beceriyi ne zaman kullanmalıdır? Bu soruların net bir şekilde açıklanması gerekir.
  • Gövde: YAML bloğunun altındaki Markdown gövdesi, beceri etkin olduğunda aracının davranışını yönlendiren talimatları içerir.
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
  author: example-org
  version: "1.0"
---

Skill content

Biçim kuralları

  • Ad: En fazla 64 karakter (yalnızca küçük harf, rakam ve tire).
  • Açıklama: En fazla 1.024 karakter.
  • Gövde içeriği: 10.000-20.000 karakter (~2.500-5.000 jeton) hedefleyin. Talimatlarınız bu sınırı aşıyorsa ayrıntılı belgeleri İsteğe bağlı beceri dizinleri bölümünde açıklandığı gibi bir kaynak dosyasına taşımayı düşünebilirsiniz.

İsteğe bağlı beceri dizinleri

SKILL.md dosyanızı kısa ve modüler tutmak için becerinizin klasöründeki aşağıdaki isteğe bağlı dizinlere ek kaynaklar ekleyebilirsiniz:

  • scripts/: Aracının çalıştırabileceği yürütülebilir kod (ör. Python veya Bash) içerir.
  • references/: Ayrıntılı teknik belgeler, API referansları veya alana özel kılavuzlar içerir.
  • assets/: Belge şablonları, kullanıcı arayüzü şemaları veya JSON şemaları gibi statik kaynakları içerir.

SKILL.md talimatlarınızda bu dosyalara referans verirken beceri kökünden göreli yollar kullanın. Örneğin: Run the script at scripts/cleanup.py.