Jev Review’dan doimiy AI yordamida kod sifatini baholash uchun foydalaning

Jev Review nima?

Jev Review — AI kodlash agentlariga ishlash jarayonida dasturiy taʼminot sifati bo‘yicha tizimli signallarni taqdim etadigan mahalliy Model Context Protocol serveridir. U Claude Code, Codex, Cursor va OpenCode’ni qo‘llab-quvvatlaydi hamda jev_review nomli bitta maqsadli MCP vositasini taqdim etadi.

Ushbu vosita kodni to‘g‘rilik, murakkablik, o‘qish qulayligi, modullik, testlar sifati, ishonchlilik, xavfsizlik va qo‘llab-quvvatlanish kabi mustaqil mezonlar bo‘yicha baholaydi. U nasriy kod ko‘rib chiqish hisobotidan ko‘ra raqamli ballar, ishonchlilik qiymatlari, qo‘llanish ko‘rsatkichlari va oldindan belgilangan mezon yo‘riqnomalarini qaytaradi.

Jev sifat ko‘rsatkichini taqdim etadi, ammo asosiy kodlash agentingiz zaif tomonlarni aniqlash, kodni o‘zgartirish va natijani tekshirish uchun javobgar bo‘lib qoladi.

Jev Review MCP stdio orqali mahalliy Node.js jarayoni sifatida ishlaydi. Unda joylashtirilgan backend, maʼlumotlar bazasi, telemetriya xizmati yoki muallif boshqaradigan proksi mavjud emas. Aniq taqdim etilgan ko‘rib chiqish kontekstini o‘z ichiga olgan so‘rovlar to‘g‘ridan-to‘g‘ri sozlangan Jev API’ga yuboriladi.

Asosiy imkoniyatlar

• Uzluksiz baholash: Vazifa oxirigacha kutish o‘rniga, har bir mantiqan yakunlangan amalga oshirish bosqichidan keyin o‘zgarishni ko‘rib chiqing.
• Mustaqil sifat mezonlari: Har bir qo‘llaniladigan ko‘rsatkich 1 dan 10 gacha alohida ball va 0 dan 1 gacha ishonchlilik qiymatini oladi.
• Iteratsiyalarni taqqoslash: Yaxshilanishlar, regressiyalar va hal qilinmagan zaif tomonlarni aniqlash uchun oldingi baholashni taqdim eting.
• Maqsadli kontekst: Vazifa, diff, tanlangan fayllar, repozitoriy konteksti yoki ularning mos kombinatsiyasini yuboring.
• Mahalliy bajarish: Har bir qo‘llab-quvvatlanadigan mijoz stdio orqali bir xil jamlangan dist/server.js jarayonini ishga tushiradi.
• Repozitoriyga avtomatik kirish yo‘q: Server faqat vositaga aniq uzatilgan kontekstni qayta ishlaydi.
• Sunʼiy umumiy ball yo‘q: Jev Review ularni chalg‘itishi mumkin bo‘lgan foizga birlashtirish o‘rniga mezonlar darajasidagi natijalarni saqlaydi.

Talablar

Jev Review’ni o‘rnatishdan oldin quyidagilarga ega ekaningizga ishonch hosil qiling:

• Node.js 20 yoki undan yangiroq versiyasi.
• TypeSafe konsolidan olingan Jev API kaliti.
• Claude Code, Codex, Cursor yoki OpenCode.

Tezkor o‘rnatish

1. API kalitini eksport qiling

Kodlash mijozini ishga tushirishdan oldin kalitni muhitga o‘rnating:

export JEV_API_KEY="your-key"

Haqiqiy kalitni promptlar, manba fayllar, diff’lar yoki versiyaga kiritiladigan konfiguratsiyaga joylashtirmang.

2. Plaginni GitHub’dan o‘rnating

Jev Review npm nashri orqali emas, to‘g‘ridan-to‘g‘ri GitHub repozitoriysidan tarqatiladi:

npx plugins add NiazMorshed2007/jev-review

So‘ralganda kodlash mijozingizni tanlang, mijozni qayta ishga tushiring va MCP serveri ulanganini tekshiring.

3. Ko‘rib chiqishni so‘rang

Muhim o‘zgarishni amalga oshirib, testlardan o‘tkazganingizdan so‘ng, kodlash agentidan Jev Review’dan foydalanishni so‘rang. Masalan:

So‘ralgan autentifikatsiya o‘zgarishini amalga oshiring, tegishli testlarni ishga tushiring va yo‘naltirilgan diff uchun jev-review’dan foydalaning. Eng zaif muhim mezonlarni tekshiring, faqat asoslangan yaxshilanishlarni kiriting va yakuniy topshirishdan oldin qayta ball bering.

Mijozga xos sozlash

Claude Code

Claude Code maqsadini aniq ko‘rsatib o‘rnating:

npx plugins add NiazMorshed2007/jev-review --target claude-code

Claude Code’ni qayta ishga tushiring va /mcp buyrug‘ini bajarib, jev-review ulanganini tasdiqlang.

Faqat qo‘lda MCP sozlamasidan foydalanish uchun Claude Code’ni jamlangan serverga yo‘naltiring:

claude mcp add --scope user jev-review -- node /absolute/path/to/jev-review/dist/server.js

Mahalliy klondan ishlab chiqishda plagin katalogini to‘g‘ridan-to‘g‘ri yuklashingiz mumkin:

claude --plugin-dir /absolute/path/to/jev-review

Codex

Codex maqsadini o‘rnating va mijozni qayta ishga tushiring:

npx plugins add NiazMorshed2007/jev-review --target codex

Ulanishni tekshirish uchun /mcp buyrug‘ini bajaring. Qo‘lda sozlash uchun quyidagi server taʼrifini ~/.codex/config.toml fayliga qo‘shing:

[mcp_servers.jev-review]
command = "node"
args = ["/absolute/path/to/jev-review/dist/server.js"]
env_vars = ["JEV_API_KEY"]

Cursor

Cursor maqsadini o‘rnating:

npx plugins add NiazMorshed2007/jev-review --target cursor

Cursor’ni qayta ishga tushiring va Settings → MCP bo‘limini tekshiring. Jamlangan skill jev-review deb nomlanadi. Uni /jev-review orqali chaqirishingiz yoki Agent Decides holatida qoldirishingiz mumkin.

Qo‘lda sozlash uchun ~/.cursor/mcp.json faylini yarating yoki yangilang:

{
  "mcpServers": {
    "jev-review": {
      "type": "stdio",
      "command": "node",
      "args": ["/absolute/path/to/jev-review/dist/server.js"],
      "env": {
        "JEV_API_KEY": "${env:JEV_API_KEY}"
      }
    }
  }
}

macOS’da Dock orqali ishga tushirilgan Cursor shell profilingizdagi o‘zgaruvchilarni meros qilib olmasligi mumkin. Cursor’ni ishga tushirishdan oldin eksport qilingan kalitni grafik interfeys ilovalariga mavjud qiling:

launchctl setenv JEV_API_KEY "$JEV_API_KEY"

Qiymatini chiqarmasdan o‘zgaruvchi mavjudligini tekshiring:

test -n "$(launchctl getenv JEV_API_KEY)" && echo "JEV_API_KEY is configured"

OpenCode

OpenCode hozircha ko‘chma o‘rnatuvchi maqsadi sifatida ro‘yxatga olinmagan. Repozitoriyni klonlang va jamlangan serverni qo‘lda ro‘yxatdan o‘tkazing:

git clone https://github.com/NiazMorshed2007/jev-review.git
cd jev-review
opencode mcp add jev-review --global -- node "$PWD/dist/server.js"

Skill va MCP server uchun ham ~/.config/opencode/opencode.json fayliga quyidagiga o‘xshash konfiguratsiya qo‘shing, bunda mutlaq yo‘llarni almashtiring:

{
  "$schema": "https://opencode.ai/config.json",
  "skills": ["/absolute/path/to/jev-review/skills"],
  "mcp": {
    "servers": {
      "jev-review": {
        "type": "local",
        "command": ["node", "/absolute/path/to/jev-review/dist/server.js"],
        "environment": {
          "JEV_API_KEY": "{env:JEV_API_KEY}"
        }
      }
    }
  }
}

Ulanishni tekshirish uchun opencode mcp list buyrug‘ini bajaring. OpenCode vositani jev-review_jev_review sifatida ko‘rsatishi mumkin, ammo uning asosiy MCP nomi jev_review bo‘lib qoladi.

Vositaga kiritiladigan ma’lumotlarni tushunish

jev_review vositasi quyidagi tuzilmani qabul qiladi:

{
  task?: string;
  diff?: string;
  files?: Array<{
    path: string;
    content: string;
  }>;
  repositoryContext?: string;
  previousEvaluation?: Evaluation;
}

Joriy kontekstni beruvchi maydonlardan kamida bittasi talab qilinadi. Aksariyat hollarda task va yo‘naltirilgan diff yuboring. To‘liq fayllarni faqat o‘zgarishni tushunish uchun atrofdagi amalga oshirish tafsilotlari zarur bo‘lganda qo‘shing.

Konseptual so‘rov quyidagicha bo‘lishi mumkin:

{
  "task": "Add input validation to the account creation endpoint",
  "diff": "<focused version-control diff>",
  "repositoryContext": "Node.js service using the repository's existing validation conventions"
}

Bu misol kiritiladigan ma’lumotlar shaklini ko‘rsatadi; odatda kodlash mijozi MCP vositasini sizning nomingizdan ishga tushiradi.

Tavsiya etiladigan baholash jarayoni

1. Vazifani tushuning. Repozitoriy, talablar, qoidalar va tegishli testlarni ko‘rib chiqing.
2. Yaxlit qismni amalga oshiring. Har bir mayda o‘zgarishni ko‘rib chiqish o‘rniga, o‘zgarishning mazmunli qismini yakunlang.
3. Tegishli tekshiruvlarni bajaring. Keyingi ishlarni yo‘naltirish uchun baho so‘rashdan oldin xatti-harakatni tekshiring.
4. Boshlang‘ich holatni belgilang. Vazifa va yo‘naltirilgan diff bilan jev_review ni chaqiring.
5. Zaif o‘lchamlarni tekshiring. Kodlash agentidan amalga oshirishni ko‘rib chiqishni va har bir muhim zaiflik bo‘yicha aniq gipoteza tuzishni so‘rang.
6. Asoslangan eng kichik yaxshilashni qiling. Taxminiy qayta yozishlar yoki keraksiz arxitekturadan saqlaning.
7. Qayta tekshiring. Testlar, turlarni tekshirish, linterlar yoki loyihaga mos boshqa tekshiruvlarni qayta bajaring.
8. Tarix bilan qayta baholang. Har bir metrika bo‘yicha taqqoslashlarni olish uchun avvalgi natijani previousEvaluation sifatida uzating.
9. Kerakli vaqtda to‘xtang. Talablar va tekshiruvlar bajarilganda, qo‘shimcha ball izlash amaliy jihatdan katta qiymat qo‘shmaydigan bo‘lsa, ishni yakunlang.

Masalan, taqqoslashda o‘qish qulayligi 6.3 → 8.1 ga o‘zgargani, xavfsizlik esa 8.2 → 8.2 bo‘lib qolgani ko‘rsatilishi mumkin. Bu bitta umumiy balldan ko‘ra ma’lumotliroq, chunki aynan qaysi sifat o‘lchamlari o‘zgarganini ko‘rsatadi.

Sifat o‘lchamlari

Asosiy o‘lchamlar

Berilgan kontekst yetarli bo‘lganda, Jev Review quyidagilarni baholaydi:

• To‘g‘rilik va talablarga moslik.
• Kognitiv murakkablik.
• O‘qish qulayligi va maqsadning aniqligi.
• Modullilik va yaxlitlik.
• Bog‘liqlik va bog‘liqliklar sifati.
• O‘zgartirish qulayligi va o‘zgarishlarning ko‘payishi.
• Abstraksiya va API dizayni.
• Loyiha va fayl tuzilmasi.
• Takrorlanish va qayta foydalanish.
• Qo‘llab-quvvatlanish qulayligi.
• Test qilinuvchanlik va testlar sifati.
• Ishonchlilik va xatolarni qayta ishlash.
• Xavfsizlik.
• Izchillik va qoidalar.
• Hujjatlar va tushuntiriluvchanlik.

Kontekstga bog‘liq o‘lchamlar

Quyidagi o‘lchamlar faqat tegishli dalillar mavjud bo‘lganda baholanadi:

• Samaradorlik va resurslardan oqilona foydalanish.
• Miqyoslanish va moslashuvchanlik.
• Moslik va API barqarorligi.
• Kuzatuvchanlik va ekspluatatsiya qulayligi.

Berilgan kontekst biror o‘lchamni baholash uchun yetarli bo‘lmasa, natijada { "applicable": false } ishlatiladi. Baholovchi qisqaroq funksiyalar, kichikroq fayllar, qo‘shimcha qatlamlar, ko‘proq izohlar, umuman takrorlanmaslik yoki ko‘proq testlar avtomatik ravishda yaxshiroq deb hisoblamaydi.

Ilg‘or maslahatlar

Ko‘rib chiqish kontekstini ixcham saqlang

Vazifa va amalga oshirishni ifodalovchi eng kichik yaxlit diffni yuboring. To‘liq fayllarni faqat tushirib qoldirilgan kontekst ishonchli baholashga xalaqit berganda qo‘shing. Ixcham yuborilmalar kodlash agentiga fikr-mulohazalarni talqin qilishni osonlashtiradi.

Jev Review o‘zining belgilar, tokenlar yoki fayllar soni bo‘yicha cheklovini qo‘ymaydi. Biroq jev-latest APIʼsining amaldagi xatti-harakati yuboriladigan holat hajmi taxminan 32,768 token bilan cheklanishini ko‘rsatadi. Bu cheklov API hujjatlarida e’lon qilinmagan va o‘zgarishi mumkin. API max_tokens_exceeded qaytarsa, aloqasiz kontekstni olib tashlang yoki ishni yaxlit ko‘rib chiqish qismlariga ajrating.

Boshqariladigan takroriy ish uchun avvalgi baholashlardan foydalaning

Qayta baholashda to‘liq avvalgi natijani previousEvaluation ga uzating. Jev Review uni mahalliy tarzda taqqoslaydi va har bir metrika bo‘yicha farqlarni, yaxshilanishlarni, regressiyalarni hamda hal qilinmagan zaifliklarni bildiradi. Avvalgi baholash Jevʼga yuboriladigan joriy kod kontekstiga kiritilmaydi.

Tahrirlashdan oldin tashxis qo‘ying

Past ball sababning izohi emas, balki signaldir. Kodlash agentidan amalga oshirishni ko‘rib chiqishni, zaiflikni tasdiqlovchi dalillarni aniqlashni va minimal tuzatishni taklif qilishni so‘rang. Faqat raqamni o‘zgartirish uchun kodni qayta yozmang.

Ballardan ko‘ra talablarni ustun qo‘ying

To‘g‘ri xatti-harakat va foydalanuvchi talablari har doim ballni oshirishdan ustun turadi. Yuqoriroq ball xatti-harakatni buzish, qamrovni kengaytirish, ma’nosiz testlar qo‘shish, taxminiy abstraksiyalar kiritish yoki keraksiz qatlamlar yaratishni oqlamaydi.

Maxsus xavfsizlik vositalaridan ham foydalaning

Xavfsizlik baholash mezonlaridan biridir, ammo Jev Review bog‘liqlik skanerlari, maxfiy ma’lumotlarni aniqlash, statik tahlil, penetratsion testlar va boshqa maxsus xavfsizlik nazoratlarini to‘ldiradi, ularning o‘rnini bosmaydi.

Xavfsizlik va maxfiylik

Mahalliy MCP jarayoni JEV_API_KEY qiymatini o‘qiydi va undan faqat to‘g‘ridan-to‘g‘ri https://api.typesafe.ai/v1/systemone manziliga yuboriladigan TLS Authorization sarlavhasida foydalanadi. Jev Review kalitni saqlamaydi yoki jurnalga yozmaydi.

Faqat vositaga aniq taqdim etilgan task, diff, files va repositoryContext ma’lumotlari Jev’ga yuboriladi. Server repozitoriy fayllarini avtomatik ravishda aniqlamaydi yoki yuklamaydi.

Ko‘rib chiqish konteksti TypeSafe’ning Jev API’siga yuboriladi. Maxfiy ma’lumotlar yoki aloqasi bo‘lmagan xususiy materiallarni yubormang.

Masofaviy xizmat yuborilgan ma’lumotlar bilan qanday ishlashi haqida ma’lumot olish uchun TypeSafe maxfiylik siyosatini ko‘ring.

Jev Review’ni mahalliy ishlab chiqish

Loyihaning o‘zida ishlash uchun repozitoriyni klonlang, bog‘liqliklarni o‘rnating va tekshiruvni ishga tushiring:

git clone https://github.com/NiazMorshed2007/jev-review.git
cd jev-review
npm install
npm run validate

Foydali ishlab chiqish buyruqlari:

npm run check
npm test
npm run build
npx plugins discover .
claude plugin validate . --strict

npm run build versiyaga kiritilgan dist/server.js to‘plamini yaratadi. Birlik va MCP protokoli testlari mahalliy soxta obyektlardan foydalanadi va Jev API kvotasini sarflamaydi. Jonli Jev so‘rovi uchun JEV_API_KEY talab qilinadi.

Xulosa

Jev Review amalga oshirishni nazoratga olmasdan, qo‘llab-quvvatlanadigan AI kodlash mijozlariga tartibli sifat bo‘yicha fikr-mulohaza siklini qo‘shadi. Mahalliy MCP serverini o‘rnating, mazmunli o‘zgarishlardan so‘ng yo‘naltirilgan kontekst yuboring, ehtiyotkor yaxshilanishlarni yo‘naltirish uchun mezonlar bo‘yicha natijalardan foydalaning va baholashlarni iteratsiyalar davomida taqqoslang. Ballarni maqsad emas, dalil sifatida qabul qiling hamda talablar, tekshiruvlar va amaliy sifat ehtiyojlari qondirilganda to‘xtang.