Viserys bilan izchil AI kodlash ish jarayonlarini qanday yaratish

Viserys nima?

Viserys — AI kodlash agentlari uchun muhandislik ish jarayonlarining mustaqil to‘plami. Agentga har bir so‘rov uchun jarayonni o‘zi o‘ylab topishga ruxsat berish o‘rniga, u qayta foydalaniladigan Markdown ko‘rsatmalari, sharhlovchi personajlari, umumiy ma’lumotnomalar, hayotiy sikl buyruqlari, baholash moslamalari va tekshiruv skriptlarini taqdim etadi.

Loyiha dasturiy ta’minot bilan ishlashni olti bosqichli hayotiy siklga ajratadi:

DEFINE -> PLAN -> BUILD -> VERIFY -> REVIEW -> SHIP

Har bir ish jarayoni SKILL.md faylida joylashadi hamda protseduraviy qadamlar, yakunlash mezonlari va o‘zini oqlashga qarshi ko‘rsatmalarni o‘z ichiga oladi. Ko‘nikmalar oddiy Markdown formatida bo‘lgani uchun ularni ko‘nikmalarni taniydigan kodlash agentlari yuklashi yoki mustaqil ko‘rsatmalar sifatida to‘g‘ridan-to‘g‘ri o‘qishi mumkin.

Asosiy imkoniyatlar

• Hayotiy sikl qamrovi: Ish jarayonlari talablar, rejalashtirish, amalga oshirish, testlash, ko‘rib chiqish va relizga tayyorgarlikni qamrab oladi.
• 26 ta tayyor ko‘nikma: skills/ katalogida qayta foydalaniladigan muhandislik ish jarayonlari mavjud.
• Sharhlovchi personajlari: Ixtisoslashgan agentlar kod sifati, testlash, xavfsizlik va veb-ishlash samaradorligini baholaydi.
• OpenCode integratsiyasi: Asosiy rejimdagi Viserys agenti kiritilgan bo‘lib, ko‘nikmalarni global konfiguratsiyasiz yuklaydi.
• Umumiy ma’lumotnomalar: Tekshiruv ro‘yxatlari agent kontekstiga doimiy joylashtirilmaydi, balki kerak bo‘lganda yuklanadi.
• Tekshiruv va baholash: Node.js skriptlari ko‘nikmalar, buyruqlar, artefakt yo‘llari, ma’lumotnoma havolalari, versiyalar va baholash holatlarini tekshiradi.

Repository tuzilmasini tushunish

• skills/ ko‘nikma ish jarayonlarini o‘z ichiga oladi.
• agents/ to‘rtta ixtisoslashgan sharhlovchi personajini o‘z ichiga oladi.
• references/ kerak bo‘lganda foydalaniladigan umumiy tekshiruv ro‘yxatlarini taqdim etadi.
• commands/ hayotiy sikl buyruqlarini belgilaydi.
• evals/ ko‘nikmalarni baholash holatlari va moslamalarini o‘z ichiga oladi.
• scripts/ tekshiruv vositalari va baholash ishga tushirgichini o‘z ichiga oladi.
• hooks/ sessiya hayotiy sikli ilgaklarini taqdim etadi.
• docs/ ichki hujjatlarni o‘z ichiga oladi.
• .opencode/agent/viserys.md OpenCode agentini belgilaydi.
• .opencode/opencode.json OpenCode uchun ko‘nikma yo‘llarini ro‘yxatdan o‘tkazadi.

O‘rnatish va sozlash

1-variant: OpenCode’da Viserys’ni faollashtirish

1. Viserys repository’sini Git yordamida klonlang.
2. Klonlangan repository jildini OpenCode’da oching.
3. Agent tanlash oynasini ochish uchun Tab tugmasini bosing.
4. viserysni tanlang.

Kiritilgan Viserys agenti asosiy rejimda ishlaydi, shuning uchun u OpenCode agentlari ro‘yxatida ko‘rinadi. Uning prompti so‘rovni qayta ishlashdan oldin tegishli ko‘nikmani tekshiradi va ishni loyiha hayotiy sikli orqali yo‘naltiradi. Repository darajasidagi OpenCode konfiguratsiyasi barcha tayyor ko‘nikmalarni ro‘yxatdan o‘tkazadi, shuning uchun global konfiguratsiya talab qilinmaydi.

2-variant: Viserys’dan boshqa ko‘nikmalarni taniydigan agent bilan foydalanish

Claude Code, Cursor yoki qayta foydalaniladigan ko‘nikmalarni qo‘llab-quvvatlaydigan boshqa agent uchun agentni repository’ning skills/ katalogiga yo‘naltiring. Shu bilan birga, ushbu katalogni vositaning mahalliy ko‘nikmalar joylashuviga nusxalashingiz mumkin.

Aniq manzil kodlash agentiga bog‘liq. Viserys o‘zining Markdown ish jarayonlarini boshqa formatga o‘girishni talab qilmaydi, ammo mezbon vosita ularni qayerdan topishni bilishi kerak.

3-variant: Ko‘nikmalardan oddiy kontekst sifatida foydalanish

Agar agentda mahalliy ko‘nikmalar tizimi bo‘lmasa, tegishli SKILL.md faylini oching va uning mazmunini kontekst sifatida taqdim eting. Har bir ko‘nikma mustaqil ishlashga mo‘ljallangan, shuning uchun uning qadamlarini qo‘lda bajarishingiz yoki agentga ularni bajarishni buyurishingiz mumkin.

To‘g‘ri ish jarayonini tanlash

Qaysi ish jarayoni mos kelishiga ishonchingiz komil bo‘lmasa, using-agent-skills meta-ko‘nikmasidan boshlang. Aks holda, joriy hayotiy sikl bosqichiga mos ko‘nikmani tanlang.

DEFINE: Ishni aniqlashtirish

• Konsept noaniq bo‘lib, tizimli o‘rganishni talab qilganda idea-refinedan foydalaning.
• Talablarni bir vaqtning o‘zida bittadan savol berib to‘plash kerak bo‘lganda interview-medan foydalaning.
• Spetsifikatsiyasiz loyiha, funksiya yoki muhim o‘zgarishni boshlashdan oldin spec-driven-developmentdan foydalaning.
• Sifat mezoni mavjud bo‘lmaganda yoki faqat build muvaffaqiyatli o‘tishi uchun tekshiruvlar bostirilganda constraint-driven-developmentdan foydalaning.

PLAN: Spetsifikatsiyani vazifalarga aylantirish

Talablar barqarorlashgach, planning-and-task-breakdowndan foydalaning. U spetsifikatsiyani qabul qilish mezonlariga ega, tartiblangan va tekshiriladigan vazifalarga aylantiradi.

BUILD: Puxta amalga oshirish

• incremental-implementation bir nechta faylni qamrab oladigan o‘zgarishlarni kichik bosqichlarda kiritishga yordam beradi.
• Mantiqni amalga oshirish, xatoni tuzatish yoki xatti-harakatni o‘zgartirishda test-driven-developmentdan foydalaniladi.
• Sessiyani boshlash, vazifalarni almashtirish yoki chiqish sifati pasayganda tiklanish uchun context-engineering yordam beradi.
• To‘g‘rilik joriy rasmiy hujjatlarga bog‘liq bo‘lganda source-driven-development mos keladi.
• Mas’uliyat yuqori bo‘lib, hozir tekshirish keyinroq xatoni tuzatishdan arzonroq bo‘lganda doubt-driven-development tekshiruvni rag‘batlantiradi.
• frontend-ui-engineering foydalanuvchiga ko‘rinadigan interfeyslar ustida ishlashni yo‘naltiradi.
• api-and-interface-design API, modul chegaralari va ochiq interfeyslarni loyihalashni qo‘llab-quvvatlaydi.

VERIFY: O‘zgarish ishlashini isbotlash

• Brauzerga asoslangan amalga oshirish yoki nosozliklarni tuzatish uchun browser-testing-with-devtoolsdan foydalaning.
• Test muvaffaqiyatsiz tugaganda, build buzilganda yoki ish vaqtida kutilmagan xatti-harakat yuz berganda debugging-and-error-recoverydan foydalaning.

REVIEW: Sifat va xatarni baholash

• code-review-and-quality o‘zgarishni birlashtirishdan oldin ishlatilishi kerak.
• code-simplification ishlayotgan kodni tushunish yoki unga xizmat ko‘rsatish qiyin bo‘lib qolganida foydalidir.
• security-and-hardening foydalanuvchi kiritmalari, autentifikatsiya, ma’lumotlarni saqlash va tashqi integratsiyalarga taalluqlidir.
• performance-optimization unumdorlik talablari mavjud bo‘lganda yoki regressiyaga shubha qilinganda qo‘llanadi.

SHIP: Ishlab chiqarishga tayyorlash

• git-workflow-and-versioning koddagi o‘zgarishlar va versiyalarni boshqarishga yo‘l ko‘rsatadi.
• ci-cd-and-automation build va deploy konveyerlaridagi o‘zgarishlarni qo‘llab-quvvatlaydi.
• deprecation-and-migration eski tizimlarni olib tashlash yoki foydalanuvchilarni ko‘chirishga yordam beradi.
• documentation-and-adrs arxitektura qarorlari va ommaviy API o‘zgarishlarini qayd etadi.
• observability-and-instrumentation loglar, metrikalar, treyslar va ogohlantirishlarni qamrab oladi.
• shipping-and-launch ishlab chiqarishga yakuniy joylashtirishga tayyorgarlikni boshqaradi.

Asosiy foydalanish misoli

Faraz qilaylik, siz AI kodlash agentidan autentifikatsiyalangan yangi API endpoint qo‘shishni so‘radingiz. To‘g‘ridan-to‘g‘ri amalga oshirishga o‘tish o‘rniga, hayotiy siklni ketma-ket qo‘llang.

1. Ta’riflash: Autentifikatsiya qoidalari, kiritmalar yoki javoblar noaniq bo‘lsa, interview-me ni ishga tushiring. So‘ng kutilayotgan xatti-harakatni belgilash uchun spec-driven-development dan foydalaning.
2. Rejalashtirish: Tartiblangan vazifalar va qabul qilish mezonlarini ishlab chiqish uchun planning-and-task-breakdown ni qo‘llang.
3. Qurish: Endpoint shartnomasi uchun api-and-interface-design dan, xatti-harakat uchun esa test-driven-development dan foydalaning. Bir nechta faylni o‘zgartirish kerak bo‘lsa, incremental-implementation ni ham qo‘llang.
4. Tekshirish: Testlar ishlamasa yoki endpoint kutilmagandek ishlasa, debugging-and-error-recovery ga amal qiling.
5. Ko‘rib chiqish: Funksiya autentifikatsiya va kiritmalar bilan ishlagani uchun code-review-and-quality hamda security-and-hardening ni qo‘llang.
6. Yetkazish: Ishlab chiqarishga joylashtirishdan oldin mos Git, hujjatlashtirish, kuzatuvchanlik va ishga tushirish jarayonlaridan foydalaning.

OpenCode integratsiyasi yoqilganida, Viserys agenti avval mos ko‘nikmalarni tekshiradi. Oddiy kontekstli sozlamada esa bu tanlovni o‘zingiz amalga oshirib, agentdan tanlangan har bir Markdown ish jarayoniga amal qilishni so‘raysiz.

Reviewer personajlaridan foydalaning

Viserys agents/ ichida to‘rtta reviewer personajini o‘z ichiga oladi. Ular hayotiy sikl ko‘nikmalarini to‘ldiruvchi, muayyan yo‘nalishga qaratilgan nuqtayi nazarlarni taqdim etadi.

• agents/code-reviewer.md staff-muhandis tasdig‘i standartidan foydalanib, besh yo‘nalish bo‘yicha ko‘rib chiqadi.
• agents/test-engineer.md “isbotla” yondashuvi asosida test strategiyasi va qamrovini tekshiradi.
• agents/security-auditor.md zaifliklarni aniqlash, tahdidlarni modellashtirish va OWASP baholashini qamrab oladi.
• agents/web-performance-auditor.md Core Web Vitals ko‘rsatkichlarini tezkor yoki chuqur rejimlarda tekshiradi.

Personajni o‘zgarish xavflariga qarab tanlang. Masalan, autentifikatsiya bilan bog‘liq ishlar uchun xavfsizlik auditorini security-and-hardening bilan birga qo‘llang yoki foydalanuvchiga ko‘rinadigan interfeysni o‘zgartirgandan so‘ng web unumdorligi auditoridan foydalaning.

Ish jarayoni to‘plamini tekshirish

Ko‘nikmalar, buyruqlar, ma’lumotnomalar, versiyalar yoki baholash fixture’larini o‘zgartirgandan so‘ng taqdim etilgan Node.js skriptlarini ishga tushiring:

node scripts/validate-skills.js
node scripts/validate-commands.js
node scripts/validate-artifact-paths.js
node scripts/validate-reference-links.js
node scripts/validate-versions.js
node scripts/run-evals.js

Bu buyruqlar to‘plamning ichki tuzilishini tekshiradi va baholash to‘plamini ishga tushiradi. Ular Viserys’ni shunchaki mavjud ish jarayonlaridan foydalanish emas, balki kengaytirishda ayniqsa muhim.

Ilg‘or maslahatlar

Hayotiy sikl bosqichlarini tashlab ketmasdan ko‘nikmalarni birlashtiring

Vazifa bir nechta ko‘nikmani talab qilishi mumkin. Masalan, brauzer funksiyasi frontend-ui-engineering, test-driven-development va browser-testing-with-devtools ni birlashtirishi mumkin. Har bir ko‘nikmaning chiqish mezonlarini ko‘rinadigan holda saqlang, shunda ish jarayonlarini qo‘shish tartibsiz prompt berishga aylanib qolmaydi.

Ma’lumotnomalarni faqat kerak bo‘lganda yuklang

references/ katalogi talab bo‘yicha yuklanadigan umumiy checklistlar uchun mo‘ljallangan. Bu agentning faol kontekstini yo‘naltirilgan holda saqlash va batafsil ko‘rsatmalardan foydalanish imkonini beradi.

Versiyaga bog‘liq ishlar uchun rasmiy manbalardan foydalaning

Amalga oshirish tafsilotlari joriy hujjatlarga bog‘liq bo‘lsa, source-driven-development ni qo‘llang. Mantiqan to‘g‘ri ko‘rinadigan, ammo noto‘g‘ri taxmin qimmatga tushishi mumkin bo‘lsa, uni doubt-driven-development bilan birga ishlating.

Agent sifati pasayganda tiklaning

Uzoq sessiya izchilligini yo‘qota boshlasa, context-engineering dan foydalaning. U sessiyani sozlash, vazifalarni almashtirish va natija sifati pasaygan holatlar uchun maxsus mo‘ljallangan.

Qo‘shilgan hujjatlarga murojaat qiling

• docs/README.md to‘plam va hayotiy sikl xaritasini tushuntiradi.
• docs/skill-anatomy.md SKILL.md formatini belgilaydi.
• evals/README.md ko‘nikmalarni baholash qanday ishlashini tushuntiradi.

Ish jarayonlarini qo‘shish yoki qayta tuzishdan oldin ko‘nikma anatomiyasi spetsifikatsiyasini o‘qing, so‘ng natijani tekshirish uchun validatorlar va baholashlarni ishga tushiring.

Xulosa

Viserys AI yordamidagi ishlab chiqishni takrorlanadigan muhandislik jarayoniga aylantiradi. Avval skills/ katalogini mos agentga ulang yoki OpenCode’da to‘plamga kiritilgan Viserys agentini tanlang. Keyin DEFINE, PLAN, BUILD, VERIFY, REVIEW va SHIP bosqichlaridan izchil o‘ting, kerakli joylarda maxsus personajlar va tekshiruv skriptlaridan foydalaning.