شنو هو yomiyasu
yomiyasu（よみやす） هي مهارة لتصحيح وصقل اليابانية موجهة لبيئات البرمجة بالذكاء الاصطناعي. كتستعمل لتصحيح التعابير اللي ماشي طبيعية فاليابانية المولدة بالذكاء الاصطناعي، وكتعاود صياغة النص الأصلي باش يولي ساهل فالقراءة وأكثر كثافة من ناحية المعلومات.
يمكن تحميل هاد المشروع فبيئات بحال Codex وClaude Code وCursor. ماشي غير كيعوّض شوية ديال الكلمات اللي كتبان بسهولة “بحال ديال الذكاء الاصطناعي”، بل كيدير التعديلات انطلاقاً من العلاقة بين الفاعل والفعل فالجملة، والجهة اللي كتقوم بالفعل، وطريقة استعمال الأساليب البلاغية، وبنية المعلومات.
هاد المشروع تدار ضمن بحث وإبداع شخصي، ومنشور برخصة MIT License. يمكن الاطلاع على المقالة الشارحة للمشروع باش تعرف الخلفية ديالو وطريقة التحقق باستعمال البيانات اللغوية.
شنو هي مشاكل الكتابة اليابانية اللي كيحلها
التوجيهات العادية ديال الأسلوب غالباً كتكتفي بمنع كلمات بحال “解像度” و“手触り” و“泥臭い”. يقدر النموذج يستعمل كلمات غامضة أخرى، ولكن المشاكل النحوية الأصلية كتبقى بلا حل. وكثرة قواعد التحرير تقدر حتى هي تخلي النموذج يخلق كلمات ما عندهاش أساس أو يستعمل تعابير مبالغ فيها.
yomiyasu كيركز بالأساس على هاد المشاكل:
- الجملة ما كتوضحش شكون دار شنو.
- استعمال كلمات إشارية ما واضحاش المعنى ديالها بحال “これ” و“両者” و“片方”.
- خلي المفاهيم أو الأدوات تقوم بدور الفاعل بشكل تشخيصي.
- استعمال أفعال مجازية غامضة بحال “壊れる” و“倒す” و“効く” و“溶かす” و“潰す”.
- تكديس الخط العريض واللوائح والافتتاحيات الجاهزة، مع حذف الخطوات الفعلية وطريقة الخدمة.
- إضافة أشخاص أو مواصفات أو إخلاءات مسؤولية أو خلاصات عامة ما كانتش فالنص الأصلي.
سبعة مبادئ أساسية للتحويل
- إرجاع البنية الكاملة SVOCM: توضيح الجهة اللي كتقوم بالفعل، بحال المطوّر أو المستعمل أو النظام، وتعويض الضمائر الغامضة بأسماء محددة.
- التمييز بين الفاعل وهدف التعبير: الطلبات الموجهة للقارئ تكتب كطلبات واضحة، وشرح الوظائف يوضح شنو يقدر النظام يدير.
- تفكيك الفاعل غير الحي: تحويل الوصف التشخيصي إلى عملية موضوعية كيديرها شخص أو نظام.
- تعويض الأفعال المجازية بعمليات تقنية: وصف حالات بحال المعالجة أو التجاوز أو الإنهاء أو التقليل أو وقوع عدم التوافق بشكل مباشر.
- حذف التمهيد الزائد: حذف العبارات الجاهزة بحال “المهم هو”، وتحويل النفي المزدوج والمقابلات البلاغية إلى جمل مثبتة ومختصرة.
- الحفاظ على المعنى الأصلي: الاحتفاظ بالأرقام والقيود التقنية، وعدم إضافة حقائق ما كانتش فالنص الأصلي من تلقاء النفس.
- التحكم فطول الجمل والزخرفة: اعتماد متوسط من 30 حتى 45 حرف ياباني فكل جملة كمرجع، والتحكم فعدد الفواصل بين 0 و2 فكل جملة، مع التقليل من الرموز التعبيرية والنقطتين فآخر الجملة والخط العريض والمسافات النصفية غير الضرورية.
تثبيت yomiyasu
الطريقة الأولى: باستعمال skills add
هاد هي طريقة التثبيت اللي كيوصي بها README. من بعد تنفيذ الأمر التالي، الأداة غادي تثبّت المهارة فمجلد الإعدادات ديال الوكلاء بحال Claude Code:
npx skills add nanaism/yomiyasuالطريقة الثانية: للاستعمال مع Cursor أو Codex
يمكن تثبيت المهارة ومزامنتها باستعمال OpenSkills:
npx openskills install nanaism/yomiyasu
npx openskills syncمن بعد ما تكمل المزامنة، يقدرو الوكلاء يستعملو هاد المهارة عبر AGENTS.md.
الطريقة الثالثة: تثبيت إضافة Claude Code
فـ Claude Code نفّذ الأوامر التالية بالترتيب:
/plugin marketplace add nanaism/yomiyasu
/plugin install yomiyasu@yomiyasuالطريقة الرابعة: الوضع اليدوي
حمّل yomiyasu.skill من GitHub Releases، فك الضغط عليه، وحطّو فمجلد المهارات ديال الوكيل اللي كتستعمل.
إلا كانت البيئة نفسها مفعّل فيها مهارات أخرى للتدقيق فاليابانية أو تعديل الأسلوب، يقدرو التعليمات يتعارضو. ملي تستعمل yomiyasu، من الأحسن توقف مؤقتاً المهارات اللي عندها وظائف قريبة.
الاستعمال الأساسي
من بعد التثبيت، لصّق المسودة اليابانية فواجهة الدردشة ديال الذكاء الاصطناعي أو فوكيل البرمجة، وعطيه طلب بسيط باش يصقلها:
この文章を読みやすくして。
（ここに修正したい文章を貼り付け）إلا ما حددتيش الاستعمال، yomiyasu غادي يحاول يحدد المجال المناسب انطلاقاً من المحتوى المدخل. وغادي يحافظ قدر الإمكان على الحقائق والأرقام والقيود التقنية ديال النص الأصلي، مع تصحيح العلاقة بين الفاعل والفعل، والتعابير المجردة، والزخرفة الزائدة.
مثال مبسط
نفترضو أن النص الأصلي فيه التعبير التالي:
DBの負荷を逃がし、失敗したメッセージを潰していきます。يمكن تطلب من yomiyasu يعوّض المجاز بعمليات محددة. حسب مبادئ التحرير اللي كيعتمد عليها المشروع، خاص إعادة الصياغة توضح كيفاش النظام كيخفّض الحمل، وكيفاش كيتعامل مع الرسائل الفاشلة، مثلاً بتمديد مدة الانتظار بين المحاولات، ونقل البيانات اللي فاتت العدد المحدد ديال المحاولات إلى طابور الرسائل الميتة. النتيجة الفعلية غادي تعتمد على السياق الكامل، وما يمكنش نضيفو من جملة وحدة مواصفات ما كانتش فالنص الأصلي.
تحديد الأسلوب حسب الاستعمال
إلا بغيتي نتائج أكثر استقراراً، حدّد المجال فالتوجيه. المشروع كيوفر ثلاثة أنواع ديال الإرشادات: tech وbusiness وessay.
المقالات التقنية: tech
هاد النمط مناسب للمدونات التقنية وشرح الكود. كيعطي الأولوية لإرجاع خطوات التنفيذ وآلية العمل، وكيحد من اللوائح اللي ما عندهاش ضرورة.
この文章を技術記事向けに読みやすくして。
（ここに修正したい文章を貼り付け）يمكن حتى تحدد المجال بشكل صريح:
ドメイン tech
この文章を読みやすくして。
（ここに修正したい文章を貼り付け）وثائق العمل: business
هاد النمط مناسب لوثائق المواصفات والبيانات الصحفية ووثائق الاقتراح. كيركز على حذف المجاز وتوضيح الشروط والحدود والجهة المسؤولة.
ドメイン business
この文章を業務仕様向けに読みやすくして。
（ここに修正したい文章を貼り付け）المقالات الشخصية: essay
هاد النمط مناسب للمدونات الشخصية ومقالات note. كيتفادى تحويل التجارب العادية إلى دروس مبالغ فيها، وكيحافظ فالمقابل على الإحساس الطبيعي والتجربة الشخصية.
ドメイン essay
この文章をエッセイ向けに読みやすくして。
（ここに修正したい文章を貼り付け）قياس آثار الذكاء الاصطناعي باستعمال الفاحص المدمج
المستودع فيه scripts/yomiyasu_lint.py. هاد السكريبت كيقدر يفحص المجازات غير الطبيعية، وكثرة الخط العريض أو اللوائح، والرموز التعبيرية، والنقطتين فآخر الجمل، وتكرار نفس نهاية الجملة بشكل متتالٍ.
الفاحص كيعتمد غير على المكتبة القياسية ديال Python، وما كيحتاجش تثبيت حزم إضافية من جهات أخرى. لفحص ملف Markdown، نفّذ:
python3 scripts/yomiyasu_lint.py README.mdالتقرير كيعرض النقطة الإجمالية، وعدد الحروف، وعدد الأسطر، وعدد استعمالات الخط العريض لكل ألف كلمة، ونسبة اللوائح، ومعلومات أخرى. إلا ما تفعّل حتى قاعدة، غادي تبان النتيجة PASS.
تفعيل الوضع الصارم فـ CI أو Git Hook
منين كتزيد --strict، السكريبت كيرجع رمز الخروج 1 غير إلا كان شي تحذير:
python3 scripts/yomiyasu_lint.py article.md --strictبالتالي، تقدر تحط هاد الأمر فمسار التكامل المستمر أو فـ Git Hook اللي كيتنفذ قبل الإرسال، باش تمنع المقالات اللي فيها مشاكل واضحة فالأسلوب من المرور للمرحلة الموالية.
اقتراحات للاستعمال المتقدم
حدد المحتوى أولاً، ومن بعد صقل التعبير
الهدف ديال yomiyasu هو تعديل التعبير، ماشي تعويض التحقق من الحقائق. قبل الإدخال، خاصك تتأكد من المعاملات والشروط والنتائج التقنية اللي فالنص الأصلي. بهاد الطريقة كتستافد من مبدأ الحفاظ على المعنى، وكتنقص مخاطر ظهور أخطاء فالحقائق أثناء الصقل.
وضح القارئ والاستعمال فالتوجيه
بالإضافة لاسم المجال، تقدر تخلي فالنص الأصلي السياق الضروري، بحال واش المقال موجه للمطورين ولا لموظفي الأعمال. المشروع كيدعم بشكل صريح ثلاثة أنماط ديال المجالات، لذلك ما تفترضش أن فيه أنماط متخصصة أخرى ما مذكوراش فـ README.
جمع بين المراجعة البشرية وlint
الفاحص مخصص لاكتشاف المشاكل الشكلية اللي كتغطيها القواعد المحددة مسبقاً، وما كيقدرش يعوّض الحكم البشري. من الأفضل تخلي الوكيل يعاود الصياغة أولاً، ومن بعد تشغّل yomiyasu_lint.py، وفالأخير تراجع يدوياً الحقائق التقنية والنبرة وأسلوب الكاتب الأصلي.
فهم مصدر القواعد فالمستودع
المدخل الرئيسي للمهارة موجود فـ SKILL.md. مبادئ التحويل النحوي، وفهرس الكلمات والبنيات غير الطبيعية، وقواعد المجالات موجودة كلّها فمجلد references. وبيانات المقارنة والتحقق موجودة فـ evals/comparison_benchmark.md. إلا بغيتي تدرس سلوك المهارة أو تعدلو، تقدر تبدا القراءة من هاد الملفات.
الخلاصة
yomiyasu كينقل التركيز فصقل اليابانية من منع كلمات رائجة معينة، إلى بنية الجمل والعلاقة بين الفاعل والفعل والعمليات التقنية وكثافة المعلومات. باستعمال توجيهات المجال المناسبة، والمراجعة البشرية، وأداة lint المدمجة، تقدر تبني مساراً لتحرير اليابانية المولدة بالذكاء الاصطناعي، مناسباً للمقالات التقنية ووثائق العمل والمقالات الشخصية.