Nima qiladi
Agentlar ishning katta qismini bajarayotgan paytda bizning asosiy vazifamiz o’zgaradi: endi biz nazorat qilamiz va tushunamiz. /mradkhh-explain aynan shu uchun. U “buni menga tushuntir” so’rovini bir martalik, tashlab yuborsa bo’ladigan artefaktga aylantiradi. Har bir da’vo kodning aniq joyiga (file:line) bog’lanadi.
Skill qisqa xulosa yozmaydi. U mexanizmni ko’rinadigan qiladi.
Format zinapoyasi
Skill mavzuni ko’tara oladigan eng past pog’onani tanlaydi:
| Pog’ona | Format | Qachon mos keladi |
|---|---|---|
ste | STE qoidalari bilan yozilgan matn | bitta g’oya, bitta qoida, bitta qaror |
diagram | Bitta diagramma + qisqa STE izoh | bir nechta ishtirokchi, holat yoki tarmoqlanuvchi oqim |
html | Bitta interaktiv sahifa | qadamma-qadam yurish yoki “agar X bo’lsa nima bo’ladi?” savollari |
video | 3Blue1Brown uslubidagi ovozli video | vaqt bo’yicha o’zgaradigan jarayon, boshqalarga ko’rsatish uchun |
Har bir pog’ona so’zlarda STE’dan foydalanadi: qisqa gaplar, bitta so’z — bitta ma’no, aniq harakatchi.
Qachon ishlatiladi
| Vaziyat | Buyruq |
|---|---|
| Agent katta o’zgarish qildi va siz nima bo’lganini tushunmoqchisiz | /mradkhh-explain (argumentsiz — oxirgi javob yoki o’zgarish) |
| To’lov oqimi qanday ishlashini bitta rasmda ko’rish | /mradkhh-explain diagram checkout oqimi |
| Yangi jamoa a’zosiga murakkab modulni o’rgatish | /mradkhh-explain html auth middleware |
| Jarayonni jamoaga taqdimot qilish | /mradkhh-explain video navbat qayta urinish logikasi |
Eslatma: bu skill faqat nomi bilan chaqiriladi (disable-model-invocation: true). Agent uni o’zi ishga tushirmaydi, shuning uchun u ortiqcha kontekst egallamaydi.
Talablar
ste,diagram,htmlpog’onalari uchun qo’shimcha hech narsa kerak emas.videopog’onasi uchun: Python 3.10–3.12,uv,ffmpeg,cairo,pango, ixtiyoriy ravishdaespeak-ng. Skill biror narsani o’rnatishdan oldin aniq buyruqlarni ko’rsatadi va ruxsat so’raydi.
Qanday ishlaydi
- Nishonni aniqlash. Skill argumentni o’qiydi: ixtiyoriy pog’ona va mavzu. Mavzu bo’lmasa, mavzu — agentning oldingi javobi yoki oxirgi o’zgarishi.
- Asoslash. Agent haqiqiy kodni boshidan oxirigacha kuzatadi. Har bir da’vo
file:line, buyruq natijasi yoki hujjatga bog’lanadi. Tekshirib bo’lmagan narsa taxmin deb belgilanadi. - Pog’onani tanlash. Siz pog’onani aytmagan bo’lsangiz, agent eng pastini tanlaydi va sababini bir qatorda aytadi.
- Yaratish. Artefakt
.temp/explain/<slug>/kabi git’ga kirmaydigan papkaga yoziladi. - Halqani yopish. Oxirida 2–3 ta o’zingizni tekshiring savoli beriladi (javoblari kodda), keyingi pog’ona taklif qilinadi.
Misol
/mradkhh-explain html buyurtma bekor qilinganda pul qaytarishNatija — bitta HTML sahifa:
- tepada bir gaplik TL;DR;
- butun oqimning xaritasi (tugmani bossangiz, o’sha qadamga o’tadi);
- qadamma-qadam stepper: har qadamda STE izoh, kod parchasi va
file:line; - “Agar balans yetmasa?” kabi tugmalar — qaysi yo’l ishga tushishini ko’rsatadi;
- oxirida 2–3 ta savol, javobi bosilganda ochiladi.
Ko’p beriladigan savollar
Nega oddiy chat javobi yetmaydi?
Chat javobi o’qiladi va unutiladi. Diagramma yoki interaktiv sahifa mexanizmni ko’rsatadi. Har bir da’voning file:line havolasi borligi uchun uni tekshirish ham oson.
Tushuntirish qaysi tilda bo’ladi? Siz yozgan tilda. STE qoidalari o’zbek tiliga ham qo’llanadi, texnik atamalar esa asl shaklida qoladi.
Video uchun pullik servis kerakmi?
Yo’q. Manim va lokal TTS (Kokoro yoki Piper) bepul ishlaydi. ELEVENLABS_API_KEY o’rnatilgan bo’lsa va siz so’rasangiz, ElevenLabs ham ishlatilishi mumkin.
Ishlayotganini qanday bilasiz
- Artefakt ochildi va siz uni ko’ra olasiz.
- Har bir muhim da’voda
file:linehavolasi bor. - Tekshirilmagan joylar “taxmin” deb belgilangan.
- Oxirida “o’zingizni tekshiring” savollari bor va siz ularga kodga qarab javob bera olasiz.
Qayerga mos keladi
agent kod yozdi → /mradkhh-explain → siz tushundingiz → review → /mradkhh-adr-generator (qaror bo'lsa)Agent tez ishlaganda tushunish orqada qolib ketadi. Bu skill shu bo’shliqni yopadi. Yangi mexanizmda muhim qaror bo’lsa, uni ADR sifatida qayd etish keyingi qadam bo’ladi.