Tumia Jev Review kwa Tathmini Endelevu ya Ubora wa Msimbo kwa Usaidizi wa AI

Jev Review Ni Nini?

Jev Review ni seva ya ndani ya Model Context Protocol inayowapa mawakala wa AI wa uandishi wa msimbo viashiria vilivyopangwa vya ubora wa programu wanapofanya kazi. Inatumia Claude Code, Codex, Cursor, na OpenCode, na hutoa zana moja maalum ya MCP inayoitwa jev_review.

Zana hii hutathmini msimbo kwa vipengele huru kama usahihi, uchangamano, usomaji, mgawanyo wa moduli, ubora wa majaribio, utegemezi, usalama, na udumishaji. Hutoa alama za nambari, viwango vya uaminifu, viashiria vya utumiaji, na vidokezo vilivyobainishwa vya vigezo badala ya insha ya mapitio ya msimbo iliyoandikwa kwa maelezo marefu.

Jev hutoa kiashiria cha ubora, lakini wakala wako mkuu wa uandishi wa msimbo ndiye anayewajibika kutambua udhaifu, kubadilisha msimbo, na kuthibitisha matokeo.

Jev Review huendeshwa kama mchakato wa ndani wa Node.js kupitia MCP stdio. Haina mfumo wa nyuma unaopangishwa, hifadhidata, huduma ya telemetry, wala proksi inayoendeshwa na mwandishi. Maombi yaliyo na muktadha wa mapitio uliotolewa wazi hutumwa moja kwa moja kwenye API ya Jev iliyosanidiwa.

Vipengele Muhimu

• Tathmini endelevu: Kagua mabadiliko baada ya kila sehemu thabiti ya utekelezaji badala ya kusubiri hadi mwisho wa kazi.
• Vipengele huru vya ubora: Kila kipimo kinachotumika hupokea alama yake kutoka 1 hadi 10 na thamani ya uaminifu kutoka 0 hadi 1.
• Ulinganisho wa marudio: Wasilisha tathmini ya awali ili kutambua maboresho, kurudi nyuma, na udhaifu ambao bado haujashughulikiwa.
• Muktadha unaolenga: Wasilisha kazi, diff, faili zilizochaguliwa, muktadha wa hifadhi, au mchanganyiko unaofaa wa vitu hivyo.
• Uendeshaji wa ndani: Kila mteja anayetumika huanzisha mchakato uleule uliowekwa pamoja wa dist/server.js kupitia stdio.
• Hakuna ufikiaji wa hifadhi kiotomatiki: Seva huchakata tu muktadha unaopitishwa wazi kwa zana.
• Hakuna alama ya jumla ya kubuniwa: Jev Review huhifadhi matokeo ya kila kipengele badala ya kuyachanganya kuwa asilimia inayoweza kupotosha.

Mahitaji ya Awali

Kabla ya kusakinisha Jev Review, hakikisha una:

• Node.js 20 au mpya zaidi.
• Ufunguo wa API wa Jev kutoka kwenye konsoli ya TypeSafe.
• Claude Code, Codex, Cursor, au OpenCode.

Usakinishaji wa Haraka

1. Hamisha ufunguo wa API

Weka ufunguo kwenye mazingira kabla ya kuanzisha mteja wako wa uandishi wa msimbo:

export JEV_API_KEY="your-key"

Usiweke ufunguo halisi kwenye vidokezo, faili za chanzo, diffs, au usanidi unaowasilishwa kwenye hifadhi.

2. Sakinisha programu-jalizi kutoka GitHub

Jev Review husambazwa moja kwa moja kutoka kwenye hifadhi yake ya GitHub badala ya kuchapishwa kupitia npm:

npx plugins add NiazMorshed2007/jev-review

Chagua mteja wako wa uandishi wa msimbo unapoombwa, anzisha upya mteja, na uthibitishe kuwa seva ya MCP imeunganishwa.

3. Omba mapitio

Baada ya kutekeleza na kujaribu mabadiliko makubwa, mwombe wakala wa uandishi wa msimbo atumie Jev Review. Kwa mfano:

Implement the requested authentication change, run the relevant tests, and use jev-review on the focused diff. Inspect the weakest important dimensions, make only justified improvements, and rescore before the final handoff.

Usanidi Maalum wa Mteja

Claude Code

Sakinisha lengo la Claude Code waziwazi:

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

Anzisha upya Claude Code na utekeleze /mcp ili kuthibitisha kuwa jev-review imeunganishwa.

Kwa usanidi wa MCP pekee wa mwongozo, elekeza Claude Code kwenye seva iliyowekwa pamoja:

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

Unapotengeneza kutoka kwenye nakala ya ndani, unaweza kupakia saraka ya programu-jalizi moja kwa moja:

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

Codex

Sakinisha lengo la Codex na anzisha upya mteja:

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

Tekeleza /mcp ili kuthibitisha muunganisho. Kwa usanidi wa mwongozo, ongeza ufafanuzi ufuatao wa seva kwenye ~/.codex/config.toml:

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

Cursor

Sakinisha lengo la Cursor:

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

Anzisha upya Cursor na uangalie Settings → MCP. Ustadi uliowekwa pamoja unaitwa jev-review. Unaweza kuuanzisha kwa /jev-review au kuuacha kwenye Agent Decides.

Kwa usanidi wa mwongozo, tengeneza au sasisha ~/.cursor/mcp.json:

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

Kwenye macOS, Cursor iliyoanzishwa kutoka Dock huenda isirithi vigezo kutoka kwenye profaili ya ganda lako. Fanya ufunguo uliotangazwa upatikane kwa programu za GUI kabla ya kuanzisha Cursor:

launchctl setenv JEV_API_KEY "$JEV_API_KEY"

Thibitisha kuwa kigezo kipo bila kuchapisha thamani yake:

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

OpenCode

Kwa sasa OpenCode haijaorodheshwa kama lengo la kisakinishaji linalobebeka. Nakili hifadhi na usajili seva iliyowekwa pamoja kwa mikono:

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

Kwa skill na seva ya MCP, ongeza usanidi kama huu kwenye ~/.config/opencode/opencode.json, ukibadilisha njia kamili:

{
  "$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}"
        }
      }
    }
  }
}

Endesha opencode mcp list ili kuthibitisha muunganisho. OpenCode inaweza kuonyesha zana hiyo kama jev-review_jev_review, ingawa jina lake la msingi la MCP linabaki jev_review.

Kuelewa Ingizo la Zana

Zana ya jev_review inakubali muundo ufuatao:

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

Angalau sehemu moja ya muktadha wa sasa inahitajika. Mara nyingi, tuma kazi na diff iliyolenga. Ongeza faili kamili tu wakati maelezo ya utekelezaji yanayozunguka yanahitajika ili kuelewa mabadiliko.

Ombi la kimawazo linaweza kuwa na:

{
  "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"
}

Mfano huu unaonyesha muundo wa ingizo; mteja wa kuandika msimbo kwa kawaida huita zana ya MCP kwa niaba yako.

Mtiririko Unaopendekezwa wa Tathmini

1. Elewa kazi. Kagua hifadhi ya msimbo, mahitaji, kanuni, na majaribio yanayohusika.
2. Tekeleza sehemu yenye mshikamano. Kamilisha sehemu yenye maana ya mabadiliko badala ya kukagua kila hariri ndogo.
3. Endesha ukaguzi unaohusika. Thibitisha tabia kabla ya kuomba alama ili kuongoza kazi zaidi.
4. Weka msingi wa kulinganisha. Ita jev_review kwa kutumia kazi na diff iliyolenga.
5. Chunguza vipengele dhaifu. Mwambie wakala wa kuandika msimbo akague utekelezaji na atengeneze dhana thabiti kuhusu kila udhaifu muhimu.
6. Fanya uboreshaji mdogo unaohalalika. Epuka uandishi upya wa kubahatisha au usanifu usio wa lazima.
7. Thibitisha tena. Endesha tena majaribio, ukaguzi wa aina, linters, au ukaguzi mwingine unaofaa wa mradi.
8. Tathmini tena ukitumia historia. Pitisha matokeo ya awali kama previousEvaluation ili kupata ulinganisho wa kila kipimo.
9. Acha kwa wakati unaofaa. Kamilisha mahitaji na ukaguzi unapopita, na kutafuta alama zaidi hakutaongeza thamani kubwa ya vitendo.

Kwa mfano, ulinganisho unaweza kuonyesha mabadiliko ya usomaji kama 6.3 → 8.1, huku usalama ukibaki 8.2 → 8.2. Hii ina taarifa zaidi kuliko alama moja iliyochanganywa kwa sababu inaonyesha ni vipengele vipi hasa vya ubora vilivyobadilika.

Vipengele vya Ubora

Vipengele vya msingi

Muktadha uliotolewa unapotosha, Jev Review hutathmini:

• Usahihi na kuafikiana na mahitaji.
• Utata wa kiakili.
• Usomaji na dhamira.
• Modularity na mshikamano.
• Uunganishaji na ubora wa utegemezi.
• Urahisi wa kubadilisha na kuongezeka kwa mabadiliko.
• Utoaji wa abstractions na usanifu wa API.
• Muundo wa mradi na faili.
• Urudiaji na utumiaji tena.
• Urahisi wa kutunza.
• Urahisi wa kufanya majaribio na ubora wa majaribio.
• Uaminifu na ushughulikiaji wa makosa.
• Usalama.
• Ulinganifu na kanuni.
• Nyaraka na uelezekaji.

Vipengele vinavyotegemea muktadha

Vipengele vifuatavyo hutathminiwa tu pale ushahidi unaohusika unapopatikana:

• Utendaji na ufanisi wa rasilimali.
• Uwezo wa kupanuka na kunyumbulika.
• Upatanifu na uthabiti wa API.
• Uwezo wa kuonekana na uendeshaji.

Ikiwa muktadha uliotolewa hauwezi kusaidia kipengele fulani, matokeo hutumia { "applicable": false }. Mtathmini hafikiri kwamba functions fupi, faili ndogo, tabaka za ziada, maoni mengi zaidi, kutokuwepo kabisa kwa urudiaji, au majaribio mengi zaidi ni bora moja kwa moja.

Vidokezo vya Juu

Weka muktadha wa ukaguzi ukiwa umelenga

Tuma kazi na diff ndogo zaidi yenye mshikamano inayowakilisha utekelezaji. Jumuisha faili kamili tu wakati kuacha muktadha kungezuia tathmini ya kuaminika. Mawasilisho yaliyolenga hurahisisha wakala wa kuandika msimbo kutafsiri mrejesho.

Jev Review haiweki kikomo chake cha wahusika, tokeni, au idadi ya faili. Hata hivyo, tabia ya moja kwa moja ya API ya jev-latest inaonyesha kikomo cha hali iliyowasilishwa cha takribani tokeni 32,768. Kikomo hiki hakijachapishwa kwenye nyaraka za API na kinaweza kubadilika. Ikiwa API itarudisha max_tokens_exceeded, ondoa muktadha usiohusika au gawanya kazi katika sehemu za ukaguzi zenye mshikamano.

Tumia tathmini za awali kwa marudio yanayodhibitiwa

Wakati wa kutathmini tena, pitisha matokeo yote ya awali katika previousEvaluation. Jev Review huyalinganisha ndani ya mfumo na kuripoti tofauti za kila kipimo, maboresho, kurudi nyuma, na udhaifu ambao haujatatuliwa. Tathmini ya awali haijumuishwi kwenye muktadha wa sasa wa msimbo unaotumwa kwa Jev.

Tambua chanzo kabla ya kuhariri

Alama ya chini ni ishara, si maelezo ya chanzo kikuu. Mwambie wakala wa kuandika msimbo akague utekelezaji, atambue ushahidi wa udhaifu huo, na apendekeze marekebisho madogo. Usiandike upya msimbo kwa ajili ya kubadilisha nambari pekee.

Pa kipaumbele mahitaji kuliko alama

Tabia sahihi na mahitaji ya mtumiaji huwa na kipaumbele kuliko kuboresha alama. Alama ya juu haikubalalishi kuvunja tabia, kupanua upeo, kuongeza majaribio yasiyo na maana, kuanzisha abstractions za kubahatisha, au kuunda tabaka zisizo za lazima.

Tumia pia zana maalum za usalama

Usalama ni mojawapo ya vipengele vya tathmini, lakini Jev Review inakamilisha badala ya kuchukua nafasi ya vichanganuzi vya utegemezi, utambuzi wa siri, uchanganuzi tuli, majaribio ya kupenya, na vidhibiti vingine maalum vya usalama.

Usalama na Faragha

Mchakato wa ndani wa MCP husoma JEV_API_KEY na kuitumia tu kwenye kichwa cha Authorization cha TLS kinachotumwa moja kwa moja kwa https://api.typesafe.ai/v1/systemone. Jev Review haihifadhi wala kurekodi ufunguo huo.

Ni task, diff, files, na repositoryContext pekee zinazotolewa wazi kwa zana ndizo hutumwa kwa Jev. Seva haigundui wala kupakia faili za hazina kiotomatiki.

Muktadha wa ukaguzi huondoka kwenye kompyuta yako na kutumwa kwenye API ya Jev ya TypeSafe. Usitume siri au nyenzo za umiliki zisizohusiana.

Angalia sera ya faragha ya TypeSafe kwa maelezo kuhusu jinsi huduma ya mbali inavyoshughulikia data iliyowasilishwa.

Kuendeleza Jev Review Kwenye Mazingira ya Ndani

Ili kufanyia kazi mradi wenyewe, nakili hazina, sakinisha vitegemezi, kisha endesha uthibitishaji:

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

Amri muhimu za usanidi ni pamoja na:

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

npm run build huunda kifurushi cha dist/server.js kinachowasilishwa pamoja na mradi. Majaribio ya vitengo na itifaki ya MCP hutumia mifumo bandia ya ndani na hayatumii mgao wa API ya Jev. Ombi la moja kwa moja la Jev linahitaji JEV_API_KEY.

Hitimisho

Jev Review huongeza mzunguko wenye utaratibu wa maoni kuhusu ubora kwa wateja wa usimbaji wa AI wanaoungwa mkono, bila kuchukua udhibiti wa utekelezaji. Sakinisha seva ya ndani ya MCP, wasilisha muktadha maalum baada ya mabadiliko yenye maana, tumia matokeo ya kila kipengele kuongoza maboresho makini, na linganisha tathmini katika marudio mbalimbali. Chukulia alama kama ushahidi badala ya malengo, na simama pale mahitaji, ukaguzi, na mahitaji halisi ya ubora yanapotimizwa.