Agent qarorlari uchun Jev Skills’ni o‘rnatish va undan foydalanish

Jev Skills nima qiladi

Awesome Jev Skills — AI agentlari ish jarayonlariga tuzilmali qarorlarni qo‘shish uchun o‘rnatiladigan to‘qqizta skill to‘plami. Jev nomzodlar orasidan tanlaydi, kiritilgan ma’lumotlarni tasniflaydi va belgilangan mezonlarni baholaydi. Kontekstni yig‘ish, vositalarni chaqirish, ishni bajarish va natijalarni tekshirish uchun javobgarlik agentingizda qoladi.

Repozitariyda 90 ta ssenariy va yozib olingan kirish-chiqish natijalaridan iborat 14 ta misol mavjud. Undagi retseptlar uzoq davom etadigan agentlar, baholash, yo‘naltirish, kontekstni boshqarish, brauzer bilan ishlash, kiruvchi xatlarni saralash, hujjatlardagi dalillar, dasturchi vositalari, simulyatsiyalar, o‘yinlar va ijodiy ish jarayonlarini qamrab oladi.

Jev tanlaydi yoki baholaydi. U tugmalarni bosmaydi, xabar yubormaydi, fayllarni o‘zgartirmaydi, media yaratmaydi yoki tanlangan amalni bajarmaydi.

Asosiy imkoniyatlar

• Tuzilmali qaror turlari: Bitta nomzodni tanlash uchun choice, mustaqil rost yoki yolg‘on xulosasi uchun noul va darajalar bo‘yicha baholash uchun score dan foydalaning.
• Ixtisoslashgan skilllar: Saralash, hujjatlar, foydalanuvchi interfeyslari, yo‘naltirish, kontekst, kodni ko‘rib chiqish, kodni topish va simulyatsiya uchun skilllarni o‘rnating.
• Agent nazorat nuqtalari: Jevdan takroriy xatolarni aniqlashni, yakunlanganlik dalillarini baholashni, yo‘nalish tanlashni yoki taklif etilgan amal maqsadga erishishga yordam berishini baholashni so‘rang.
• Parallel xulosalar: Umumiy holatga oid bir nechta mustaqil savolni bitta so‘rovga joylashtiring yoki host agentga mustaqil so‘rovlarni cheklangan parallellik bilan rejalashtirishga ruxsat bering.
• Oflayn tekshirish: Tarmoq so‘rovi yubormasdan yoki tasniflashni amalga oshirmasdan kiritilgan ma’lumotni tekshirish uchun --dry-run dan foydalaning.
• Aniq simulyatsiya rejimi: OpenRouter kaliti mavjud bo‘lmasa, joriy agentingiz ayni xulosani faqat ushbu rejimni ma’qullaganingizdan keyin simulyatsiya qilishi mumkin.

Skill tanlash

• jev: Maxsus qarorni belgilang yoki umumiy agent nazorat nuqtasini qo‘shing.
• jev-triage: Xabarlar, tiketlar yoki fikr-mulohazalarni tasniflang va ustuvorlashtiring.
• jev-documents: Manba parchalarini tanlang va ularni qo‘llab-quvvatlovchi dalillarni baholang.
• jev-ui: Avval kuzatilgan brauzer yoki ish stoli amallari orasidan tanlang.
• jev-route: Vositani, modelni yoki mutaxassisni tavsiya qiling.
• jev-context: Relevatlikni baholang va kontekstni ixchamlashtirish qachon maqsadga muvofiqligini aniqlang.
• jev-code-review: Kod o‘zgarishlarini ko‘rib chiqish uchun ustuvorlashtiring.
• jev-find-code: Kuzatilgan fayllar ro‘yxatidan keyingi joylashuvni tanlang.
• jev-simulation: Simulyatsiya qilingan dunyoda ruxsat etilgan amallarni tanlang.

O‘rnatish

Agent yordamida tavsiya etiladigan o‘rnatish

Tavsiya etiladigan yo‘l — o‘rnatish vazifasini Codex, Claude Code yoki OpenCode agentiga berish. Quyidagi promptni agentingizga joylashtiring:

Joriy agentim uchun Jev Skills’ni, jumladan umumiy skill va barcha ssenariy skilllarini o‘rnating. Ushbu o‘rnatish qo‘llanmasini o‘qing va unga amal qiling, so‘ng o‘rnatishni tekshiring:
https://raw.githubusercontent.com/wuyoscar/jev-skill/main/docs/install.md

Agent muhitingizni tekshiradi, odatda joriy loyiha ichiga o‘rnatadi va o‘rnatishni oflayn rejimda tekshiradi. Standart o‘rnatish yo‘li Node, npm yoki Vercel akkauntini talab qilmaydi. Agent yuborgan tasdiqlash so‘rovlarini ko‘rib chiqing.

Qo‘lda o‘rnatish yoki muammolarni bartaraf etish uchun qo‘lda o‘rnatish qo‘llanmasiga murojaat qiling.

Haqiqiy Jev kirishini sozlash

Haqiqiy Jev chaqiruvlari uchun OPENROUTER_API_KEY talab qilinadi. Uni OpenRouter sozlamalari orqali yarating va mahalliy ravishda sozlang. Kalitni hech qachon chatga joylashtirmang. Jonli chaqiruvlar API’dan foydalanadi va foydalanish uchun haq olinishi mumkin.

Kalit topilmasa, agent sizni ogohlantirishi va quyidagi variantlardan birini tanlashingizni kutishi kerak:

1. A varianti: Kalitni oling va mahalliy ravishda sozlang, so‘ng haqiqiy Jev’dan foydalaning.
2. B varianti: Joriy agentga ayni kontekst, nomzodlar va mezonlar yordamida tasniflashni simulyatsiya qilishga ruxsat bering.

Simulyatsiya natijalari mode: agent_simulation va jev_called: false deb belgilanishi kerak. Ular Jev javoblari yoki kalibrlangan Jev ehtimollari emas, shuning uchun agent ehtimol qiymatlarini o‘ylab topmasligi kerak.

Simulyatsiya rejimi va dry-run rejimi farq qiladi. Simulyatsiya joriy agentning xulosasini hosil qiladi. Dry run esa faqat so‘rov formatini tekshiradi va hech qanday tasniflashni amalga oshirmaydi.

Asosiy foydalanish

O‘rnatilgan saralash misolini sinab ko‘ring

O‘rnatishdan so‘ng agentingizdan jev-triage tarkibidagi misoldan foydalanishni so‘rang. Ushbu mashq kiritilgan ma’lumotni ko‘rsatadi, bajarilish rejimini tasdiqlaydi va agentning pochta qutisi bilan amallar bajarishiga yo‘l qo‘ymaydi.

jev-triage skillidan foydalaning va o‘rnatilgan papkasidagi assets/example.json faylini o‘qing. Undagi kontekst, savollar va nomzodlarni ko‘rsating. Agar OPENROUTER_API_KEY mavjud bo‘lmasa, mendan A: haqiqiy Jev uchun kalitni sozlash yoki B: joriy agentga simulyatsiya qilishni ruxsat berish variantidan birini tanlashimni so‘rang. Tanlovimni kuting. API rejimida --dry-run bilan tekshiring, so‘ng bitta Jev chaqiruvini bajaring. Simulyatsiya rejimida natijani "Agent simulation; Jev not called" deb belgilang va ehtimollarni o‘ylab topmang. To‘liq kirish ma’lumotlari, chiqish natijasi va rejimni ko‘rsating. Pochta qutimga kirmang yoki amallarni bajarmang.

Agar agent yangi o‘rnatilgan skillni topa olmasa, undan o‘rnatish katalogini tekshirishni va mijozingiz talab qilsa, sessiyani qayta yuklashni so‘rang.

So‘rov tuzilmasini tushunish

Jev so‘rovi model, umumiy holat va bir yoki bir nechta savolni taqdim etadi. Har bir savol o‘z turini, ko‘rsatmalarini va zarur bo‘lganda nomzod mezonlarini belgilaydi. Quyidagi qisqartirilgan misolda bir xil parser xatosi takrorlangandan keyin agent nima qilishi kerakligi so‘raladi:

{
  "model": "typesafe/jev-1.13",
  "state": {
    "goal": "CSV parserini tuzating va ish tugaganini e’lon qilishdan oldin testlarni tekshiring.",
    "recent_result": "Bir xil UnicodeDecodeError ikki marta yuz berdi; manba o‘zgarmadi.",
    "observation": "Parser fayllarni aniq kodlashni ko‘rsatmasdan ochadi."
  },
  "questions": {
    "next_step": {
      "type": "choice",
      "instructions": "Dalillarga asoslanib, keyingi foydali qadamni tanlang.",
      "criteria": {
        "inspect_input": "Kiritish va faylni ochish kodini tekshiring.",
        "retry_unchanged": "Faqat vaqtinchalik shart o‘zgargan bo‘lsa, qayta urinib ko‘ring.",
        "report_done": "Faqat testlar muvaffaqiyatli o‘tganda tugaganini bildiring.",
        "ask_user": "Muhim vakolat yoki ma’lumot yetishmasa, so‘rang."
      }
    },
    "stuck": {
      "type": "noul",
      "instructions": "O‘zgarmagan urinishlar bir xil xatoni takrorladimi?"
    }
  }
}

Repositoryda qayd etilgan sintetik API misolida Jev inspect_inputni tanladi va stuck = trueni qaytardi. Bu taqdim etilgan dalillarga asoslangan qaror bo‘lib, tuzatishni bajarish emas.

Ixtiyoriy buyruq satridan foydalanish

Agar jev-decide o‘rnatilgan bo‘lsa, to‘liq so‘rovni request.json sifatida saqlang. Avval uni oflayn rejimda tekshiring:

jev-decide decide request.json --dry-run

OpenRouter’ga yuboriladigan ma’lumotlarni ko‘rib chiqib, tasdiqlaganingizdan so‘ng bitta haqiqiy so‘rov yuboring va natijani saqlang:

jev-decide decide request.json > result.json

Agar faqat umumiy ko‘nikma o‘rnatilgan va buyruq mavjud bo‘lmasa, uning Python skriptidan foydalaning:

python3 <actual-skill-directory>/scripts/jev.py decide request.json --dry-run

Har doim result.jsonni tekshiring. 0 chiqish kodi natija tanlangan yoki baholanganini, 2 ko‘rib chiqish talab etilishini, 1 esa xatolik yuz berganini anglatadi. Muvaffaqiyatli tanlov ham tanlangan amalni bajarmaydi.

Amaliy ish jarayoni: Qaror nazorat nuqtalarini qo‘shish

Jev har bir arzimas agent qadamiga emas, balki muhim qaror nuqtalariga mo‘ljallangan. Xatolar takrorlanganda, yo‘nalish tanlanishi kerak bo‘lganda yoki agent ish tugaganini e’lon qilmoqchi bo‘lganda nazorat nuqtasini qo‘shing.

CSV tahlilini tuzatish va dastlabki testlardan o‘tishni ta’minlashda qarorlarni qo‘llab-quvvatlash uchun jev ko‘nikmasidan foydalaning. Kalit yetishmasa, haqiqiy Jev yoki joriy agent simulyatsiyasidan birini tanlashimni so‘rang. Xatolar takrorlanganda, yo‘nalish tanlash kerak bo‘lganda yoki ish tugaganini e’lon qilmoqchi bo‘lganingizda tanlangan rejimdan foydalaning. Maqsad, qabul qilish tekshiruvlari, tegishli tarix, yangi vosita natijalari, ruxsatlar va har bir nomzod amalining ma’nosini taqdim eting. Faqat mavjud vakolat doirasida harakat qiling va natijani keyin tekshiring.

Tugallash nazorat nuqtasi artefakt identifikatorlari, test tasdiqlari, reviziya xeshlari, fayl tizimi tekshiruvlari va ish holati kabi haqiqiy dalillarni qabul qilishi kerak. Jev taqdim etilgan dalillar da’voni qo‘llab-quvvatlashini baholashi mumkin, ammo test haqiqatan ishga tushganini yoki fayl mavjudligini tasdiqlay olmaydi. Bu faktlar vositalardan olinishi kerak.

Yozuvlarni xavfsiz tasniflash

Fikr-mulohazalar, qo‘llab-quvvatlash murojaatlari yoki boshqa yozuvlar uchun kichik, maxfiy ma’lumotlari olib tashlangan namunadan boshlang. Kattaroq to‘plamni qayta ishlashdan oldin toifalar, savollar va tashqariga yuboriladigan ma’lumotlarni kelishib oling.

1. Vakillik qiluvchi uchta yozuvni tanlang.
2. Har bir yozuvning identifikatori, asl matni va tegishli kontekstini saqlang.
3. billing, bug, how-to va other kabi toifalarni belgilang.
4. Mashinangizdan aynan nimalar chiqib ketishini ko‘rib chiqing.
5. Haqiqiy API rejimi yoki aniq tasdiqlangan simulyatsiya rejimini tanlang.
6. Ishonchsiz natijalarni inson ko‘rib chiqishi uchun alohida saqlang.
7. To‘plam hajmi yoki byudjetni oshirishdan oldin namunani tekshiring.

Bitta so‘rovda har bir yozuv haqida bir nechta savol, masalan, toifa va shoshilinchlik haqida so‘rashingiz mumkin. Mustaqil so‘rovlar uchun xost agent cheklangan parallel ishlashdan foydalanishi mumkin; CLI’ning o‘zi parallel ishlarni boshlamaydi.

Kengaytirilgan maslahatlar

To‘liq kontekstni taqdim eting

Jev agentingiz suhbatini avtomatik meros qilib olmaydi. Maqsad, qoidalar, tegishli tarix, manba dalillari, joriy kuzatuvlar, ruxsatlar, nomzod ma’nolari va qabul qilish tekshiruvlarini kiriting. Qaror savolini tor doirada saqlang, ammo uning dalillarini sun’iy ravishda kamaytirmang.

Barcha bog‘liq maydonlarni yangilang

Shablonni moslashtirganda state, questions va criteriani birgalikda yangilang. Faqat misol matnini o‘zgartirish nomzod ta’riflarini haqiqiy vazifaga mos kelmaydigan holatda qoldirishi mumkin.

Qarorlarni vakolatdan ajrating

Yuqori ball olgan amal avtomatik ravishda ruxsat etilgan hisoblanmaydi. Mavjud ruxsatlar va xavfsizlik nazoratlari bajarilishni boshqarishda davom etadi. Xuddi shuningdek, reja va taklif qilingan vosita chaqiruvi o‘rtasidagi muvofiqlik ularning birortasi vakolatli ekanini isbotlamaydi.

Bog‘liq qadamlar uchun yangi holatdan foydalaning

Mustaqil baholashlar bitta holatni ulashishi yoki bir vaqtda bajarilishi mumkin. Bog‘liq qarorlar oldingi amaldan keyingi yangi kuzatuvlardan foydalanishi kerak. Jev ochiq rejalashtirish, vositalarni bajarish yoki matn yaratishning o‘rnini bosmaydi.

Qiymatlarni to‘g‘ri talqin qiling

noul savoli uchun probability tanlangan qiymat noto‘g‘ri bo‘lsa ham, bayonotning rost bo‘lish ehtimolini bildiradi. 1.29 / 2 kabi rubrika bali ehtimollik emas, baholangan balldir.

Dalillar va rejimlarni saqlang

To‘liq kiritilgan ma’lumotni, me’yorlashtirilgan natijani, mavjud bo‘lsa xom kvitansiyani va bajarish rejimini saqlang. Tanlangan javobga moslashtirish uchun qarama-qarshi dalillarni qayta yozmang. Agent simulyatsiyasini hech qachon haqiqiy API javobi sifatida taqdim etmang.

Jev’ni xost vositalari bilan birlashtirish

Brauzerdagi bosishlar, xabarlarni yetkazish, fayllarni tahrirlash, musiqa yaratish va video render qilish uchun alohida vositalar talab etiladi. Jev nomzodlarni reytinglashi yoki kuzatilgan qonuniy amallar orasidan tanlashi mumkin, xost ilovasi esa tanlangan amalni bajaradi va tekshiradi.

Xulosa

Jev Skills agent ish jarayonlariga aniq tanlovlar, tasniflar, ballar va dalillarni tekshirishni qo‘shish uchun qayta foydalaniladigan andozalarni taqdim etadi. Agent yordamidagi o‘rnatishdan boshlang, taqdim etilgan misolni sinang, so‘rovlarni --dry-run yordamida tekshiring va ko‘lamni kengaytirishdan oldin kichik namunani ko‘rib chiqing. Eng yaxshi natijalar to‘liq kontekst, aniq belgilangan nomzodlar, ochiq ko‘rsatilgan bajarish rejimlari va har bir muhim amaldan keyingi mustaqil tekshiruv orqali olinadi.