Lokalizacija tampa agento įgūdžiu, o ne SDK

Anksčiau programėlės lokalizavimas reiškė SDK pridėjimą, tiekėjo prijungimą ir rankinį raktų tvarkymą. Naudojant DI kodavimo agentus kelias trumpesnis: įdiekite įgūdį, o agentas atliks prijungimo darbus. globalize.now yra DI pagrįsta lokalizacijos infrastruktūra, pateikiama kaip atviras agento įgūdis. Paleidžiate vieną komandą, agentas perskaito veiksmų planą, o jūsų kodų bazė įgauna vertimui paruoštą struktūrą — nereikia prižiūrėti naujos infrastruktūros.

Kas yra agento įgūdis?

Agento įgūdis — tai nedidelis instrukcijų paketas, kurį kodavimo agentas perskaito ir pagal jį veikia. Jis platinamas atviroje įgūdžių ekosistemoje ir įdiegiamas naudojant skills CLI, pavyzdžiui, npx skills add owner/repo. Ta pati komanda veikia su Claude Code, Cursor, Codex, OpenCode ir daugiau nei penkiasdešimčia kitų agentų.

Pats įgūdis yra SKILL.md failas ir papildomi palaikomieji failai, patalpinami kataloge, kuriame jūsų agentas jų jau ieško. CLI susieja jį su viena kanonine kopija ir įrašo diegimą į lockfile, todėl įgūdis versijuojamas kartu su likusiu projektu, o ne laikomas tiekėjo paskyroje. Be to, yra viešas registras, todėl įgūdį galite rasti, perskaityti ir užfiksuoti jo versiją kaip bet kurią kitą priklausomybę.

Svarbus pokytis yra toks: įgūdis nėra produktas, su kuriuo jūsų agentas integruojasi. Tai žinios, kurias agentas perima ir pritaiko jūsų kodui. Skirtumas išryškėja vos prisijungus naujam komandos nariui. Jis klonuoja saugyklą, įgūdis jau yra vietoje, o jo agentas lokalizaciją tvarko taip pat, kaip ir jūsų agentas.

Kodėl i18n pateikti kaip įgūdį, o ne SDK?

Nes sudėtingiausia internacionalizacijos dalis yra refaktorizavimas, o įgūdis išmoko jūsų agentą jį atlikti už jus. SDK daro prielaidą, kad jūsų kodas jau paruoštas vertimui. Vis tiek turite rasti kietai įrašytas eilutes, sukurti raktų schemą, parengti lokalės failus ir prijungti vykdymo biblioteką.

DI sukurtos programėlės šią problemą dar labiau išryškina, nes kodavimo agentai optimizuoja veikiančiam ekranui, o ne vertimo architektūrai. Rezultatas paprastai būna teisingas ir paruoštas išleisti, tačiau pilnas tokių eilučių kaip <button>Submit order</button>, o ne iškvietimų su raktais. Kai tai pasikartoja visame projekte, lokalizacija tampa refaktorizavimu, o ne konfigūracijos pakeitimu.

Palikus viską savieigai, problema kaupiasi. Ta pati etiketė užrašoma trimis šiek tiek skirtingais būdais, skaičiai atvaizduojami kaip 1 messages, o pirmą kartą pridėję kalbą randate ekranų, kuriuose pusė teksto angliška, o kita pusė — ne. Įgūdis sukurtas tam, kad visa tai aptiktų vienu veiksmu, kol problema nevirsta šimtu smulkių užduočių.

Įgūdis šį refaktorizavimą užkoduoja kaip instrukcijas, kurias gali vykdyti jūsų agentas. Jis aptinka jūsų karkasą, patikrina jau naudojamą i18n vykdymo biblioteką, pavyzdžiui, next-intl ar i18next, ištraukia angliškas eilutes ir sugeneruoja raktus bei lokalės failus. Nereikia importuoti naujos vykdymo bibliotekos, kurią tektų versijuoti ir prižiūrėti. Įgūdis atlieka sąranką ir pasitraukia iš kelio.

Kuo įgūdis skiriasi nuo MCP serverio?

MCP serveris yra paslauga, į kurią kreipiasi jūsų agentas, o įgūdis tėra jūsų projekto failai. Model Context Protocol yra geras būdas suteikti agentams tiesioginę prieigą prie įrankių ir duomenų per veikiantį serverį. Tačiau serverį turite jūs arba tiekėjas, o jūsų agentas priklauso nuo to, ar serveris pasiekiamas.

Įgūdis neturi už jo veikiančios paslaugos. Tai tekstas ir kodas, esantys jūsų saugykloje, veikiantys be tinklo užklausų ir matomi pull request kaip bet kuris kitas pakeitimas. Vienkartinėms sąrankos užduotims, pavyzdžiui, kodų bazės internacionalizavimui, failai yra geresnis pasirinkimas nei paslauga, kurią reikia nuolat palaikyti. Perskaitote, ką įgūdis atliks, paleidžiate jį ir peržiūrite diff.

Įgūdžius taip pat galima derinti. Galite įdiegti kelis — jie veiks greta, nes kiekvienas yra tik instrukcijos, o ne dar vienas procesas, kurį reikia paleisti ir už kurį mokėti.

Kaip globalize.now įdiegiamas kaip agento įgūdis?

Viena komanda — ir toliau viskuo pasirūpina jūsų agentas.

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

Vėliavėlė --all įdiegia kiekvieną įgūdį kiekvienam agentui jūsų kompiuteryje — tai saugus numatytasis pasirinkimas, jei nesate tikri, kurį agentą naudojate. CLI įdeda globalize.now įgūdį ten, kur jūsų agentas ieško įgūdžių. Jis veikia su jūsų jau naudojamu agentu, įskaitant Claude Code ir Cursor.

Toliau paprašote agento nustatyti i18n, o jis vadovaujasi veiksmų planu: aptinka karkasą, patikrina vykdymo biblioteką, randa naudotojui matomas angliškas eilutes ir sugeneruoja raktus bei lokalės failus. Kūrėjams labiausiai atpažįstamas būtent skirtumas tarp pradinės ir galutinės būsenos.

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

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

Raktai patenka į lokalės failus, kuriuos įgūdis sukuria ir prižiūri už jus:

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

Jūsų angliškas failas užpildomas agento rastomis eilutėmis. Kitos kalbos sugeneruojamos ir atnaujinamos po kiekvieno įkėlimo, todėl naujos rinkos pridėjimas reiškia lokalės failą, o ne visą sprintą.

Po sąrankos vertimai sinchronizuojami po kiekvieno Git įkėlimo. Nereikia nieko eksportuoti ir nėra eilės, kurią turėtumėte išvalyti. Jei kuriate programėlę vibe kodavimo būdu, tai ir yra visas darbas. Jei esate kūrėjas, norintis išsamios informacijos, tas pats įgūdis tvarkingai atlieka refaktorizavimą ir palieka jums standartinius lokalės failus.

Ar mano vertimai lieka saugykloje?

Taip. Įgūdžio sugeneruoti lokalės failai įtraukiami į jūsų saugyklą kaip ir bet kuris kitas šaltinio failas. Būtent tai svarbiausia siekiant išvengti priklausomybės nuo tiekėjo.

Kai kurie sprendimai perkelia išverstą tekstą į kūrimo etapą arba talpinamą valdymo skydą, todėl išėjus iš paslaugos kartu su jumis išeina ir vertimų sluoksnis. Naudojant saugykloje esančius lokalės failus, jūsų en.json, de.json ir visi kiti failai yra paprasti projekto failai. Net jei įgūdis rytoj išnyktų, jūsų programėlė ir toliau būtų leidžiama visomis jau turimomis kalbomis. Išeiti reiškia tiesiog daugiau nebediegti įgūdžio — nieko nereikia perkelti, nes jūsų duomenys niekada nebuvo kitur. Todėl globalize.now yra jūsų steko infrastruktūros sluoksnyje: jis generuoja raktus ir lokalės failus, o ne apgaubia jūsų programėlę.

Ar įgūdžių modelis susieja jus su konkrečiu tiekėju?

Ne — būtent siekis išvengti priklausomybės nuo tiekėjo yra priežastis jį rinktis. Įgūdis diegiamas iš atviro registro, kurį gali perskaityti bet kuris palaikomas agentas, o ne iš uždaros papildinių parduotuvės. Rezultatas yra standartiniai lokalės failai jūsų jau pasirinktai vykdymo bibliotekai, o ne patentuotas formatas, kurį vėliau tektų išardyti.

Prieš paleisdami galite tiksliai perskaityti, ką įgūdis daro, nes tai tėra failai. Jei norite ne argumentų, o išsamaus paaiškinimo, vadove, kaip lokalizuoti DI sugeneruotą programėlę aprašoma visa sąranka nuo pradžios iki pabaigos.