AI agent uchun skill yozish: qachon kerak va qanday tuziladi

AI agent bilan bir necha oy ishlaganingizdan keyin bitta naqsh paydo bo'ladi: siz ba'zi ko'rsatmalarni qayta-qayta yozayotgan bo'lasiz. "Bu loyihada Bun ishlatiladi", "fayl bu yerda saqlanadi", "avval qoralama qil, nashr qilma".

Bu ko'rsatma emas. Bu — hujjatlashtirilmagan protsedura. Va uni har safar qo'lda yozayotgan bo'lsangiz, siz odam sifatida keshiga aylanib qolgansiz.

Skill aynan shu muammoni yechadi: takrorlanadigan protsedurani faylga yozib qo'yasiz, agent kerakli paytda uni o'zi ochadi.

Skill nima

Texnik jihatdan skill — bu markdown fayl. Boshida qisqa metama'lumot, keyin ko'rsatmalar matni.

---
name: notion-blog-writer
description: Blog uchun maqola yozish va Notion'ga qoralama saqlash.
  Foydalanuvchi "maqola yoz" desa ishlatiladi.
---

# Oqim

## 1. Brifni tushun
...

Asosiy g'oya oddiy: bu matn har doim kontekstda turmaydi. Agent uni faqat kerak bo'lganda yuklaydi. Shuning uchun siz o'nlab skill yozsangiz ham ular bir-birini bo'g'maydi.

Aynan shu narsa skillni oddiy loyiha hujjatidan ajratib turadi. Hujjat — u yerda turadi va kimdir o'qishini kutadi. Skill esa o'z-o'zini kerakli vaqtda chaqiradi.

Eng muhim qator — description

Skill yozganda odamlar butun kuchini ko'rsatmalar matniga sarflaydi va tavsifni shoshib yozadi. Bu teskari bo'lishi kerak.

Sabab: agent qaysi skillni ochishni faqat tavsif asosida hal qiladi. Ko'rsatmalar matni hali unga ko'rinmaydi. Ya'ni tavsif yomon bo'lsa, ichidagi eng mukammal ko'rsatmalar ham hech qachon ishga tushmaydi.

Yomon tavsif:

description: Blog bilan ishlash uchun yordamchi

Yaxshi tavsif:

description: Blog uchun maqola yozish va Notion'ga qoralama saqlash.
  "Maqola yoz", "yangi maqola", "blogga joyla" so'rovlarida ishlatiladi.
  Maqolani uz/ru/en uch tilda yozadi.

Farqi shundaki, ikkinchisida trigger iboralar bor. Foydalanuvchi qanday so'zlar bilan murojaat qilishi mumkinligini to'g'ridan-to'g'ri yozib qo'yasiz. Bu eng katta ta'sirni beradigan bitta o'zgarish.

Ko'rsatmalarni qadamga bo'ling

Skillning tanasi uchun eng ishonchli shakl — raqamlangan qadamlar. Nasr emas, ro'yxat.

Mening blog skillim shunday tuzilgan: navbatni tekshir, brifni tushun, o'zbekcha qoralama yoz, tasdiqlat, tarjima qil, payload yoz, saqla, hisobot ber.

Qadamlar ikki narsani beradi. Birinchisi — tartib aniq bo'ladi, agent bosqichni o'tkazib yubormaydi. Ikkinchisi va muhimrog'i — tekshirish nuqtalari paydo bo'ladi. Men skillga "tasdiqlagunicha nashrga o'tma" deb yozib qo'yganman, va bu bitta jumla xato nashrdan bir necha bor saqlab qoldi.

Tuzoqlarni albatta yozing

Skillning eng qimmatli qismi — ko'rsatmalar emas, tuzoqlar ro'yxati. Ya'ni siz bir marta yeb ko'rgan xatolar.

Mening blog skillimda shunday yozuv bor: Notion'da ikkita alohida sana ustuni bor, biri saytda ko'rinadi va saralanadi, ikkinchisi avtomatik nashr triggeri. Ular ajralib qolsa maqola noto'g'ri sana bilan chiqadi.

Bu bir necha oy oldin haqiqatan sodir bo'lgan: nashr jadvalini o'zgartirganimda faqat bitta ustunni ko'chirganman va bir nechta maqola saytda kelajak sanasi bilan turib qolgan.

Endi bu tuzoq faylda yozilgan. Ya'ni men uni ikkinchi marta yeb ko'rmayman va bu bilim mening yodimda emas, tizimda saqlanadi.

Amaliy qoida: har safar agent bilan ishlaganda biror xato chiqsa, o'zingizdan so'rang — "bu qayta takrorlanadimi?". Javob ha bo'lsa, u tuzatilgandan keyin skillga bitta qator qo'shing.

Skill kontekstni qanday tejaydi

Skillning texnik qiymati ko'pincha noto'g'ri tushuniladi. Odamlar uni "agentga ko'proq ma'lumot berish" deb o'ylashadi. Aslida u teskarisini qiladi — kamroq berishga imkon yaratadi.

Sabab shundaki, kontekst chegarali resurs. Agar siz barcha ko'rsatmalarni loyiha hujjatiga yozib, uni har suhbatda yuklasangiz, o'nta protsedura o'nta suhbatning hammasida joy egallaydi — ulardan to'qqiztasi kerak bo'lmasa ham.

Skill esa ikki bosqichli: agent avval faqat qisqa tavsiflar ro'yxatini ko'radi, to'liq matnni esa aynan kerak bo'lganda ochadi.

Bu amaliy natija beradi: skillni uzun yozishdan qo'rqmasa bo'ladi. Mening blog skillim yetti qadam, bir nechta kod misoli va tuzoqlar ro'yxatidan iborat. Agar shu matn har suhbatda yuklanadigan bo'lganda, men uni qisqartirishga majbur bo'lardim va aynan eng foydali qismi — tafsilotlar — yo'qolardi.

Bitta katta skill emas, bir nechta kichik

Ikkinchi tuzilma masalasi: bitta katta skill yozish yoki bir nechta kichik.

Men kichiklarni afzal ko'raman va sabab yuqoridagidan kelib chiqadi. Agar "loyiha bilan ishlash" degan bitta ulkan skill yozsangiz, u har xil sababdan ochiladi va har safar butunligicha yuklanadi. Deploy qilayotganda sizga kontent yozish qoidalari kerak emas.

Chegarani shunday o'tkazish kerak: bitta skill — bitta yakunlanadigan vazifa. Maqola yozish. Reliz chiqarish. Hisobot tayyorlash.

Agar skill tavsifida "va" so'zi ikki martadan ko'p uchrasa, u ehtimol ikkitaga bo'linishi kerak.

Qachon skill kerak emas

Bu qismni ko'pincha tashlab ketishadi, lekin u muhim.

Skill kerak emas, agar:

• Vazifa bir martalik bo'lsa. Bir marta bajariladigan ish uchun oddiy prompt yetarli.
• Ko'rsatma qisqa bo'lsa. Bitta jumlani skillga o'rash — ortiqcha qatlam.
• Bilim allaqachon kodda bo'lsa. Agent kodni o'qiy oladi; unga kod tuzilishini takrorlab yozish keraksiz mehnat.
• Ko'rsatma tez-tez o'zgarsa. Har hafta o'zgaradigan narsani faylga muzlatib qo'ysangiz, u tez orada yolg'onga aylanadi.

Eng yaxshi nomzod — barqaror, takrorlanadigan va tuzoqlari bor protsedura. Deploy tartibi, reliz checklisti, hisobot formati, kontent oqimi.

Skillni qanday sinash kerak

Skill yozgandan keyin uni albatta sinash kerak, chunki eng ko'p uchraydigan nosozlik — u umuman ishga tushmasligi.

Sinov oddiy: yangi suhbat boshlang va foydalanuvchi yozadigan tabiiy ibora bilan murojaat qiling. Skill ochilmasa, muammo deyarli har doim tavsifda — trigger iboralar yetishmayapti.

Ikkinchi sinov — chetga chiqish. Ko'rsatmadan biroz og'ishgan so'rov bering va skill mo'ljallanganidek moslashadimi yoki qotib qoladimi, ko'ring. Yaxshi skill qattiq skript emas, u yo'nalish beradi.

Xulosa

Skill — bu agentga bergan xotirangiz. Uni yozish sarmoya, va u faqat bitta shartda o'zini oqlaydi: protsedura haqiqatan takrorlansa.

Boshlash uchun eng oson yo'l — keyingi safar AI agentga uzun ko'rsatma yozganingizda o'zingizdan so'rang: "buni yana yozamanmi?". Javob ha bo'lsa, o'sha promptni faylga ko'chiring, boshiga yaxshi tavsif yozing va qadamlarga bo'ling.

Mening bloglagi maqolalarim shu tarzda yoziladi: men mavzuni aytaman, qolgan hamma narsa — tuzilma, uch til, sana qo'yish, tuzoqlardan qochish — faylda yozilgan va o'zi bajariladi.