Lokaliseerimisest saab agendi oskus, mitte SDK

Varem tähendas rakenduse lokaliseerimine SDK lisamist, teenusepakkuja ühendamist ja võtmete käsitsi haldamist. AI-kodeerimisagentidega on tee lühem: installige oskus ja agent teeb ühendamise teie eest. globalize.now on AI-põhine lokaliseerimisinfrastruktuur, mis on saadaval avatud agendioskusena. Käivitate ühe käsu, agent loeb juhendi läbi ja teie koodibaas saab tõlkeks valmis struktuuri, ilma et peaksite uut ühenduskihti hooldama.

Mis on agendioskus?

Agendioskus on väike juhiste pakett, mida kodeerimisagent loeb ja mille järgi tegutseb. Seda levitatakse avatud oskuste ökosüsteemis ning installitakse skills CLI abil, näiteks npx skills add owner/repo. Sama käsk töötab Claude Code’i, Cursor’i, Codexi, OpenCode’i ja enam kui viiekümne muu agendiga.

Oskus ise koosneb failist SKILL.md ja võimalikest tugifailidest ning paigutatakse kataloogi, kust teie agent oskusi juba otsib. CLI lingib selle ühe kanoonilise koopiaga ja salvestab installimise lockfile’i, nii et oskus on versioonihalduses koos ülejäänud projektiga, mitte teenusepakkuja kontol. Olemas on ka avalik register, seega saate oskust leida, lugeda ja fikseerida nagu iga muud sõltuvust.

Oluline muutus on järgmine: oskus ei ole toode, millega teie agent integreerub. See on teadmine, mille agent omandab ja seejärel teie koodile rakendab. Erinevus tuleb esile kohe, kui liitub uus meeskonnaliige. Ta kloonib hoidla, oskus on juba olemas ja tema agent korraldab lokaliseerimise samamoodi nagu teie oma.

Miks pakkuda i18n-i SDK asemel oskusena?

Sest rahvusvahelistumise keeruline osa on refaktoreerimine ning oskus õpetab agendile, kuidas seda teie eest teha. SDK eeldab, et teie kood on juba tõlkimiseks sobiva struktuuriga. Peate endiselt leidma hardcoded string’id, kavandama võtmeskeemi, looma lokaalifailid ja ühendama käitusaegse teegi.

AI abil loodud rakendused muudavad olukorra veel keerulisemaks, sest kodeerimisagendid optimeerivad töötava ekraani, mitte tõlkearhitektuuri nimel. Tulemuseks on tavaliselt korrektne ja väljastatav rakendus, mis on täis selliseid string’e nagu <button>Submit order</button>, mitte võtmega kutseid. Kui see kogu projektis kordub, on lokaliseerimine konfiguratsioonimuudatuse asemel refaktoreerimine.

Kui see omapäi jätta, kuhjub probleem kiiresti. Sama silt kirjutatakse kolmel veidi erineval viisil, arvud renderdatakse kujul 1 messages ning esimese keele lisamisel avastate ekraane, kus pool tekstist on inglise ja pool mõnes muus keeles. Oskus on loodud selle kõige tabamiseks ühe korraga, enne kui sellest saab sada väikest tööülesannet.

Oskus kodeerib selle refaktoreerimise juhisteks, mida agent saab käivitada. See tuvastab teie raamistiku, kinnitab juba kasutatava i18n-i käituskeskkonna, näiteks next-intl-i või i18next-i, eraldab ingliskeelsed string’id ning genereerib võtmed ja lokaalifailid. Te ei impordi uut käitusaegset teeki, mida versioonida ja hooldada. Oskus teeb seadistuse ära ja astub seejärel kõrvale.

Mille poolest erineb oskus MCP-serverist?

MCP-server on teenus, mida teie agent kutsub, oskus aga lihtsalt failid teie projektis. Model Context Protocol on hea viis anda agentidele töötava serveri kaudu ligipääs reaalajas tööriistadele ja andmetele. Serverit peab aga teie või teenusepakkuja majutama ning agent sõltub sellest, et server oleks kättesaadav.

Oskuse taga ei ole teenust. See on tekst ja kood, mis asuvad teie hoidlas, töötavad ilma võrgupäringuta ja ilmuvad pull request’is nagu iga muu muudatus. Ühekordse seadistustöö, näiteks koodibaasi rahvusvahelistumise puhul, on failid paremad kui teenus, mida peate töös hoidma. Loete, mida oskus tegema hakkab, käivitate selle ja vaatate diff’i üle.

Oskusi saab ka kombineerida. Võite installida mitu oskust ja need paiknevad kõrvuti, sest igaüks neist on ainult juhised, mitte järjekordne protsess, mida käivitada ja mille eest maksta.

Kuidas installitakse globalize.now agendioskusena?

Üks käsk ja ülejäänu teeb teie agent.

npx skills add globalize-now/globalize-skills --all

Lipp --all installib kõik oskused teie arvuti kõigi agentide jaoks – see on turvaline vaikevalik, kui te pole kindel, millist agenti kasutate. CLI paigutab globalize.now oskuse sinna, kust teie agent oskusi otsib. See töötab teie juba kasutatava agendiga, sealhulgas Claude Code’i ja Cursor’iga.

Seejärel palute agendil i18n seadistada ja see järgib juhendit: tuvastab raamistiku, kinnitab käitusaegse teegi, leiab kasutajale kuvatavad ingliskeelsed string’id ning genereerib võtmed ja lokaalifailid. Enne ja pärast – just seda osa arendajad mõistavad.

// before
<button>Submit order</button>

// after
<button>{t("checkout.submit_order")}</button>

Võtmed paigutatakse lokaalifailidesse, mille oskus teie eest loob ja hooldab:

/locales
  en.json
  de.json
  es.json
  fr.json

Ingliskeelne fail täidetakse string’idega, mille agent leidis. Teised keeled genereeritakse ja hoitakse iga push’i järel ajakohasena, nii et uue turu lisamine tähendab lokaalifaili, mitte arendussprinti.

Pärast seadistamist sünkroonitakse tõlked iga Git push’i järel. Te ei ekspordi midagi ja tühjendamist ootavat järjekorda pole. Kui te kodeerite oma rakendust vibe’i järgi, ongi kogu töö tehtud. Kui olete arendaja, kes soovib üksikasju, teeb sama oskus refaktoreerimise puhtalt ära ja jätab teile standardsed lokaalifailid.

Kas minu tõlked jäävad minu hoidlasse?

Jah. Oskuse loodud lokaalifailid commit’itakse teie hoidlasse nagu kõik muud lähtefailid. Just see on vendor lock-in’i vältimisel kõige olulisem.

Mõni lahendus viib tõlgitud string’id build’i etappi või majutatud juhtpaneelile, nii et lahkumise päeval lahkub tõlkekiht koos teiega. Hoidlapõhiste lokaalifailide korral on teie en.json, de.json ja ülejäänud failid lihtsalt teie projekti tavalised failid. Isegi kui oskus homme kaoks, väljastaks teie rakendus endiselt kõiki keeli, mis tal juba olemas on. Lahkumiseks piisab, kui te oskust enam ei installi – midagi pole vaja välja migreerida, sest teie andmed pole kunagi mujal olnud. Seetõttu paikneb globalize.now teie tehnoloogiavirna infrastruktuurikihis: see genereerib võtmed ja lokaalifailid, mitte ei mähi end teie rakenduse ümber.

Kas oskusmudel seob mind ühe teenusepakkujaga?

Ei, ja lock-in’i vältimine ongi põhjus seda eelistada. Oskus installitakse avatud registrist, mida saab lugeda iga toetatud agent, mitte suletud pluginate poest. Väljundiks on teie juba valitud käitusaegse teegi standardsed lokaalifailid, mitte varaline vorming, mida peaksite hiljem lahti harutama.

Enne käivitamist saate täpselt lugeda, mida oskus teeb, sest see koosneb lihtsalt failidest. Kui soovite väite asemel täielikku läbikäiku, käsitleb juhend AI abil loodud rakenduse lokaliseerimine sama seadistust algusest lõpuni.