Ukwakha ukuhamba komsebenzi okuhunyushwayo nokubuyekezwayo kwamaphepha esayensi nobunjiniyela kusuka esiShayineni kuya esiNgisini usebenzisa i-sci-translation-skill

Isingeniso Sephrojekthi

i-sci-translation-skill iyisethi yemiyalelo yokuhumusha amaphepha, ukuphatha amatemu nokubuyekeza imibhalo ehunyushiwe, engalayishwa ku-coding agent futhi eqondiswe emsebenzini wokuhumusha amaphepha esayensi nobunjiniyela kusuka esiShayineni kuya esiNgisini, okuhlanganisa isayensi yamakhompyutha, ezokwelapha, ubunjiniyela, isayensi yezinto kanye neminye imikhakha. Akuyona imodeli entsha yokuhumusha, kodwa ihlanganisa izindinganiso zokuhamba komsebenzi, izivumelwano zezindima, ukuphathwa kwamatemu nemibhalo yendawo yokuhlola okuqinisekile.

Inhloso yephrojekthi akukhona nje ukukhiqiza isiNgisi “esifana ne-SCI”, kodwa ukunciphisa ukushintsha kwamatemu, ukuhlanekezelwa kwencazelo yezobuchwepheshe, ukulahleka kwemibandela nemikhawulo, ukubophezeleka okungalungile kwezinombolo kanye nokonakala kwefomethi, ngesikhathi kugcinwa ulimi lwemvelo. Lokhu kwenza umbhalo ohunyushiwe usondele enguqulweni yokuthumela umbhali angayibuyekeza isigaba nesigaba.

Ukushelela akusho ukunemba. Ukuhumusha kwesayensi kufanele kuqale ngokuvikela ububanzi bezimangalo zombhalo wokuqala, amandla obufakazi, ubudlelwano bembangela nomphumela, ukuphika, imibandela, izilinganiso kanye nemingcele yezobuchwepheshe.

Ukuhamba Komsebenzi Okuyinhloko

1. Ukwakha uhlu lwesakhiwo: Gcina umbhalo wokuqala, qopha uhlobo lwephepha, izahluko, abafundi okuqondiswe kubo nobubanzi bokuhlela, bese uhlaziya imingcele yezimangalo isigaba nesigaba.
2. Ukumisa amatemu ephrojekthi: Dala i-concept ID, ukuhumusha okujwayelekile, umongo, izinhlobo zamagama ezamukelekayo, amagama afanayo angavunyelwe, ubufakazi nezindaba ezingakaxazululwa kumqondo ngamunye obalulekile.
3. Ukuhumusha kokuqala okuthembekile: Qala ngokudlulisa ngokunembile umbhalo wokuqala, bese wenza ukuhlela okuqondiswe kumfundi, njengokucacisa umenzi wesenzo, ukuhlukanisa imisho enomthwalo omkhulu nokuthuthukisa ukuxhumana ngaphakathi kwesigaba, kodwa ungangezi izimpikiswano.
4. Ukubuyekeza okubheke ezinhlangothini zombili: Qhathanisa umbhalo wokuqala, ukuhumusha kokuqala nombhalo ohleliwe ngesikhathi esisodwa, uhlole ukuthi ukuhlela akuzange kungenise amaphutha amasha ezobuchwepheshe.
5. Ukulungisa nge-issue ID: Qopha inkinga ngayinye, ukulungiswa kwayo nesizathu, bese ubuyekeza umehluko wokugcina namatemu athintekile.
6. Ukuletha izinto zokubuyekeza: Khipha ukuhumusha, uhlu lwamagama, amarekhodi okubuyekeza nezinto ezidinga ukuqinisekiswa umbhali, bese uchaza ububanzi bangempela bokuhlola okwenziwe.

Lapho kucutshungulwa iphepha elisha, i-README iphakamisa ukuthi kuqale ngokuhunyushwa kwesivivinyo kwezigaba ezi-2 kuya kwezi-3 zendlela noma zemiphumela, bese kwandiselwa emzimbeni wombhalo, emifanekisweni, ematafuleni nasezithasiselweni, bese kufinyelelwa ekubhalweni kokugcina kwe-abstract. Lokhu kuvumela ukuqinisekiswa kwamatemu nokuhamba komsebenzi ngaphambi kokwandisa ububanzi bokucubungula.

Amakhono Ayinhloko Nemingcele Yokusetshenziswa

Amatemu Nokuthembeka Kwezobuchwepheshe

Le phrojekthi ivikela amatemu ephrojekthi ngokusebenzisa ama-concept ID, izinguqulo ezimisiwe namarekhodi omongo. Ayifuni ukuthi wonke amaphepha asebenzise uhlu lwamagama olulodwa olungaguquki; kunalokho, idala isivumelwano samatemu esizimele sephepha ngalinye. Ekubuyekezweni kwesigaba nesigaba, iphinde inake ukuphika, imibandela, izilinganiso, amandla obufakazi, izinombolo, amayunithi nokubophezeleka kwezinkomba.

Ukuhlela Okuqondiswe Kumfundi

Ukuhlela okuqondiswe kumfundi kuhlelisa ulwazi olukhona ngokwesahluko, kucacise abenzi bezenzo nezinkomba, kwehlise umthwalo womusho, futhi kusebenzise izenzo ezinencazelo yangempela nokuhleleka kwamagama okwemvelo ukuze kuncishiswe izisho ezingenalo ulwazi. Akufanele kususe i-hedging edingekayo, kwengeze incazelo engekho embhalweni wokuqala, noma kudlulisele impikiswano phakathi kwezigaba.

Ama-Agent Amaningi Nokwehlisa Ngokwethembeka

Uma kukhona ukwesekwa kwamathuluzi kwangempela, ucwaningo lwamatemu, ukuhumusha nokubuyekeza okuzimele kungabelwa ama-context emisebenzi ahlukene. Lapha, “ama-Agent amaningi” kusho ama-context emisebenzi amaningi azimele; akusho ngokuzenzakalelayo ukusetshenziswa kwamamodeli ahlukene noma ochwepheshe abangabantu. Uma amathuluzi angempela engekho, kufanele kusetshenziswe ukuzibuyekeza okulandelanayo futhi kudalulwe lokhu ngokucacile.

I-run-manifest isetshenziselwa ukuqopha ama-role ID angempela namamodeli aziwayo; akufanele kusungulwe izingodo zeqembu ezingekho. Amafomethi ayinkimbinkimbi nemibhalo yezokwelapha kusadinga ukuqinisekiswa komuntu noma kokunikezwa kwesithombe, futhi okuqukethwe kwezokwelapha kudinga ukubuyekezwa kokugcina nguchwepheshe.

Okubalulekile Ngokwemikhakha

• Amakhompyutha, ezokuphepha ne-AI: Gxila kumodeli yezinsongo, ukulawulwa kokufinyelela, i-KEM nokususwa kwe-payload, izimpawu zezibalo nemingcele yezobuchwepheshe.
• Ezokwelapha nezebhayoloji: Gxila ekwakhiweni kocwaningo, ekwehlukaniseni ukuhlobana nembangela, ubukhulu bomphumela, izikhawu, amasampula, imithamo, ama-endpoint nezikhathi.
• Ubunjiniyela nezinto: Gxila ezimweni zokuhlola, kumayunithi nobukhulu, ekuhlukaniseni izilinganiso zangempela nezilingiswa, emaphutheni nasebubanzini bokusebenza.

Ukufakwa Nendawo Yokusebenza

Faka ifolda ye-sci-translation-skill equkethe i-SKILL.md kufolda yamakhono esekelwa ngempela yi-host, futhi ugweme ukuyifaka ngaphakathi kwamanye amafolda ngokuphindaphindiwe. Ungaphinde unikeze i-agent ikheli le-repository ngqo, ukuze i-host iphathe ukufakwa.

Indawo eyisibonelo ye-Codex yasendaweni yi-~/.codex/skills/sci-translation-skill/SKILL.md. Uma ifolda yamanje iyimpande ye-repository, ungasebenzisa umyalo olandelayo ukufaka. Uma indawo okuqondiswe kuyo isivele inenguqulo, kunconywa ukuthi wenze ikhophi yokulondoloza kuqala.

mkdir -p ~/.codex/skills/sci-translation-skill
rsync -a --exclude '.git/' --exclude '.DS_Store' --exclude '__pycache__/' ./ ~/.codex/skills/sci-translation-skill/

Ngemva kokufaka, vuselela ikhono ku-host noma uvule iseshini entsha, bese uqinisekisa ukuthi ingakwazi ukufunda i-SKILL.md. Leli fayela alithathi indawo yemibhalo yokucushwa ye-host yamanje.

Lapho udlulisela kwenye i-host, qala ngokuqinisekisa i-interface yayo yokulayisha amakhono noma imithetho. I-Claude Code kufanele ilayishwe kufolda ye-skill esekelwa yinguqulo yamanje; i-Antigravity, i-Cursor, i-Windsurf ne-Aider kudinga ukuqinisekiswa kwe-interface yemithetho; i-Dify, i-FastGPT, i-Coze noma i-Harness ezakhelwe ngaphakathi kudinga ukwakha ngokwakho ama-role node, ukudluliswa kwamafayela, ukuphathwa kokuncika namarekhodi okuqalisa. Ukulayisha nje isizindalwazi solwazi akusho ukuthi sekwakhiwe ukuhamba komsebenzi kwama-Agent amaningi.

Ikhono alidingi ukusetshenziswa okuqondile kwe-Sonnet noma i-Opus, futhi aliguquli ngokuzenzakalelayo ukucushwa kwe-host. Imibhalo yokuhlola idinga kuphela i-Python 3 standard library.

Ukusetshenziswa Okuyisisekelo

1. Ukuhumusha Kokuqala Ngemodi ye-Pilot

Uma uyisebenzisa okokuqala, ungacela i-agent ukuthi iqale idale uhlu lwamatemu, bese ihumusha ngokwesivivinyo izigaba ezi-2 kuya kwezi-3 ozikhethile. I-prompt kufanele icacise umkhakha, ijenali okuqondiswe kuyo nefomethi yokufaka, futhi icele ukugcinwa kwembangela, ukuphika, imikhawulo namanani.

Sebenzisa i-$sci-translation-skill, uhumushe iphepha ngemodi ye-pilot.
Umkhakha: [isifundo]; ijenali okuqondiswe kuyo: [igama noma akukanqunywa]; ifomethi: [LaTeX/Word/plain text].
Qala ngokwakha uhlu lwamatemu emzimbeni wombhalo, ezincazelweni zamafomula, emifanekisweni, ematafuleni nasezithasiselweni, bese uhumusha ngokwesivivinyo izigaba ezi-2–3 engizikhethile.
Qala ngokuhumusha ngokwethembeka, bese uhlela ulwazi ngaphakathi kwesigaba ngokwesahluko nangokombono womfundi; cacisa umenzi wesenzo nezinkomba, ungaphoqi ubude bemisho obufanayo.
Gcina imbangela, ukuphika, imikhawulo namanani ombhalo wokuqala; ungangezi ukuhlola, izinkomba noma iziqinisekiso zokuphepha.
Uma kunethuluzi le-Agent ezimele, lihlukanise umsebenzi wokubuyekeza; uma lingekho, chaza ukuzibuyekeza okulandelanayo.
Khipha ukuhumusha, amatemu amisiwe, izincazelo zokulungisa ezinendawo kanye nezinto ezidinga ukuqinisekiswa umbhali.

Umphumela wokuhumusha kwesivivinyo kufanele okungenani ube nokuhumusha, amatemu amisiwe, izincazelo zokulungisa ezinendawo nezinto ezidinga ukuqinisekiswa umbhali. Ngemva kokuqinisekisa amatemu nendlela yokusebenza, qhubeka nokucubungula umbhalo ogcwele.

2. Ukubuyekeza Umbhalo Owuqhathanisa IsiShayina NesiNgisi

Uma usuvele unombhalo wokuqala wesiShayina kanye nombhalo ohunyushiwe wesiNgisi, ungasebenzisa imodi ye-review. Uhlelo lokubuyekeza kufanele luqale ngokuhlola incazelo yezobuchwepheshe, amatemu, amandla ezimangalo, izinombolo, amayunithi nezinkomba, bese lubheka ubunjalo bolimi.

Sebenzisa imodi ye-review ye-$sci-translation-skill ukuze ubuyekeze isiNgisi isigaba nesigaba ngokuqhathanisa nesiShayina.
Qala ngokuhlola incazelo yezobuchwepheshe, amatemu, amandla ezimangalo, izinombolo/amayunithi nezinkomba, bese ubheka ubunjalo bolimi.
Lungisa kuphela izinkinga ezinobufakazi; hlukanisa okuthandwayo okufana nokuthi “uses→adopts” emaphutheni angempela.
Hlola kuqala izithiyo zokufunda ngaphambi kokushintsha imisho; qhathanisa ukuhumusha kokuqala nombhalo ohleliwe ukuze ubuyekeze ububanzi bemibandela, imbangela, izinkomba nokubophezeleka kwazo.
Bhala umbhalo wokuqala, ukuhumusha kwamanje, ukulungiswa nesizathu sento ngayinye, bese ubuyekeza ngemva kokulungisa.

Le modi ihlukanisa amaphutha angempela nokuthandwa kwendlela yokusho. Isibonelo, ukushintsha nje i-uses ibe yi-adopts akusho ngempela ukuthi kunenkinga yezobuchwepheshe, ngakho umehluko ngamunye wesitayela akufanele ubhaliswe njengephutha.

3. Ukuhumusha Umbhalo Ogcwele Nokuvikela Umbhalo Wokuqala

Imodi yombhalo ogcwele ifanele ukusetshenziswa ngemva kokuqinisekiswa kwamatemu nemiphumela yokuhumusha kwesivivinyo. Kufanele ucele i-agent ukuthi ilethe umphumela kufolda entsha futhi ingabhali phezu kombhalo wokuqala; zonke izingxenye kufanele zabelane ngenguqulo efanayo yohlu lwamagama nomongo wocwaningo, futhi zihlanganise umzimba wombhalo, izincazelo zemifanekiso, amatafula, izincazelo zamafomula, ama-algorithm nezithasiselo.

Sebenzisa i-$sci-translation-skill ukuze uhumushe umbhalo ogcwele usebenzisa uhlu lwamagama oluqinisekisiwe.
Letha umphumela kufolda entsha; ungabhali phezu kombhalo wokuqala. Wonke amabhulokhi abelane ngenguqulo efanayo yohlu lwamagama nomongo wocwaningo.
Hlanganisa umzimba wombhalo, izincazelo zemifanekiso, amatafula, izincazelo zamafomula, ama-algorithm nezithasiselo; ekugcineni hlola ububanzi bezimangalo ze-abstract.
Letha umbhalo wesiNgisi, uhlu lwamagama, ukuqondanisa kwesigaba nesigaba, irekhodi lokuvala ukubuyekezwa nezinto ezisalindele ukuqinisekiswa.

Ukusebenzisa Amathuluzi Okuhlola Okuqinisekile

I-repository inikeza imibhalo yasendaweni yokuhlola umehluko obonakalayo ekuhumusheni. Qala ngokusebenzisa ukuhlola kokuphelela kwekhono:

bash references/test-skill-integrity.sh

Bese ungasebenzisa amafayela omthombo nawokuhumusha ukuze wenze i-audit yokuhumusha:

python3 scripts/audit_translation.py source.tex target.tex \
  --glossary terminology-glossary.json \
  --alignment alignment.json \
  --output qa-report.json

Le audit ingahlola izinombolo, izingxenye ezivikelwe, inani lezinkomba, isakhiwo esiyisisekelo, ulwazi lokuqondanisa namatemu abhalisiwe. Ungaqhubeka nokusebenzisa i-shell entry ebikhona:

bash references/test-translation-structure.sh source.tex target.tex glossary.json

Izincazelo zama-exit code zimi kanje:

• 0: Ukuhlola okwenziwe akutholanga mehluko.
• 1: Kutholakale umehluko odinga ukuqinisekiswa okwengeziwe.
• 2: Iphutha lokufaka noma lokuhlaziya.

I-exit code engu-0 ayisho ukuthi umbhalo ohunyushiwe usulungele ukuthunyelwa. Uma i-alignment inganikezwanga, akukwazi kushiwo ukuthi kuqediwe ukumbozwa kwesigaba nesigaba noma ukuhlolwa kokuhambisana kwamatemu. Okunye ukulandelana kwezinombolo okulungile noma ukulungiswa kwefomethi kungase kubangele umehluko, futhi kudinga ukuthi umuntu aqophe futhi aphathe umphumela.

Le mibhalo ayenzi ukuhlola “ukunambitheka kwe-AI” futhi ayiqinisekisi ukunemba komkhakha. Ingakusiza kuphela ukuthola umehluko wesakhiwo oqinisekisekayo, futhi ayithathi indawo yokubuyekezwa kwencazelo, ukuqinisekiswa komuntu noma ukubuyekezwa kokugcina nguchwepheshe.

Izincomo Zokusebenza Okuthuthukile

Ukumisa Inguqulo Yohlu Lwamatemu Nokurekhoda Umongo

Ungasebenzisi uhlu lwamagama lwesibonelo ngqo kuwo wonke amaphepha. Uhlu lwamagama lwesibonelo olunikezwe yiphrojekthi lusetshenziselwa ukubonisa izinkambu kuphela futhi aluqinisekisiwe ngaphandle. Iphrojekthi yangempela kufanele yakhe amarekhodi ayo amatemu ngokomqondo, ngesahluko nangokomongo, bese ibuyekeza amatemu athintekile ngemva kokulungisa.

Ukuhlukanisa Umkhawulo Wokuthembeka Nekhwalithi Yolimi

Qala ngokunquma ukuthi ukuhumusha kuyayigcina yini incazelo yesayensi, bese uhlola ukuthi imisho ingokwemvelo yini. Ukungatholakali kwamaphutha akusho ngokuzenzakalelayo amaphuzu aphelele, ngoba ukumbozwa kokuhlola kungase kube nomkhawulo noma kusenezinkinga ezingakabonwa. Ukuhlela ulimi nakho akukwazi ukufihla ubuthakathaka bobufakazi ngenkulumo enhle kakhulu.

Ukuvikela Ifomethi Nokubophezeleka Kwezinkomba

Ngaphambi kokuqala ukuhumusha, yakha uhlu lwesakhiwo, uqophe ikakhulukazi amafomula, ama-macro, izingcaphuno, izixhumanisi zamathebula, izincazelo zemifanekiso nezithasiselo. Ngemva kokulungisa, ungahloli nje ukuthi izinombolo zisekhona yini; qinisekisa nokuthi zisabophezeleke kumethrikhi, iyunithi nombandela ofanele. Inani lamafomula elifanayo alisho ukuthi okuguquguqukayo akushintshanga.

Ukuvala Ukulungisa Ngezinombolo Zezinkinga

Gcina i-issue ID ezinzile yenkinga ngayinye, uqophe umbhalo wokuqala, ukuhumusha kwamanje, ukulungiswa, isizathu nendawo. Ngemva kokuqeda ukulungisa, qhathanisa kabusha umbhalo wokuqala, ukuhumusha kokuqala nombhalo ohleliwe, ugxile ekubuyekezeni ububanzi bemibandela, ubudlelwano bembangela, amamethrikhi, izinkomba namandla ezimangalo.

Umhlahlandlela Wamafayela Ephrojekthi

• SKILL.md: Indawo yokungena yekhono nemibandela yokugunyaza.
• Isivumelwano Samatemu: I-schema esihlanganisiwe sohlu lwamagama nefomethi ye-alignment.
• Izivumelwano Zezindima: Izimfuneko zamathuluzi angempela nobunikazi bamafayela.
• Umhlahlandlela Wolimi: Ukuveza okuthembekile, okufushane nokwemvelo.
• Ukuhlela Okuqondiswe Kumfundi: Ukuhlelwa kwezahluko, umthwalo wangaphakathi komusho, ukuxhumana nokuhlolwa kokuthembeka ngemva kokuhlela.
• Ukucushwa Komkhakha: Izingozi ezibalulekile emikhakheni ehlukene.
• Ukuhlola Ukuziphatha: Uhlelo lokwamukela ukuziphatha kwemodeli.
• Isibonelo Sokuhumusha: Izibonelo zomehluko ezakhayo, hhayi ubufakazi bemiphumela eshicilelwe.

Isiphetho

Inani le-sci-translation-skill lisekutheni iguqula ukuhumusha iphepha kusuka ekupholishweni kwesikhathi esisodwa kube ukuhamba komsebenzi okulandelekayo okuhlanganisa ukumiswa kwamatemu, ukuhumusha kokuqala okuthembekile, ukubuyekeza okuzimele, ukuhlola umehluko nokuqinisekiswa umbhali. Ukuyisebenzisa ngokulandelana kwe-pilot, review, ukulethwa kombhalo ogcwele ne-audit yokugcina kungasiza ekutholeni ubungozi bezobuchwepheshe nefomethi kusenesikhathi.

Nokho, akulona ithuluzi eliqinisekisa ngokuzenzakalelayo ukunemba komkhakha futhi alikwazi ukuthatha indawo yokuqinisekiswa kombhali kweziphetho zesayensi. Kumafomethi ayinkimbinkimbi, imibhalo yezokwelapha nanoma yimuphi umbhalo ohunyushiwe olungiselelwa ukuthunyelwa, kusadingeka ukuhlanganisa ukuhlolwa kokunikezwa kwesithombe, ukubuyekezwa komuntu kanye nokubuyekezwa kokugcina nguchwepheshe.