Sebenzisa i-Gongwen Skill Ukwakha Nokuhlola Imibhalo Kahulumeni ye-GB/T 9704-2012 ye-DOCX

Iyiphi inkinga exazululwa yile phrojekthi

IGongwen GB/T 9704-2012 Skill iyithuluzi lomthombo ovulekile elibhekene nezinto ezisemthethweni zesiShayina. Ayigcini nje ngokubeka izihloko ngefonti ye-Heiti kanye nombhalo oyinhloko ngefonti ye-Fangsong, kodwa icubungula izici zokwakheka njengekhasi le-A4, indawo yokubhala, izihloko, umbhalo oyinhloko, amazinga, ikhasi lokuqala, igama lesikhungo, inombolo yedokhumenti, isiginesha, usuku namakhasi ngokwezidingo ezisebenzisekayo ze-GB/T 9704-2012, bese ikhipha ifayela le-DOCX elisengaqhubeka nokuhlelwa.

Le phrojekthi ilungele imibiko evamile, izinhlelo nezethulo, futhi isekela nokukhishwa kwemibhalo esemthethweni, ukuphrinta phezu kwephepha elinekhanda elibomvu eliphrintiwe ngaphambilini, ikhanda elibomvu ledijithali eliphelele, izincwadi, imiyalo kanye namaminithi. Ngemva kokukhiqizwa, idokhumenti ingaqhubeka nokwengezwa amathebula, okunamathiselwe nezithombe zezitembu ku-Word noma ku-WPS, noma ihlelwe ukuze igxivizwe ngesitembu sangempela.

I-GB/T 9704-2012 isebenza emibhalweni esemthethweni ekhishwa yizinhlangano zeqembu nama-ejensi kahulumeni; ezinye izinhlangano namayunithi zingayilandela ngokubhekisela kuyo. I-README ithi leli zinga laqhubeka lisebenza ngemva kokubuyekezwa kwalo mhla zingama-30 kuNhlaba 2025.

Imisebenzi eyinhloko nemikhawulo yokusetshenziswa

• Izinto ezivamile: sebenzisa ordinary ngokuzenzakalela; noma ngabe kunikezwe igama lesikhungo, ikhanda elibomvu ngeke likhiqizwe ngokuzenzakalela.
• Ukukhishwa okusemthethweni: kufanele ukhethe ngokusobala formal. Imodi yephepha elinekhanda elibomvu eliphrintiwe ngaphambilini igcinela ikhanda elibomvu nomugqa obomvu osuvele usephepheni kuphela isikhala, futhi ngeke iphinde ikudwebe ku-DOCX.
• Ikhanda elibomvu ledijithali: umkhiqizi udweba zonke izici zekhanda elibomvu kuphela uma kusethwe formal --letterhead digital.
• Igama lesikhungo nenombolo yedokhumenti: kunikezwa nge---org nange---doc-no. Isakhiwo esisemthethweni sizokwenqaba izinombolo zemibhalo eziphambuka ngokusobala emithethweni yonyaka, yabakaki abanamacala ayisithupha, yenombolo yokulandelana kanye nohlamvu “号”.
• Izihloko nethebula lokuqukethwe: izihloko zamazinga amane zibhalwa ezitayeleni ze-“Heading 1” kuya ku-“Heading 4” ze-Word/WPS kanye namazinga azo ohlaka, okwenza kube nokwenzeka ukufaka ithebula lokuqukethwe elizenzakalelayo.
• Amakhasi: kusekelwa izindlela ezintathu: ukubekwa phakathi nendawo, amakhasi angalingani nalinganayo, nokungabonisi izinombolo. Amapharamitha athile kufanele asekelwe ku-SKILL.md yephrojekthi.
• Okunamathiselwe namaphuzu okuhlela: okunamathiselwe kungakhiqizwa ekhasini elihlukile futhi kugcine izinombolo zamakhasi asemthethweni ziqhubeka; imininingwane yokwabelana noma yokuphrinta ingagxiliswa ngaphansi kwendawo yokubhala ekhasini lokugcina.
• Ukucubungula ngesandla: izitembu, izitembu zamasiginesha, okuqukethwe kokunamathiselwe nendawo yangempela yokugxiviza kusadingeka kwengezwe noma kuqinisekiswe ku-DOCX ngokuya ngenhloso yokusetshenziswa.

Ukulungisa iphrojekthi nendawo yokusebenza

Qala ngokuthola inqolobane ekhelini lephrojekthi ku-GitHub, bese ungena emkhombandlela oyimpande wephrojekthi. Umkhiqizi nomqinisekisi basebenzisa i-node, ngakho ikhompuyutha kufanele ibe nendawo esebenzayo ye-Node.js; i-README ayicacisi inguqulo ethile, ngakho landela imibhalo nezivivinyo zamanje zenqolobane.

Uma ufuna ukukhiqiza i-DOCX ngokuqondile, sebenzisa imibhalo yeskripthi enqolobaneni. Uma ufuna ithuluzi lokuhlela nge-AI lifunde le Skill ngokuzenzakalela, ungasebenzisa isifaki esisebenza kuwo wonke amapulatifomu.

macOS ne-Linux

scripts/install.sh --all

Windows

.\scripts\install.ps1 -All

Isifaki sixhumanisa umkhombandlela ofanayo womthombo nemikhombandlela yamakhono esezingeni lomsebenzisi yamapulatifomu ahlukahlukene. I-Windows isebenzisa ukukopisha ngokuzenzakalela ukuze igweme izinkinga zezimvume zezixhumanisi ezingokomfanekiso. Amapulatifomu asekelwayo afaka i-Codex, Claude Code, OpenCode, Trae Code, Trae CLI, Kimi Code CLI, Kimi Code, WorkBuddy ne-ZCode. I-TraeWork ingenisa iphakheji etholakala ku-dist/traework-gongwen-skill.zip yenqolobane.

Ukukhiqiza into yokuqala evamile

Iphrojekthi inefayela lokufaka lokuhlola elithi tests/fixture.md. Umyalo ongezansi uzoliguqula libe yisakhiwo sezinto ezivamile bese ulibhala kumkhombandlela wesikhashana:

node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/gongwen.docx --format ordinary --title "公文格式回归测试"

Izincazelo zamapharamitha amakhulu zimi kanje:

• --input: ifayela lokuqukethwe okokufaka.
• --output: indlela ye-DOCX ekhiqiziwe.
• --format ordinary: sebenzisa isakhiwo sombiko, sohlelo noma sesethulo esivamile.
• --title: setha isihloko sedokhumenti.

Ngemva kokuphothula ukukhiqiza, sebenzisa umqinisekisi ukuhlola isakhiwo se-DOCX nezici zesakhiwo ithuluzi elingaziqinisekisa:

node scripts/verify_gongwen_docx.mjs --input /tmp/gongwen.docx --profile ordinary

Ukuphumelela kokuqinisekisa akusho ukuthi ukubuyekeza kokugcina kungagqitshwa. Ngaphambi kokulethwa okusemthethweni, vula ifayela ku-Word noma ku-WPS kukhompuyutha okuhloswe ngayo, bese uhlola ukweqa kwemigqa, ukuhlukaniswa kwamakhasi, amafonti, okunamathiselwe nendawo yokugxiviza ngokuhambisana nezimo zangempela zokuphrinta.

Ukukhiqiza idokhumenti yokuphrinta phezu kwephepha elinekhanda elibomvu eliphrintiwe ngaphambilini

Uma into izophrintwa ephepheni eselivele linophawu lwesikhungo olubomvu nomugqa obomvu, khetha ngokusobala isakhiwo esisemthethweni kanye nemodi yephepha elinekhanda elibomvu eliphrintiwe ngaphambilini:

node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/formal.docx --format formal --letterhead preprinted --letterhead-reserve-mm 72 --org "示例单位文件" --doc-no "示例发〔2026〕1号" --title "公文格式回归测试"

--letterhead-reserve-mm 72 isho ukuthi kugcinwa amamilimitha angu-72 ekhasini lokuqala endaweni yekhanda elibomvu eselikhona ephepheni. Amamilimitha angu-72 ayinani elizenzakalelayo; ekusetshenzisweni kwangempela kufanele kulinganiswe iphepha elinekhanda elibomvu leyunithi, bese kulungiswa phakathi kobubanzi obusekelwayo obungamamilimitha angu-37 kuya kwangu-130. Le modi ngeke iphinde idwebe uphawu lwesikhungo olubomvu nomugqa obomvu ku-DOCX.

Bese usebenzisa ukucushwa kwesakhiwo esisemthethweni okufanele ukuze kuqinisekiswe:

node scripts/verify_gongwen_docx.mjs --input /tmp/formal.docx --profile formal --letterhead preprinted

Ukukhiqiza ikhanda elibomvu ledijithali eliphelele

Sebenzisa --letterhead digital kuphela uma kudingeka ngempela ukudweba zonke izici zekhanda elibomvu ku-DOCX:

node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/formal-digital.docx --format formal --letterhead digital --org "示例单位文件" --doc-no "示例发〔2026〕1号" --title "公文格式回归测试"

Ikhanda elibomvu ledijithali lizwela kakhulu endaweni yamafonti. Ikhanda elibomvu nesihloko kufanele kusebenzise i-Xiaobiaosong efakwe ngempela kukhompuyutha okuhloswe ngayo, kuyilapho umbhalo oyinhloko nokunye kudinga i-Fangsong ejwayelekile. Uma umkhiqizi ungawatholi la maf fonti, uzokhipha isexwayiso esigungwini futhi aqophe ifonti esetshenzisiwe esikhundleni sawo.

Ukwenqabela ukushintshwa kwamafonti

Ezimo zokulethwa ezingamukeli ukushintshwa kwefonti, engeza --require-standard-fonts kumkhiqizi nakumqinisekisi ngesikhathi esisodwa. Uma ikhompuyutha ingenayo i-Xiaobiaosong noma i-Fangsong ejwayelekile, umyalo uzoma futhi ubhale amafonti angekho, esikhundleni sokuqhubeka nokukhipha inguqulo esebenzisa ezinye.

node scripts/generate_gongwen_docx.mjs --input tests/fixture.md --output /tmp/strict.docx --format formal --letterhead digital --org "示例单位文件" --doc-no "示例发〔2026〕1号" --title "公文格式回归测试" --require-standard-fonts
node scripts/verify_gongwen_docx.mjs --input /tmp/strict.docx --profile formal --letterhead digital --require-standard-fonts

Ithebula lokuqukethwe, okunamathiselwe namafomethi akhethekile

Ukukhiqiza ithebula lokuqukethwe ku-Word noma ku-WPS

Umkhiqizi ubhala izihloko zamazinga amane ezitayeleni zezihloko ezijwayelekile nasemazingeni ohlaka. Ngemva kokuvula idokhumenti, ku-Word/WPS ungakhetha “References → Table of Contents” ukuze ukhiqize noma ubuyekeze ithebula lokuqukethwe elizenzakalelayo. Ukuboniswa kwesihloko sezinga lesine kudinga ukukhethwa kuzilungiselelo zethebula lokuqukethwe.

Ukwengeza okunamathiselwe

Ngokusebenzisa --attachment-file ngokuphindaphindiwe, ungakwazi ukufaka okunamathiselwe okuningi emakhasini ahlukene edokhumenti. Umkhiqizi uhlela ilebula ethi “Okunamathiselwe”, isihloko somugqa wesithathu kanye nombhalo oyinhloko, futhi agcine izinombolo zamakhasi zedokhumenti esemthethweni ziqhubeka. Isakhiwo esithile sokokufaka kufanele sibhekiswe ku-SKILL.md esenqolobaneni.

Ukukhetha igatsha lokukhiqiza elikhethekile

• Incwadi letter: ikhiqiza imigqa emibili ebomvu ephezulu nengezansi enosayizi ocacisiwe, umugqa ongezansi ube ngaphansi kwekhasi, bese ivala izinombolo zamakhasi.
• Umyalo command: isebenzisa izidingo zesakhiwo ezifaka izikhala zemigqa emibili ngaphansi kophawu lwesikhungo nangaphansi kwenombolo yomyalo.
• Amaminithi minutes: isetha amalebula athi “Abakhona”, “Abaxolisile” kanye “Nababukele” ngefonti ye-Heiti, bese isetha uhlu lwabantu ngefonti ye-Fangsong.

Lezi zinhlobo azikona ukushintshwa kwamagama nje kwesakhiwo esivamile, kodwa zingamagatsha okukhiqiza ahlukene. Ngaphambi kokukhetha, qinisekisa uhlobo lwedokhumenti.

Iziphakamiso zokusetshenziswa okuthuthukile

1. Ungaqageli uhlobo lwekhanda elibomvu usebenzisa igama lesikhungo. Izinto ezivamile kufanele zisebenzise ordinary ngokusobala, kanti ukukhishwa okusemthethweni kufanele kusebenzise formal ngokusobala.
2. Qinisekisa iphepha kuqala, bese usetha isikhala sokuphrinta phezu kwalo. Ubukhulu bangempela bephepha elinekhanda elibomvu eliphrintiwe ngaphambilini bungahluka ngokuya ngesifanekiso seyunithi, ngakho akufanele kusetshenziswe ngokuzenzakalela amamilimitha angu-72.
3. Faka futhi uqinisekise amafonti endaweni yokugcina yokuhlela. Ifonti efanayo ingaba namagama ahlukene ezinhlelweni ezahlukene, ku-Word naku-WPS; amafonti ashintshwayo nawo angashintsha usayizi, isikhala semigqa nokweqa kwemigqa.
4. Sebenzisa izitayela zezihloko ukugcina imibhalo emide. Ungalingisi amazinga ethebula lokuqukethwe ngesandla; sebenzisa izitayela ze-Heading 1 kuya ku-Heading 4 ezibhalwe umkhiqizi.
5. Hlanganisa ukuqinisekiswa okuzenzakalelayo nokuqinisekisa ngesandla. Bheka ku-references/gbt9704-audit-matrix.md naku-references/formal-checklist.md zenqolobane ukuze uhlukanise izinto ezingahlolwa ngokuzenzakalelayo nalezo okufanele ziqinisekiswe ngesandla.
6. Naka umqondo okhethekile wokuhlelwa. Ikhanda elibomvu ledijithali elisemthethweni lisebenzisa imigqa yesikhala ecacile yamaphoyinti angu-28 ukulawula ibanga phakathi kwesihloko esingaphansi komugqa obomvu nophawu lwesikhungo nenombolo yedokhumenti; emibhalweni ekhuphukela phezulu, inombolo yedokhumenti nomuntu ogunyazayo kuhlelwa emgqeni owodwa.

Ukuqhuba izivivinyo zephrojekthi

Endaweni ye-macOS noma ye-Linux, ungaqhuba izivivinyo zokubuyela emuva ezinikezwe yinquolobane:

tests/run_tests.sh

Izivivinyo zihlanganisa ukukhiqizwa kwamakhasi aphakathi nendawo nangamakhasi angalingani nalinganayo, isakhiwo sephakheji ye-DOCX kanye nokuqinisekiswa kokuguqulelwa ku-PDF, ukuze kuqinisekiswe ukuthi umkhiqizi, umqinisekisi kanye nochungechunge lwamafayela aphrintekayo kuyasebenza. Ukufakwa kuwo wonke amapulatifomu kungaqinisekiswa futhi endaweni ehlukanisiwe nge-tests/test-install.sh, kuhlolwe umkhombandlela wamakhono wasendaweni kanye nephakheji lokungenisa le-TraeWork.

Isiphetho

I-Gongwen Skill ihlanganisa imithetho yamadokhumenti asemthethweni, obekuvame ukusabalala phakathi kwemiyalelo, izifanekiso ze-Word nemibhalo yesikhashana, ibe inqubo eyodwa elawulekayo. Indlela ephephe kakhulu yokuyisebenzisa yile: qala ngokukhetha ukwakheka okujwayelekile noma okusemthethweni okufanele, bese ukhiqiza i-DOCX, usebenzise isiqinisekisi, ekugcineni wenze ukubuyekezwa ngesandla ku-Word/WPS okuhlosiwe, endaweni yamafonti nasezimweni zokuphrinta. Iphrojekthi inelayisensi ye-MIT, kodwa imibhalo ejwayelekile nezifanekiso zezikhungo zisafanele zilandele imithetho yazo yamalungelo nokuphathwa.