Zisingathe Ngokwakho i-Skillbox: Yakha Umtapo Wamakhono Oguqulo Olugcinwayo Wama-Agent e-AI

Yini i-Skillbox?

I-Skillbox iwumtapo wolwazi wamakhono onephepha-mvume le-MIT, ozisingathayo, wama-ejenti e-AI. Ikunikeza indawo emaphakathi yokwakha, ukungenisa, ukwenza izinguqulo, ukusabalalisa, nokuhlola amaphakheji amakhono angasetshenziswa kabusha. Uhlelo lwakhiwe nge-React, Bun, Hono, ne-PostgreSQL.

Ukufakwa okusha kushiywa kungenalutho ngenhloso. Akuqukethe amakhono omuntu siqu, ama-akhawunti abasebenzisi, okhiye bamaklayenti, iziphetho zezinsizakalo zangaphandle, noma imininingwane yokungena yabahlinzeki be-AI abakhokhelwayo. I-Skillbox isabalalisa okuqukethwe kwamakhono kodwa ayikaze isebenzise ikhodi yamakhono elayishiwe.

Izici ezibalulekile

• Ukuhlela okunezinguqulo: Hlela i-Markdown namafayela asekelayo ngezibuyekezo ezingaguquki, ukutholwa kokushayisana, nokubuyiselwa.
• Ukufinyelela okunemikhawulo: Dala amaphrofayela anemvume yamakhono noma yamabhundli, bese uhlukanisa izimvume zokudala, zokubuyekeza, zokufaka kungobo yomlando, neziphakamiso.
• Amaklayenti angahoxiswa: Khipha okhiye bamaklayenti ngabanye, buyekeza ukusetshenziswa, futhi uhoxise ukufinyelela kwesikhathi esizayo lapho kudingeka.
• Ukufinyelela nge-MCP ne-CLI: Sebenzisa i-HTTP MCP ngokuqondile, xhuma ngebhuloho le-Node noma le-Bun le-stdio, noma landa amaphakheji ngokuqinisekiswa kwe-checksum.
• Izinsiza ze-MCP: Veza amakhono agunyaziwe nahambisanayo ngokuwafaka ohlwini nokuwafunda usebenzisa izinsiza eziyisisekelo ze-MCP.
• Izincomo ozikhethelayo: Sebenzisa i-Jev nge-Vercel AI Gateway yakho noma ukhiye we-TypeSafe AI.
• Ukuphatheka kwedatha: Ngenisa futhi uthumele amafolda omdabu, dala izipele ezivikelwe, futhi ubuyisele idatha ngokusobala.
• Ukusatshalaliswa ozisingathayo: Sebenzisa i-Docker Compose, ngokuzikhethela ubeke i-Caddy ngaphambili ukuze uthole i-HTTPS, noma ulungiselele iphakheji ye-Umbrel.

I-Skillbox yakhelwe njengohlelo olusingathwa ngumnikazi oyedwa, olunamaklayenti anemikhawulo. Ayilona ipulatifomu yomphakathi ye-SaaS enabaqashi abaningi.

Izidingo zangaphambili

Ukufakwa okunconyiwe kudinga i-Docker Engine noma i-Docker Desktop ene-Compose v2, kanye ne-Bash ku-Linux, macOS, noma ku-WSL. Awudingi ukufaka i-Bun noma i-Node.js kukhompuyutha yokusingatha ukuze usebenzise ukusetha okusekelwe ku-Docker.

Faka bese uqala i-Skillbox

1. Clone-a indawo yokugcina bese ufaka kuhla lwayo:

   git clone https://github.com/kitze/skillbox.git
   cd skillbox

2. Yenza ifayela lendawo lemvelo:

   bash scripts/skillbox.sh setup

   Lokhu kudala i-.env enemininingwane yokungena engahleliwe nehlukile, kusetha imodi yayo ibe yi-0600, futhi kwenqaba ukubhala phezu kwefayela eselikhona.

3. Qala izinsizakalo ze-Docker:

   bash scripts/skillbox.sh start

4. Vula i-http://127.0.0.1:4791 esipheqululini sakho.

5. Funda i-SKILLBOX_ADMIN_TOKEN efayeleni lakho lendawo le-.env bese uyisebenzisa ukungena. Iskripthi sokusetha asiyiphrinti ngamabomu le tokheni.

Gcina i-.env iyimfihlo. I-tokheni yomnikazi ilawula ukufinyelela kokuphatha futhi iyabandakanyeka nasekuvikeleni imininingwane egciniwe yokuhlanganisa izinsizakalo.

Ukusatshalaliswa okukude

Ekufakweni okukude, setha i-SKILLBOX_ORIGIN ibe yindawo ye-HTTPS yokusatshalaliswa bese ulungiselela ummeleli obuyisela emuva we-TLS. Ungavezi isenzakalo sokukhiqiza nge-HTTP engabethelwe. Bheka amanothi okusatshalaliswa endaweni yokugcina ukuze uthole imininingwane esekelwayo yokusatshalaliswa.

Ukuthuthukisa kwasendaweni ngaphandle kokusethwa kohlelo olusekelwe kuphela ku-Docker

Uma usunayo i-Bun kanye nesizindalwazi se-PostgreSQL 16 noma esisha, faka okuncikile bese uqala uhlelo ngokuqondile:

bun install --frozen-lockfile
# Setha i-DATABASE_URL
# Setha i-SKILLBOX_ADMIN_TOKEN okungenani ngezinhlamvu ezingahleliwe ezingu-32
# Setha i-SKILLBOX_ORIGIN=http://127.0.0.1:4791
bun run build
bun run start

Gcina wonke amanani amathathu adingekayo endaweni evikelekile kunokuba uwafake ekulawuleni ikhodi yomthombo.

Dala amakhono namaklayenti anemikhawulo

Ngemva kokungena, dala ikhono kumhleli noma ungenise iphakheji yekhono ekhona. Izibuyekezo zamakhono aziguquki, ngakho amaklayenti angalayisha noma alande isibuyekezo esithile esikhundleni sokuncika kokuqukethwe okushintshayo.

Okulandelayo, dala iphrofayela bese uyinikeza ukufinyelela kumakhono noma kumabhundli adingekayo. Nikeza izimvume zokudala, zokubuyekeza, zokufaka kungobo yomlando, neziphakamiso ngokuzimela, kuye ngenhloso yeklayenti. Ekugcineni, dala uxhumano lweklayenti usebenzisa leyo phrofayela.

Okhiye bamaklayenti baboniswa kanye kuphela, futhi i-Skillbox igcina ama-hashi abo kuphela. Londoloza ukhiye ngamunye ngokushesha ekucushweni kweklayenti okuvikelwe. Sebenzisa ukhiye ohlukile kwiklayenti ngalinye esikhundleni sokusabalalisa i-tokheni yomnikazi.

Lungiselela i-CLI

I-CLI ifunda ukucushwa kwe-JSON okuqukethe i-URL ye-Skillbox nokhiye weklayenti. Indlela yayo ezenzakalelayo ithi ~/.config/skillbox/config.json.

{
  "url": "https://skills.example.com",
  "token": "YOUR_CLIENT_KEY"
}

Setha imodi yefayela ibe yi-0600. Okuguquguqukayo kwemvelo okuthi SKILLBOX_URL kanye ne-SKILLBOX_TOKEN kudlula amanani asuka kufayela lokucushwa. Uma ingekho i-URL emisiwe, i-CLI iqondisa ngokuphepha ku-localhost esikhundleni sesevisi yomunye umuntu.

Gcina i-cli/skillbox.mjs ne-cli/package.mjs ndawonye. Ngemva kwalokho ungahlola futhi uthole amakhono agunyaziwe:

node cli/skillbox.mjs list
node cli/skillbox.mjs search "database migration"
node cli/skillbox.mjs load my-skill
node cli/skillbox.mjs manifest my-skill
node cli/skillbox.mjs fetch my-skill@REVISION

Umsebenzi wokulanda uqinisekisa izindlela, ama-hashi amafayela, osayizi, amafulegi okusebenziseka, kanye ne-checksum yephakheji ngaphambi kokubhala amafayela ngokusebenza kwe-athomu. Awusebenzisi ikhodi futhi awufaki okuncikile.

Shicilela ikhono elibuyekeziwe

Shicilela ifolda yasendaweni ngokunikeza i-ID yekhono nesibuyekezo olindele ukusibuyekeza:

node cli/skillbox.mjs publish ./my-skill my-skill EXPECTED_REVISION

Uguqulo olulindelekile lusekela ukutholwa kokungqubuzana. Ukushicilela futhi kuncike ezimvumeni ezinikezwe iphrofayela yeklayenti.

Ukuhambisana nokuhlolwa komlando

Umnikazi angasebenzisa ukuhlolwa kokuhambisana okungaguquli lutho:

node cli/skillbox.mjs audit

Umyalo uphuma ngesimo 1 uma uthola amaphakheji angahambisani. Ukulungiselela ukuhlola ukuhambisana kwe-MCP Skills ngaphandle kokubhala kabusha amaphakheji akhona.

Xhuma i-ejenti ye-AI nge-MCP

Faka i-bootstrap/SKILL.md njenge-bootstrap ye-skills-library ye-ejenti. Amaklayenti asekela i-HTTP MCP angaxhuma ku-endpoint ye-/mcp yesenzakalo sakho futhi athumele ukhiye weklayenti njengethokheni ye-bearer:

Authorization: Bearer YOUR_CLIENT_KEY

Kuklayenti le-MCP elidinga i-stdio, lungiselela ibhuloho elifakiwe:

{
  "mcpServers": {
    "skillbox": {
      "command": "node",
      "args": [
        "/absolute/path/to/skillbox/cli/skillbox.mjs",
        "mcp"
      ],
      "env": {
        "SKILLBOX_URL": "https://skills.example.com",
        "SKILLBOX_CONFIG": "/absolute/path/to/protected-client-config.json"
      }
    }
  }
}

Amathuluzi ayisisekelo e-MCP afaka i-search_skills, i-recommend_skills, i-load_skill, i-read_skill_file, kanye ne-report_skill_use. Amathuluzi okubhala nawokuphakamisa avezwa kuphela uma iphrofayela yeklayenti inikeza izimvume ezihambisanayo.

I-Skillbox iphinde iveze amakhono ahambisanayo agunyaziwe nge-resources/list ne-resources/read ze-MCP eyisisekelo. Amafayela asekelayo anambambili namakhulu angafinyelelwa njengezinsiza, kodwa ukufunda insiza akwenzi kusebenze noma kusebenzise ikhono.

Ukusekelwa okuphelele kwe-io.modelcontextprotocol/skills akukakhangiswa. Ukuqaliswa kwamanje kunikeza izici zokulungela ngephrothokholi eyisisekelo ye-MCP, kuyilapho ukutholwa nokuxoxisana kwendabuko kusancike ku-SDK nasekuthuthukisweni kwephrothokholi.

Sebenzisa ukusesha nezincomo ngendlela efanele

Ekuqaleni komsebenzi, ama-ejenti kusafanele ashayele i-search_skills ukuze abale amakhono agunyaziwe afanele. Izincomo ziyangeza futhi azithathi indawo yalesi sinyathelo sokusesha. Ngaphambi kokusebenzisa ikhono elikhethiwe, lilayishe usebenzisa uguqulo olungaguquki olubuyiswe yi-Skillbox.

Ngaphandle komhlinzeki wangaphandle wezincomo, ungasesha ku-CLI:

node cli/skillbox.mjs search "database migration"

Ukucela izincomo ezihambisana nomsebenzi:

node cli/skillbox.mjs recommend "Fix choppy scrolling in an Expo app"

Umsebenzi ofanayo we-MCP uthi recommend_skills({task, limit?, offset?}). Amaklayenti e-HTTP angathumela umzimba ofanayo ogunyaziwe we-JSON ku-POST /api/skill-recommendations.

Lungiselela izincomo ozikhethela zona ze-Jev

1. Vula Settings → Jev recommendations.

2. Khetha Vercel AI Gateway, okuyiyona ezenzakalelayo, noma TypeSafe AI.

3. Faka bese ugcina ukhiye wakho we-API womhlinzeki okhethiwe.

Okhiye babahlinzeki bagcinwa ngokwehlukana. Ukukhetha i-TypeSafe akuthumeli ukhiye ogciniwe we-Gateway ku-TypeSafe, futhi ukushintsha abahlinzeki kugcina ukhiye owawugcinwe ngaphambilini. Ukususa ukhiye womhlinzeki okhethiwe kukhubaza izingcingo zemodeli zalowo mhlinzeki.

Ukhiye ubethelwa ku-PostgreSQL nge-AES-256-GCM kusetshenziswa impahla yokhiye etholakala ku-SKILLBOX_ADMIN_TOKEN. Awubuyiselwa yi-API yezilungiselelo futhi awufakwa kumabundle esiphequluli. Ukushintsha ithokheni yomnikazi ngaphandle kokulandela inqubo yokushintsha ebhaliwe kwenza iziqinisekiso zokuhlanganisa ezigciniwe zingafundeki.

Ukugcina ukhiye akuqinisekisi ukufinyelela komhlinzeki noma ukuthengwa kwamakhredithi. I-Jev ithumela umbhalo womsebenzi nezincazelo zamakhono asebenzayo agunyaziwe kumhlinzeki okhethiwe, ngakho imigomo yokukhokhisa neyokuphatha idatha yalowo mhlinzeki iyasebenza.

Qonda imiphumela yezincomo nezinye izindlela zokubuyela emuva

I-Jev ihlola ikhathalogi ephelele yamakhono agunyaziwe, anikwe amandla, angagciniwe, angamaqabunga, kuze kufike kumaqabunga angu-200 noma izinhlamvu ezingu-120,000 ezihlelwe zaba uchungechunge. Amakhathalogi amakhulu abuyela ngokusobala kwenye indlela esikhundleni sokukala ingxenye engadalulwanga.

• Ukuhambisana kuyisikolo esingalinganisiwe esisuka ku-0 siye ku-4, hhayi amathuba.
• Imiphumela enesikolo okungenani esingu-3 ibuyiselwa ngokulandelana kwesikolo esehla bese kuba nge-ID.
• noMatch=true kusho ukuthi akukho kandidatshi ohloliwe ofinyelele embundwini.
• Ukungabi khona kokhiye, iphutha lomhlinzeki, impendulo engalungile, umkhawulo wezicelo, umkhawulo womthamo, noma umnqamulajuqu wemizuzwana eyisishiyagalombili kuqalisa ukubuyela ekusesheni kwe-PostgreSQL.
• Imiphumela yokubuyela emuva isebenzisa method=search, relevance=null, kanye ne-fallbackReason.

I-cache esezingeni lenqubo igcina okungenani okufakiwe okungu-128 imizuzu emihlanu. I-Skillbox ivumela ukuhlolwa okubili okuhambisanayo nezicelo eziyishumi ezingagciniwe ngomkhawulo ngamunye ngomzuzu, ngaphandle kokuzama kabusha okuzenzakalelayo. Izimvume, isimo somjikelezo wokuphila, nezinguqulo kuhlolwa ngaphambi nangemva kwezingcingo zemodeli, kuhlanganise nokushaywa kwe-cache.

Ngenisa, khipha, futhi wenze ikhophi yasenqolobaneni yedatha

Uma i-Bun ikhona, ngenisa ifolda yamakhono usebenzisa:

bun scripts/import.ts /path/to/skills

Ukungenisa kugcina amabhayithi wamafayela ne-frontmatter engaziwa, kweqa ama-symlink nezinto ezenziwa ngesikhathi sokusebenza, futhi kufaka amaphethini ezimfihlo abonakalayo endaweni yokuvalelwa. Lokhu kutholwa kusekelwe ku-heuristic, ngakho akuthathi indawo yokuhlolwa okuphelele kwezimfihlo. Ungalokothi ufake amaphasiwedi noma amathokheni kumaphakheji wamakhono.

Khipha okuqukethwe kwamakhono uye endaweni okuyiwa kuyo engenalutho:

SKILLBOX_EXPORT_DIR=/path/to/empty-export bun scripts/export.ts

Isizindalwazi se-PostgreSQL sihlala siwumthombo weqiniso. Ukuhlela ifolda ekhishiwe akushintshi isizindalwazi kuze kube okuqukethwe kushicilelwa futhi.

Dala ikhophi yasenqolobaneni evikelekile usebenzisa:

bash scripts/backup.sh

Ukuthunyelwa kwamanye amazwe namakhophi ayisipele kungase kube nokuqukethwe kwamakhono okuyimfihlo. Kugcine kuhlukene nekhodi yomphakathi yohlelo lokusebenza. Iskripthi sokuthunyelwa ku-GitHub esikhethwayo sidinga i-checkout yangasese ezinikele, ehlelwe ngokusobala futhi eyenzelwe ukuthunyelwa, futhi asinikiwe amandla ngokuzenzakalelayo.

Amathiphu okusebenza athuthukile

Sebenzisa ukhiye weklayenti owodwa ekuhlanganiseni ngakunye

Okhiye abahlukene benza ukuhoxiswa nokubikwa kokusetshenziswa kube wusizo kakhulu. Ukuhoxisa ukhiye kuvimbela izicelo zesikhathi esizayo, kodwa akukwazi ukubuyisa amafayela iklayenti eselivele liwalande.

Khetha amaphrofayela anobubanzi obuncane

Nika i-ejenti ngayinye kuphela amakhono nezenzo ezidingayo. Ama-bundle anweba abe ngamakhono amaqabunga amanje angaphindiwe, kanti izinkomba zodwa azinikezi ukufinyelela.

Vikela ithokheni yomnikazi namakhophi ayisipele

Ithokheni yomnikazi inikeza ukufinyelela kokuphatha futhi ikhiqiza izinto zokubethela zemininingwane egciniwe yokungena yezihlanganiso. Yivikele kanye nesizindalwazi namakhophi ayisipele okucushwa, futhi ulandele inqubo yokushintsha ebhaliwe ngaphambi kokuyifaka esikhundleni.

Phatha amakhono njengokuqukethwe, hhayi izinhlelo ezethenjiwe

ISkillbox iqinisekisa futhi isabalalisa amafayela ephakheji ngaphandle kokuwasebenzisa. Qhubeka ubuyekeza imiyalelo nekhodi elandiwe ngaphambi kokukusebenzisa ekuhambeni komsebenzi we-ejenti.

Hlola izincomo ngokucophelela

Onjiniyela bangasebenzisa ibhentshimakhi ekhokhiswayo ngokuzikhethela besebenzisa ukhiye womhlinzeki wabo:

bun scripts/benchmark-recommendations.ts --live --provider vercel
bun scripts/benchmark-recommendations.ts --live --provider typesafe

Sebenzisa AI_GATEWAY_API_KEY ku-Vercel noma TYPESAFE_API_KEY noma JEV_KEY ku-TypeSafe. Lesi skripthi asilungisi uhlelo lokusebenza futhi asigcini imininingwane yokungena. Isampula yaso yokwenziwa ayisona isiqinisekiso sokubambezeleka ekukhiqizeni noma sokulinganiswa kwamathuba.

Qinisekisa ukuthunyelwa noma umnikelo

Qalisa ukuhlolwa kwezinhlobo kanye nochungechunge lokuhlola oluhlukanisiwe ngaphambi kokuthumela izinguquko:

bun run typecheck
bash scripts/test-isolated.sh

Uchungechunge lokuhlola oluhlukanisiwe ludala futhi lususe isibonelo salo se-Docker Compose PostgreSQL ngaphandle kokushicilela izimbobo zesizindalwazi. Luhlanganisa ukugunyazwa, izinguqulo, ukuziphatha kwe-API ne-MCP, i-CLI, izilungiselelo ezibethelwe, nezincomo. Ungalokothi uqondise ukuhlolwa kwesizindalwazi ekukhiqizeni.

Isiphetho

ISkillbox inikeza ukuhamba komsebenzi okulawulwayo, okusingathwa nguwe, kokuphatha amakhono e-AI-agent angasetshenziswa kabusha. Qala ngokusethwa kwe-Docker, dala amakhono anezinguqulo, nika amaphrofayela anobubanzi obuncane, bese uxhuma i-ejenti ngayinye ngokhiye wayo weklayenti. Ngemuva kwalokho ungangeza ukufinyelela kwe-MCP, izincomo ze-Jev ozikhethela, ukuhamba komsebenzi kokuphatheka, namakhophi ayisipele, kuyilapho ugcina ubunikazi bekhathalogi yakho nemininingwane yakho yokungena.