LLM Wiki — LLM muayyan sohada materiallarni qanday topishi va ulardan foydalanishini tartibga soluvchi Wiki. U savolga qarab LLM qaysi materialni avval o‘qishi kerakligini ko‘rsatadi va materiallar mazmuni farq qilganda qaysi manbaga ustuvorlik berishni bildiradi.
Shuningdek, u hali tekshirilmagan ma’lumotlarni alohida qayd etib boradi. Ish jarayonida yangi tekshirilgan ma’lumotlar Wiki’ga qayta qo‘shilgani uchun keyingi vazifani allaqachon tartibga solingan mezonlar va qolgan savollardan boshlash mumkin.
LLM Wiki nima uchun kerak
Ko‘plab hujjatlarni bir joyga to‘plashning o‘zi ularni darhol bilimga aylantirmaydi. Agar LLM kerakli materiallar qayerdaligini, qaysi ma’lumot eng so‘nggi ekanini yoki turli yozuvlar ziddiyatga kelganda qaysi biriga amal qilish kerakligini bilmasa, ko‘plab hujjatlarni o‘qiganidan keyin ham noto‘g‘ri javob berishi mumkin.
Kutubxonaning kitoblar shunchaki uyib qo‘yilgan ombordan farqi shundaki, unda tasniflash va kataloglar mavjud. VUI LLM Wiki materiallarni xuddi shu tarzda tartibga soladi. U ish turiga qarab qaysi hujjatlarni o‘qish kerakligini toraytiradi hamda har bir materialning joylashuvi va ustuvorligini ko‘rsatadi.
Javob topib bo‘lmagan holatlar ham qayd etiladi. Vaqtincha ko‘rib chiqilgan mazmun va hali tekshirilmagan savollarni qoldirish LLM’ning bo‘sh joylarni taxminlar bilan to‘ldirishining oldini oladi va keyingi vazifaga ishni shu nuqtadan qayta ko‘rib chiqish imkonini beradi.
VUI LLM Wiki yaratilishining kelib chiqishi
Menga uzoq muddatli VUI Design System yaratish vazifasi yuklatildi. Muammo shundaki, men vizual dizayn bo‘yicha tizimli ravishda o‘qitilmagan edim va ekranga qarab, uning “VUI’ga o‘xshash” yoki “VUI’ga o‘xshamaydigan” ekanini darhol baholash qiyin edi.
Faqat shaxsiy sezgiga tayanib, uzoq muddat saqlab turish mumkin bo‘lgan Design System yaratish qiyin bo‘lishini angladim. Shuning uchun avvalo VUI dizaynini baholashda nimalarni tekshirish kerakligini va yana shu muammoga duch kelganda bu baholashni qanday qayta tiklashni tartibga solishim kerak edi.
VUI LLM Wiki tamoyillarini tartibga solish
VUI’ni baholashda foydalanilgan materiallar Figma dizaynlari, VUI manba kodi va mavzulari, generatsiya qilingan tokenlar va komponent spetsifikatsiyalari, Storybook hamda QA yozuvlaridan iborat bo‘lib bir nechta joyda joylashgan edi. Wiki bu materiallardan nusxa ko‘chirmaydi; aksincha, har bir savolga tegishli materiallarga yetib borish yo‘li va ustuvorliklarini tartibga soladi.
1. Ma’lumotnoma materiallari
Figma dizayner ko‘zlagan ko‘rinishni ko‘rsatadi. packages/vui-ui va packages/vui-theme hozir ishlayotgan kodni, generatsiya qilingan tokenlar va komponent spetsifikatsiyalari esa mavjud nomlar va funksiyalarni tartibga soladi. Amalga oshirish natijalarini taqqoslash uchun Storybook, Figma Sync hisobotlari va QA yozuvlaridan foydalaniladi.
2. Baholash mezonlari
Materiallar farq qilganda authority.md faylida tartibga solingan ketma-ketlikka amal qiling. Yangi dizaynni ko‘chirishda Figma’dan maqsad sifatida foydalaning; joriy xatti-harakatni tushuntirishda esa manba kodi va mavzuni tekshiring. Komponentlar, tokenlar va ekran andozalari tegishli ro‘yxatlarga ajratilgan, hali yakunlanmagan ma’lumotlar esa gap-index.md faylida alohida qayd etiladi.
3. O‘qish yo‘li
wiki.md vazifaga mos boshlang‘ich nuqtani ko‘rsatadi. Shundan so‘ng faqat tegishli komponent kartasi, token hujjati yoki ekran andozasini o‘qing. DESIGN.md tez-tez takrorlanadigan vazifalar uchun kerakli hujjatlar ro‘yxatini yanada toraytiradigan o‘qish ro‘yxatidir; qaror talab qilinganda asl materiallarga qaytuvchi havolalarga amal qiling.
Direktoriya tuzilishi
docs/design ichida bu tamoyillar to‘rtta hujjat guruhiga bo‘lingan. wiki.md sizni vazifaga mos hujjatlarga yo‘naltirgani uchun har bir fayl nomini yodlab olishingiz shart emas.
Kirish nuqtalari va qoidalar docs/design/wiki.md, authority.md, validation.md
wiki.md vazifaga xos boshlang‘ich nuqtalarni taqdim etadi. authority.md materiallar farq qilganda qaysi biriga amal qilishni belgilaydi, validation.md esa Wiki yangilangandan keyin tekshirilishi kerak bo‘lgan bandlarni jamlaydi.
Ro‘yxatlar docs/design/profiles/company/*-index.md
Bu ro‘yxatlar komponentlar, tokenlar, ekran andozalari va hal qilinmagan bandlarni alohida tartibga soladi. Ular joriy savolga tegishli hujjatlargina tanlab oladi.
Batafsil hujjatlar components/*.card.md, patterns/*.md, tokens/*.md
Ular komponentlardan foydalanish, ekranlarni tuzish usullari va tokenlardan foydalanish tamoyillarini zarur batafsillik darajasida tushuntiradi.
Vazifaga xos o‘qish ro‘yxatlari DESIGN.md, exports/*.DESIGN.md
Ular CRUD ro‘yxat ekranlari yoki Forms kabi takroriy vazifalar uchun kerak bo‘ladigan hujjatlargina jamlaydi. LLM butun Wiki’ni o‘qish o‘rniga shu yerdan boshlaydi va qaror talab qilinganda asl materiallarni tekshiradi.
Figma Sync’dan foydalanish va uni yangilash
Dizayner ma’qullagan Figma dizaynini VUI komponentlari va Storybook’ga ko‘chirish jarayoni Figma Sync deb ataladi. Bu shunchaki ekranni o‘xshash ko‘rinishga keltirishdan iborat emas. Komponent holatlari mavjud API bilan bog‘lanishi, VUI tokenlari esa faqat Storybook’ga tegishli bezaklardan ajratib ko‘rsatilishi kerak.
Figma Sync’ni boshlaganimda, avval Wiki’dagi tegishli komponent kartasi va token hujjatini tekshirdim. Ish jarayonida yangidan tasdiqlangan ma’lumotlarni tegishli hujjatlarda aks ettirdim, javobsiz qolgan qismlarni esa hal qilinmagan bandlar (bo‘shliqlar) sifatida qoldirdim. Ish yakunlanganda Wiki’ni ham yangiladim.
Tooltip’ni tekshirish holati
Tooltip’ning birinchi versiyasi bir qarashda deyarli tayyor ko‘rinar edi. Biroq strelkaning yo‘nalishi va joylashuvi Figma’dagidan farq qilgan, Storybook izohlari uchun ishlatiladigan nuqtali ramka esa natijaviy ekranga ham qo‘shilib qolgan edi.
Agar tuzatishlarni faqat ekranga asoslanib kiritganimda, strelkaning o‘lchami va joylashuvini o‘zboshimchalik bilan tanlangan sonlar yordamida sozlagan bo‘lishim mumkin edi. Wiki’ga amal qilib, Figma’dagi yo‘nalish ta’rifini, mavjud VuiTooltip API’sini, Storybook bezaklarining qamrovini va mavjud tokenlarni ketma-ket tekshirdim.
1-rasm. Tuzatishdan oldingi Tooltip. Storybook bezagi va har bir yo‘nalishdagi strelka muammolari bitta ekranda aralashib ketgan.
2-rasm. Tuzatishdan keyingi Tooltip. Mavjud VuiTooltip yo‘nalishidan foydalanilgan, faqat Storybook’ga tegishli bezak esa ajratilgan.
Ko‘rib chiqilganda, yo‘nalishni mavjud VuiTooltip yo‘nalishidan foydalanib hal qilish mumkin edi. Storybook’ga xos dekoratsiya implementatsiyadan ajratildi. Boshqa tomondan, strelka shakli uchun tasdiqlangan token mavjud bo‘lmagani sababli, qoida o‘zboshimchalik bilan yaratilmay, bu masala hal qilinmagan band sifatida qoldirildi.
MenuItem holatlarini farqlash holati
MenuItem bilan bog‘liq muammo disabled va disabled + selected holatlarini bir xil deb qarashda edi. Dastlabki implementatsiyada selected fon rangi barcha disabled holatlariga qo‘llanib, tanlanmagan elementlarda ham kulrang fon qoldirilgan.
Wiki’da men VuiMenuItem kartasini, Figma’dagi holatga xos ekranlarni hamda VUI’ning matn va amal tokenlarini birgalikda ko‘rib chiqdim. Figma’da disabled elementlar shaffof fonga ega edi, selected fon esa faqat disabled + selected holatida saqlanardi. Shuning uchun disabled matn uchun text.disabled ni qo‘lladim, fonni esa shaffof holda qoldirdim; action.selected esa faqat selected holati ham mavjud bo‘lgandagina qo‘llandi.
3-rasm. Tuzatishdan oldingi MenuItem. Selected fon tanlanmagan disabled elementlarga ham qo‘llangan.
4-rasm. Tuzatishdan keyingi MenuItem. Disabled elementlar uchun fon shaffof holda qoldirildi, selected fon esa faqat disabled + selected holatiga qo‘llandi.
Kanban dizaynini yaratish holati
Oxirgi Sprint davomida qisqa vaqt ichida amalda foydalanish mumkin bo‘lgan Kanban shabloniga ehtiyoj tug‘ildi. Bu VUI LLM Wiki mavjud komponentlarni tuzatishdagina emas, balki yangi ekranlarni loyihalashda ham yordam bera oladimi yoki yo‘qmi, buni aniqlash uchun yaxshi imkoniyat bo‘ldi.
Avvalo, Wiki’dagi CRUD/List ekranlari va Dialog oqimlarini ko‘rib chiqdim. Mavjud VUI komponentlaridan foydalanib doska, yo‘laklar, kartalar hamda yaratish, tahrirlash va o‘chirish amallarini tuzdim; holat ranglari va karta yuzalari uchun semantik tokenlardan foydalandim. Bu mening birinchi Kanban loyiham bo‘lsa-da, boshqa VUI ekranlariga mos keladigan dizaynni tezda yaratishga muvaffaq bo‘ldim.
5-rasm. VUI LLM Wiki’dagi andozalar, komponentlar va token yo‘llariga amal qilgan holda yaratilgan Kanban backlog ekrani.
VUI LLM Wiki to‘liq tayyor bo‘lgach, topshiriqqa tayinlangan LLM o‘zgargan taqdirda ham bir xil dizayn standartlarini topish mumkin bo‘ladi. Har safar noldan taxmin qilish o‘rniga, avvaldan tartibga solingan qarorlardan boshlash orqali yangi komponentlar va ekranlarni ham VUI’ga o‘xshash yo‘nalishda kengaytirish mumkin.
Joseph