Skillbox’ni o‘zingiz joylashtiring: AI agentlari uchun versiyalanadigan ko‘nikmalar kutubxonasini yarating

Skillbox nima?

Skillbox AI agentlari uchun MIT litsenziyasiga ega, o‘zingiz joylashtiradigan ko‘nikmalar kutubxonasidir. U qayta foydalaniladigan ko‘nikma paketlarini yaratish, import qilish, versiyalash, tarqatish va auditdan o‘tkazish uchun markaziy joyni taqdim etadi. Ilova React, Bun, Hono va PostgreSQL yordamida yaratilgan.

Yangi o‘rnatma ataylab bo‘sh bo‘ladi. Unda shaxsiy ko‘nikmalar, foydalanuvchi hisoblari, mijoz kalitlari, tashqi xizmat endpointlari yoki pullik AI provayderlarining hisob ma’lumotlari mavjud emas. Skillbox ko‘nikma kontentini tarqatadi, ammo yuklangan ko‘nikma kodini hech qachon bajarmaydi.

Asosiy imkoniyatlar

• Versiyalangan tahrirlash: Markdown va qo‘llab-quvvatlovchi fayllarni o‘zgarmas reviziyalar, ziddiyatlarni aniqlash va tiklash imkoniyatlari bilan tahrirlang.
• Cheklangan kirish: Ko‘nikma yoki to‘plam ruxsatlariga ega profillar yarating hamda yaratish, yangilash, arxivlash va taklif kiritish ruxsatlarini alohida belgilang.
• Bekor qilinadigan mijozlar: Alohida mijoz kalitlarini chiqaring, foydalanishni ko‘rib chiqing va zarur bo‘lganda keyingi kirishni bekor qiling.
• MCP va CLI orqali kirish: HTTP MCP’dan to‘g‘ridan-to‘g‘ri foydalaning, Node yoki Bun stdio ko‘prigi orqali ulang yoki paketlarni checksum tekshiruvi bilan yuklab oling.
• MCP resurslari: Ruxsat berilgan, mos ko‘nikmalarni MCP resurslarini ro‘yxatlash va o‘qishning asosiy imkoniyatlari orqali taqdim eting.
• Ixtiyoriy tavsiyalar: Jev’dan o‘zingizning Vercel AI Gateway yoki TypeSafe AI kalitingiz bilan foydalaning.
• Ma’lumotlar portativligi: Asl papkalarni import va eksport qiling, himoyalangan zaxira nusxalarini yarating va ma’lumotlarni aniq ko‘rsatilgan holda tiklang.
• O‘zingiz joylashtiradigan muhit: Docker Compose bilan ishga tushiring, HTTPS uchun ixtiyoriy ravishda old qismga Caddy’ni joylashtiring yoki Umbrel paketini tayyorlang.

Skillbox cheklangan mijozlarga ega, bitta egali, o‘zingiz joylashtiradigan ilova sifatida ishlab chiqilgan. U ommaviy ko‘p ijarachili SaaS platformasi emas.

Talablar

Tavsiya etilgan o‘rnatish uchun Compose v2 bilan Docker Engine yoki Docker Desktop, shuningdek Linux, macOS yoki WSL’da Bash talab qilinadi. Docker asosidagi sozlama uchun host tizimiga Bun yoki Node.js o‘rnatish shart emas.

Skillbox’ni o‘rnatish va ishga tushirish

1. Reponi klonlang va uning katalogiga kiring:

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

2. Mahalliy muhit faylini yarating:

   bash scripts/skillbox.sh setup

   Bu buyruq noyob tasodifiy hisob ma’lumotlari bilan .env faylini yaratadi, uning rejimini 0600 qilib belgilaydi va mavjud fayl ustidan yozishni rad etadi.

3. Docker xizmatlarini ishga tushiring:

   bash scripts/skillbox.sh start

4. Brauzeringizda http://127.0.0.1:4791 manzilini oching.

5. Mahalliy .env faylingizdan SKILLBOX_ADMIN_TOKEN qiymatini o‘qing va tizimga kirish uchun undan foydalaning. Sozlash skripti xavfsizlik sababli bu tokenni ekranga chiqarmaydi.

.env faylini maxfiy saqlang. Egasi tokeni ma’muriy kirishni boshqaradi va saqlangan integratsiya hisob ma’lumotlarini himoyalashda ham ishtirok etadi.

Masofaviy joylashtirish

Masofaviy o‘rnatish uchun SKILLBOX_ORIGIN qiymatini joylashtirishning HTTPS manziliga o‘rnating va TLS reverse proxy’ni sozlang. Ishlab chiqarish nusxasini shifrlanmagan HTTP orqali ochmang. Qo‘llab-quvvatlanadigan joylashtirish tafsilotlari uchun repodagi joylashtirish qaydlariga murojaat qiling.

Faqat Docker’ga xos ilova sozlamalarisiz mahalliy ishlab chiqish

Agar sizda allaqachon Bun va PostgreSQL 16 yoki undan yangi ma’lumotlar bazasi mavjud bo‘lsa, bog‘liqliklarni o‘rnating va ilovani to‘g‘ridan-to‘g‘ri ishga tushiring:

bun install --frozen-lockfile
# Set DATABASE_URL
# Set SKILLBOX_ADMIN_TOKEN to at least 32 random characters
# Set SKILLBOX_ORIGIN=http://127.0.0.1:4791
bun run build
bun run start

Talab qilinadigan uchala qiymatni manba kodiga kiritish o‘rniga himoyalangan muhitda saqlang.

Ko‘nikmalar va cheklangan mijozlarni yaratish

Tizimga kirgach, tahrirlovchida ko‘nikma yarating yoki mavjud ko‘nikma paketini import qiling. Ko‘nikma reviziyalari o‘zgarmas bo‘ladi, shuning uchun mijozlar o‘zgarib turadigan kontentga tayanish o‘rniga muayyan reviziyani yuklashi yoki olishi mumkin.

Keyin profil yarating va unga kerakli ko‘nikmalar yoki to‘plamlarga kirish huquqini bering. Mijoz maqsadiga muvofiq yaratish, yangilash, arxivlash va taklif kiritish ruxsatlarini mustaqil ravishda belgilang. Nihoyat, shu profildan foydalanib mijoz ulanishini yarating.

Mijoz kalitlari faqat bir marta ko‘rsatiladi va Skillbox faqat ularning xeshlarini saqlaydi. Har bir kalitni darhol himoyalangan mijoz konfiguratsiyasida saqlang. Egasi tokenini tarqatish o‘rniga har bir mijoz uchun alohida kalitdan foydalaning.

CLI’ni sozlash

CLI Skillbox URL manzili va mijoz kalitini o‘z ichiga olgan JSON konfiguratsiyasini o‘qiydi. Standart yo‘l: ~/.config/skillbox/config.json.

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

Fayl rejimini 0600 qilib belgilang. SKILLBOX_URL va SKILLBOX_TOKEN muhit o‘zgaruvchilari konfiguratsiya faylidagi qiymatlarni almashtiradi. URL sozlanmagan bo‘lsa, CLI boshqa birovning xizmatiga emas, xavfsiz tarzda localhost’ga ulanadi.

cli/skillbox.mjs va cli/package.mjs fayllarini birga saqlang. Shundan so‘ng ruxsat berilgan ko‘nikmalarni ko‘rib chiqishingiz va olishingiz mumkin:

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

Fetch amali fayllarni yozishdan oldin yo‘llar, fayl xeshlari, o‘lchamlar, bajariladiganlik bayroqlari va paket checksum’ini tekshiradi. U kodni bajarmaydi yoki bog‘liqliklarni o‘rnatmaydi.

Yangilangan ko‘nikmani nashr qilish

Yangilamoqchi bo‘lgan reviziyani ko‘rsatib, mahalliy papkani nashr qiling:

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

Kutilayotgan reviziya ziddiyatlarni aniqlashni qo‘llab-quvvatlaydi. Nashr qilish mijoz profiliga berilgan ruxsatlarga ham bog‘liq.

Audit bilan moslik

Egasi o‘zgartirish kiritmaydigan moslik auditini ishga tushirishi mumkin:

node cli/skillbox.mjs audit

Buyruq mos kelmaydigan paketlarni aniqlaganda 1 holat kodi bilan yakunlanadi. Bu mavjud paketlarni qayta yozmasdan MCP Skills bilan moslikni baholashga tayyorlaydi.

AI agentni MCP orqali ulang

bootstrap/SKILL.md faylini agentning skills-library bootstrap fayli sifatida o‘rnating. HTTP MCP’ni qo‘llab-quvvatlaydigan mijozlar instansingizdagi /mcp endpointiga ulanib, mijoz kalitini bearer token sifatida yuborishi mumkin:

Authorization: Bearer YOUR_CLIENT_KEY

stdio talab qiladigan MCP mijozi uchun kiritilgan bridge’ni sozlang:

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

Asosiy MCP vositalariga search_skills, recommend_skills, load_skill, read_skill_file va report_skill_use kiradi. Yozish va taklif vositalari faqat mijoz profilida tegishli ruxsatlar berilganda taqdim etiladi.

Skillbox, shuningdek, ruxsat berilgan mos skilllarni asosiy MCP’ning resources/list va resources/read endpointlari orqali taqdim etadi. Ikkilik va katta fayllarga resurs sifatida kirish mumkin, ammo resursni o‘qish skillni faollashtirmaydi yoki bajarmaydi.

To‘liq io.modelcontextprotocol/skills qo‘llovi hali e’lon qilinmagan. Joriy implementatsiya asosiy MCP protokoli orqali tayyorgarlik imkoniyatlarini taqdim etadi, mahalliy aniqlash va kelishish esa hali SDK hamda protokol yangilanishiga bog‘liq.

Qidiruv va tavsiyalardan to‘g‘ri foydalaning

Vazifa boshida agentlar tegishli ruxsat berilgan skilllarni ro‘yxatga olish uchun hali ham search_skills ni chaqirishi kerak. Tavsiyalar qo‘shimcha hisoblanadi va bu qidiruv bosqichining o‘rnini bosmaydi. Tanlangan skillni qo‘llashdan oldin uni Skillbox qaytargan o‘zgarmas reviziya yordamida yuklang.

Tashqi tavsiya provayderisiz CLI orqali qidirishingiz mumkin:

node cli/skillbox.mjs search "database migration"

Vazifani hisobga olgan tavsiyalarni so‘rash uchun:

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

MCP’dagi ekvivalent amal recommend_skills({task, limit?, offset?}) hisoblanadi. HTTP mijozlari xuddi shu autentifikatsiyadan o‘tgan JSON tanasini POST /api/skill-recommendations manziliga yuborishi mumkin.

Jev ixtiyoriy tavsiyalarini sozlang

1. Settings → Jev recommendations bo‘limini oching.

2. Standart bo‘lgan Vercel AI Gateway yoki TypeSafe AI ni tanlang.

3. Tanlangan provayder uchun o‘z API kalitingizni kiriting va saqlang.

Provayder kalitlari alohida saqlanadi. TypeSafe’ni tanlashda saqlangan Gateway kaliti TypeSafe’ga yuborilmaydi, provayderlarni almashtirish esa avval saqlangan kalitni saqlab qoladi. Tanlangan provayder kalitini olib tashlash ushbu provayder uchun model chaqiruvlarini o‘chiradi.

Kalit PostgreSQL’da SKILLBOX_ADMIN_TOKEN dan olingan kalit materiali yordamida AES-256-GCM bilan shifrlanadi. U sozlamalar API’si orqali qaytarilmaydi va brauzer paketlariga kiritilmaydi. Hujjatlashtirilgan almashtirish jarayoniga amal qilmasdan egasi tokenini o‘zgartirish saqlangan integratsiya hisob ma’lumotlarini o‘qib bo‘lmaydigan holga keltiradi.

Kalitni saqlash provayderga kirish yoki kreditlar xarid qilinganini tasdiqlamaydi. Jev vazifa matni va ruxsat berilgan faol skilllar tavsiflarini tanlangan provayderga yuboradi, shu sababli ushbu provayderning hisob-kitob hamda ma’lumotlardan foydalanish shartlari amal qiladi.

Tavsiya natijalari va zaxira mexanizmlarini tushuning

Jev to‘liq ruxsat berilgan, yoqilgan va arxivlanmagan leaf katalogini, ya’ni ko‘pi bilan 200 ta leaf yoki 120 000 ta seriyalashtirilgan belgini baholaydi. Kattaroq kataloglar oshkor qilinmagan qismni reytingga kiritish o‘rniga aniq zaxira mexanizmiga o‘tadi.

• Relevance ehtimollik emas, 0 dan 4 gacha bo‘lgan kalibrlanmagan balldir.
• Kamida 3 ball olgan natijalar ball kamayish tartibida, so‘ngra ID bo‘yicha qaytariladi.
• noMatch=true baholangan nomzodlardan hech biri chegaraviy qiymatga yetmaganini anglatadi.
• Kalit yo‘qligi, provayder xatosi, noto‘g‘ri formatdagi javob, rate limit, sig‘im limiti yoki sakkiz soniyalik deadline PostgreSQL qidiruviga o‘tishga sabab bo‘ladi.
• Zaxira natijalarida method=search, relevance=null va fallbackReason ishlatiladi.

Jarayon ichidagi kesh besh daqiqa davomida ko‘pi bilan 128 ta yozuvni saqlaydi. Skillbox bir vaqtda ikkita baholashga va har bir scope uchun daqiqasiga keshlanmagan o‘nta so‘rovga ruxsat beradi; avtomatik qayta urinishlar mavjud emas. Ruxsatlar, lifecycle holati va reviziyalar model chaqiruvlaridan oldin ham, keyin ham, jumladan keshdan olingan natijalarda ham tekshiriladi.

Ma’lumotlarni import qiling, eksport qiling va zaxiralang

Bun mavjud bo‘lsa, skilllar papkasini quyidagicha import qiling:

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

Importlar fayl baytlarini va noma’lum frontmatter’ni saqlaydi, symbolic linklar hamda runtime artefaktlarini o‘tkazib yuboradi va taniqli maxfiy ma’lumot andozalarini karantinga joylaydi. Bu aniqlash evristik usulga asoslanadi, shuning uchun to‘liq maxfiy ma’lumot auditining o‘rnini bosa olmaydi. Skill paketlariga hech qachon parol yoki token joylamang.

Skill tarkibini bo‘sh manzilga eksport qiling:

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

PostgreSQL ma’lumotlar bazasi asosiy haqiqat manbai bo‘lib qoladi. Eksport qilingan papkani tahrirlash tarkib qayta nashr etilmaguncha ma’lumotlar bazasini o‘zgartirmaydi.

Himoyalangan zaxira nusxasini yarating:

bash scripts/backup.sh

Eksportlar va zaxira nusxalarida maxfiy ko‘nikma mazmuni bo‘lishi mumkin. Ularni ommaviy ilova manba kodidan alohida saqlang. Ixtiyoriy GitHub eksport skripti aniq sozlangan, maxsus ajratilgan shaxsiy eksport checkout’ini talab qiladi va avtomatik ravishda yoqilmaydi.

Ilg‘or operatsion maslahatlar

Har bir integratsiya uchun bittadan mijoz kalitidan foydalaning

Alohida kalitlar bekor qilish va foydalanish hisobotlarini yanada foydali qiladi. Kalitni bekor qilish kelajakdagi so‘rovlarni bloklaydi, ammo mijoz allaqachon yuklab olgan fayllarni qaytarib ololmaydi.

Qamrovi tor profillarni afzal ko‘ring

Har bir agentga faqat zarur bo‘lgan ko‘nikmalar va amallarni bering. To‘plamlar joriy yakuniy ko‘nikmalarga kengaytiriladi va takroriylari olib tashlanadi, faqat havolalarning o‘zi esa kirish huquqini bermaydi.

Ega tokeni va zaxira nusxalarini himoyalang

Ega tokeni ma’muriy kirishni ta’minlaydi va saqlangan integratsiya hisob ma’lumotlari uchun shifrlash materialini hosil qiladi. Uni ma’lumotlar bazasi va konfiguratsiya zaxira nusxalari bilan birga himoyalang hamda tokenni almashtirishdan oldin hujjatlashtirilgan almashtirish tartibiga amal qiling.

Ko‘nikmalarni ishonchli dasturlar emas, mazmun sifatida ko‘ring

Skillbox paket fayllarini tekshiradi va tarqatadi, ammo ularni ishga tushirmaydi. Agent ish jarayonida foydalanishdan oldin yuklab olingan ko‘rsatmalar va kodni tekshirishda davom eting.

Benchmark tavsiyalaridan ehtiyotkorlik bilan foydalaning

Ishlab chiquvchilar ixtiyoriy, haq olinadigan benchmark’ni o‘z provayder kalitidan foydalanib ishga tushirishlari mumkin:

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

Vercel uchun AI_GATEWAY_API_KEY yoki TypeSafe uchun TYPESAFE_API_KEY yoxud JEV_KEY dan foydalaning. Bu skript ilovani sozlamaydi va hisob ma’lumotlarini saqlamaydi. Undagi sintetik namuna ishlab chiqarish muhitidagi kechikish kafolati yoki ehtimollik kalibrlashini anglatmaydi.

Joylashtirish yoki hissani tekshirish

O‘zgarishlarni joylashtirishdan oldin turlarni tekshirish va ajratilgan testlar to‘plamini ishga tushiring:

bun run typecheck
bash scripts/test-isolated.sh

Ajratilgan testlar to‘plami o‘zining Docker Compose PostgreSQL nusxasini yaratadi va o‘chiradi, bunda ma’lumotlar bazasi portlari tashqariga e’lon qilinmaydi. U avtorizatsiya, versiyalar, API va MCP xatti-harakatlari, CLI, shifrlangan sozlamalar hamda tavsiyalarni qamrab oladi. Ma’lumotlar bazasi testlarini hech qachon ishlab chiqarish bazasiga yo‘naltirmang.

Xulosa

Skillbox qayta foydalaniladigan AI-agent ko‘nikmalarini boshqarish uchun nazorat qilinadigan, o‘zingiz joylashtiradigan ish jarayonini taqdim etadi. Docker sozlamasidan boshlang, versiyalangan ko‘nikmalar yarating, qamrovi tor profillarni tayinlang va har bir agentni o‘z mijoz kaliti bilan ulang. Shundan so‘ng katalogingiz va hisob ma’lumotlaringiz ustidan egalikni saqlagan holda MCP kirishi, ixtiyoriy Jev tavsiyalari, ko‘chirish ish jarayonlari va zaxira nusxalarini qo‘shishingiz mumkin.