Jinsi ya kuondoa dalili za AI katika Kijapani kwa yomiyasu: mwongozo wa kusakinisha, kuandika upya na kukagua kiotomatiki

yomiyasu ni nini

yomiyasu（よみやす）ni ujuzi wa kuboresha maandishi ya Kijapani kwa mazingira ya programu za AI. Hurekebisha miundo isiyo ya asili katika Kijapani kilichozalishwa na AI na kuandika upya rasimu kuwa makala inayosomeka kwa urahisi zaidi na yenye msongamano mkubwa wa taarifa.

Mradi huu unaweza kupakiwa katika mazingira kama Codex, Claude Code na Cursor. Hauishii kubadilisha maneno machache yanayoweza kuonekana kuwa “ya AI”; badala yake, hurekebisha uhusiano wa kiima na kiarifu, mtendaji wa tendo, mbinu za usemi na muundo wa taarifa wa sentensi.

Mradi huu uliundwa kupitia utafiti na ubunifu binafsi, na umetolewa chini ya MIT License. Maelezo ya historia ya muundo wake na mchakato wa uthibitishaji wa korpasi yanaweza kusomwa katika makala ya maelezo ya mradi.

Matatizo ya uandishi wa Kijapani inayotatua

Vidokezo vya kawaida vya mtindo mara nyingi hupiga marufuku maneno kama “解像度”, “手触り” na “泥臭い” pekee. Muundo unaweza kutumia maneno mengine yasiyo wazi, huku matatizo ya kisarufi yakibaki. Sheria nyingi za uhariri pia zinaweza kusababisha muundo kubuni maneno au kutumia misemo iliyotiwa chumvi.

yomiyasu hushughulikia hasa matatizo yafuatayo:

• Sentensi haielezi wazi ni nani anayetekeleza tendo gani.
• Matumizi ya viwakilishi visivyo wazi kama “これ”, “両者” na “片方”.
• Kufanya dhana au zana kuwa kiima chenye sifa za kibinadamu.
• Matumizi ya vitenzi vya sitiari visivyo wazi kama “壊れる”, “倒す”, “効く”, “溶かす” na “潰す”.
• Kupanga maandishi mazito, orodha na mwanzo wa kawaida huku hatua halisi na utaratibu wa kazi vikikosekana.
• Kuongeza wahusika, vipimo, kanusho au hitimisho la jumla ambazo hazipo katika maandishi asilia.

Kanuni saba kuu za ubadilishaji

1. Kurejesha muundo kamili wa SVOCM: Bainisha mtendaji kama msanidi, mtumiaji au mfumo, na badilisha viwakilishi visivyo wazi kuwa nomino mahususi.
2. Kutofautisha mtendaji na madhumuni ya usemi: Tumia ombi wazi kwa mahitaji yanayomlenga msomaji, na eleza wazi kile ambacho mfumo unaweza kutekeleza katika maelezo ya kazi.
3. Kuvunja viima visivyo hai: Badilisha maelezo yenye sifa za kibinadamu kuwa shughuli halisi zinazotekelezwa na mtu au mfumo.
4. Badilisha vitenzi vya sitiari kuwa shughuli za kiufundi: Eleza moja kwa moja hali kama kuchakata, kuruka, kusitisha, kupunguza au kutokea kwa kutolingana.
5. Kuondoa utangulizi usio wa lazima: Acha misemo ya kawaida kama “jambo muhimu ni”, na badilisha ukanushi maradufu na ulinganisho wa kimtindo kuwa sentensi fupi za kuthibitisha.
6. Kudumisha maana asilia: Hifadhi thamani za nambari na vizuizi vya kiufundi; usiongeze bila ruhusa ukweli ambao haupo katika rasimu.
7. Kudhibiti urefu wa sentensi na mapambo: Tumia wastani wa herufi 30 hadi 45 za Kijapani kwa sentensi kama mwongozo, dhibiti koma 0 hadi 2 kwa sentensi, na punguza emoji, koloni za mwisho wa sentensi, maandishi mazito na nafasi za nusu-upana zisizo za lazima.

Kusakinisha yomiyasu

Njia ya kwanza: kutumia skills add

Hii ndiyo njia ya usakinishaji inayopendekezwa na README. Baada ya kutekeleza amri ifuatayo, zana itasakinisha ujuzi katika saraka ya usanidi ya mawakala kama Claude Code:

npx skills add nanaism/yomiyasu

Njia ya pili: kwa Cursor au Codex

Unaweza kusakinisha na kusawazisha ujuzi kupitia OpenSkills:

npx openskills install nanaism/yomiyasu
npx openskills sync

Baada ya usawazishaji kukamilika, kila wakala anaweza kutumia ujuzi kupitia AGENTS.md.

Njia ya tatu: kusakinisha programu-jalizi ya Claude Code

Katika Claude Code, tekeleza amri zifuatazo kwa mpangilio:

/plugin marketplace add nanaism/yomiyasu
/plugin install yomiyasu@yomiyasu

Njia ya nne: kuweka mwenyewe

Pakua yomiyasu.skill kutoka GitHub Releases, ifungue na uiweke katika saraka ya ujuzi ya wakala unayetumia.

Ikiwa mazingira hayo hayo yana ujuzi mwingine wa kusahihisha au kurekebisha mtindo wa Kijapani, maagizo yanaweza kuingiliana. Unapotumia yomiyasu, inashauriwa kuzima kwa muda ujuzi wenye kazi zinazofanana.

Matumizi ya msingi

Baada ya kusakinisha, bandika rasimu ya Kijapani katika kiolesura cha mazungumzo cha AI au wakala wa programu, kisha toa ombi rahisi la kuboresha:

この文章を読みやすくして。
（ここに修正したい文章を貼り付け）

Usipotaja matumizi, yomiyasu itabaini kiotomatiki kikoa kinachofaa kulingana na maudhui ya ingizo. Itajaribu kuhifadhi ukweli, thamani za nambari na vizuizi vya kiufundi vya rasimu, huku ikirekebisha uhusiano wa kiima na kiarifu, usemi wa kufikirika na mapambo mengi.

Mfano uliorahisishwa

Tuseme maandishi asilia yanatumia usemi ufuatao:

DBの負荷を逃がし、失敗したメッセージを潰していきます。

Unaweza kuiomba yomiyasu ibadilishe sitiari kuwa shughuli mahususi. Kulingana na kanuni za uhariri za mradi, matokeo yanapaswa kueleza wazi jinsi mfumo unavyopunguza mzigo na jinsi ujumbe ulioshindwa unavyoshughulikiwa, kwa mfano kuongeza muda wa kusubiri wa kujaribu tena na kuhamisha data iliyozidi idadi iliyowekwa ya majaribio ya kurudia kwenye foleni ya barua zilizokufa. Matokeo halisi yataamuliwa na muktadha kamili; vipimo ambavyo havipo katika maandishi asilia haviwezi kuongezwa kwa kutegemea sentensi moja pekee.

Kubainisha mtindo kulingana na matumizi

Kwa matokeo thabiti zaidi, unaweza kubainisha kikoa katika kidokezo. Mradi hutoa aina tatu za mwongozo: tech, business na essay.

Makala ya kiufundi: tech

Hali hii inafaa kwa blogu za kiufundi na maelezo ya msimbo. Hurejesha kwanza hatua za utekelezaji na utaratibu wa ndani, huku ikipunguza orodha zisizo za lazima.

この文章を技術記事向けに読みやすくして。
（ここに修正したい文章を貼り付け）

Unaweza pia kuandika kikoa wazi:

ドメイン tech
この文章を読みやすくして。
（ここに修正したい文章を貼り付け）

Nyaraka za biashara: business

Hali hii inafaa kwa hati za vipimo, taarifa kwa vyombo vya habari na mapendekezo. Hulenga kuondoa sitiari na kubainisha masharti ya mipaka na wahusika wenye wajibu.

ドメイン business
この文章を業務仕様向けに読みやすくして。
（ここに修正したい文章を貼り付け）

Insha: essay

Hali hii inafaa kwa blogu binafsi na makala za note. Huepuka kutia chumvi uzoefu wa kawaida na kuugeuza kuwa funzo, huku ikihifadhi hisia za asili na uzoefu binafsi.

ドメイン essay
この文章をエッセイ向けに読みやすくして。
（ここに修正したい文章を貼り付け）

Kupima dalili za AI kwa kikagua kilichojumuishwa

Hazina hii inajumuisha scripts/yomiyasu_lint.py. Hati hiyo hukagua sitiari zisizo za asili, wingi wa maandishi mazito au orodha, emoji, koloni za mwisho wa sentensi na miisho ile ile ya sentensi inayojitokeza mfululizo.

Kikagua hutegemea maktaba ya kawaida ya Python pekee na hakihitaji vifurushi vya ziada vya wahusika wengine. Ili kukagua faili la Markdown, tekeleza:

python3 scripts/yomiyasu_lint.py README.md

Ripoti huonyesha alama ya jumla, idadi ya herufi, idadi ya mistari, idadi ya maandishi mazito kwa kila herufi elfu na uwiano wa orodha. Ikiwa hakuna kanuni iliyowashwa, matokeo yataonyesha PASS.

Kuwasha hali kali katika CI au Git Hook

Ukiongeza --strict, hati itarudisha msimbo wa kutoka 1 pindi tu kunapokuwa na onyo:

python3 scripts/yomiyasu_lint.py article.md --strict

Kwa hiyo, unaweza kuweka amri hii katika mchakato wa ujumuishaji endelevu au Git Hook ya kabla ya kutuma, ili kuzuia makala zenye matatizo dhahiri ya mtindo kuendelea katika hatua zinazofuata.

Mapendekezo ya matumizi ya juu

Kwanza amua maudhui, kisha boresha maandishi

Lengo la yomiyasu ni kurekebisha usemi, si kuchukua nafasi ya uthibitishaji wa ukweli. Kabla ya kuingiza maandishi, thibitisha vigezo, masharti ya mipaka na hitimisho la kiufundi katika rasimu asilia. Hii hutumia kanuni yake ya kudumisha maana na kupunguza hatari ya kupotosha ukweli wakati wa uboreshaji.

Bainisha msomaji na matumizi katika kidokezo

Pamoja na jina la kikoa, unaweza kuhifadhi muktadha unaohitajika katika rasimu, kwa mfano ikiwa makala inalenga wasanidi programu au wafanyakazi wa biashara. Mradi unaunga mkono wazi aina tatu za kikoa, kwa hiyo usidhani kuwa una aina nyingine maalum ambazo hazijatajwa katika README.

Changanya ukaguzi wa binadamu na lint

Kikagua hutumika kutambua matatizo ya kimuundo yanayofunikwa na kanuni zilizowekwa, na hakiwezi kuchukua nafasi ya uamuzi wa binadamu. Inashauriwa kwanza kumruhusu wakala kuandika upya, kisha kuendesha yomiyasu_lint.py, na hatimaye kukagua mwenyewe ukweli wa kiufundi, sauti ya maandishi na mtindo wa mwandishi asilia.

Elewa chanzo cha kanuni katika hazina

Sehemu kuu ya kuingilia ujuzi iko katika SKILL.md. Kanuni za ubadilishaji wa kisarufi, saraka ya msamiati na miundo isiyo ya asili, pamoja na kanuni za kikoa, ziko katika saraka ya references. Data ya ulinganishaji wa uthibitishaji iko katika evals/comparison_benchmark.md. Unapotaka kuchunguza au kurekebisha tabia ya ujuzi, anza kwa kusoma faili hizi.

Hitimisho

yomiyasu huhamisha mkazo wa uboreshaji wa Kijapani kutoka kupiga marufuku maneno machache maarufu hadi muundo wa kisarufi, uhusiano wa wahusika, shughuli za kiufundi na msongamano wa taarifa. Kwa kutumia vidokezo vinavyofaa vya kikoa, ukaguzi wa binadamu na zana ya lint iliyojumuishwa, unaweza kuunda mchakato wa kuhariri Kijapani kinachozalishwa na AI unaofaa kwa makala za kiufundi, nyaraka za biashara na insha.