Monozukuri: دع الوكيل يكتب كودًا موجزًا وقابلًا للتحقق بأسلوب الحرف الياباني

لمن هذا مناسب

• مناسب للمطورين الذين يريدون أن يتبع الوكيل (agent) عند كتابة الكود سير عمل قابلًا للتحقق (لاحظ → افهم → خطط → نفّذ → تحقق → فكّر → حسّن)، بدلًا من إخراج الكود دفعة واحدة.
• مناسب لمستخدمي الوكلاء الذين يدعمون صيغة Agent Skills: كل مهارة هي مجلد <name>/SKILL.md في المستوى الأعلى، والوثائق الرسمية تذكر أنها متوافقة مع أي وكيل يدعم هذه الصيغة. يُستدعى عبر $monozukuri-core بشكل صريح.
• غير مناسب في الحالات التالية: الأدلة لا توضح إصدار بيئة التشغيل المحدد الذي يعتمد عليه، ولا تذكر قائمة عملاء تم التحقق منهم، ولا توضح مدى دعمه للمهام النصية/التوثيقية — هذه المهارة موجهة لبناء البرمجيات وصيانتها، ولا تفترض استخدامات أخرى ما لم تذكرها الأدلة.
• ما لم تذكره الوثائق الرسمية: لغات البرمجة المدعومة، وما إذا كان يتطلب وصولًا إلى الشبكة، وحدود الآثار الجانبية لكل مهارة — لا توجد أدلة على ذلك، فتحقق من ذلك بنفسك قبل الاستخدام.

أول محاولة في 3 دقائق

المتطلبات المسبقة: توفر Node.js/npx على جهازك، واستخدام وكيل يدعم صيغة Agent Skills. توفر الوثائق الرسمية طريقتين للتثبيت، ونوصي هنا بمسار رئيسي واحد فقط:

المسار الرئيسي: تثبيت المهارة الأساسية عبر skills CLI

شغّل في جذر المشروع:

npx skills add kuya-egg/Monozukuri --skill monozukuri-core

هذا يثبّت المهارة المظلة monozukuri-core فقط. إذا أردت لاحقًا تثبيت المهارات الـ 12 جميعها (المهارة المظلة + 11 مهارة متخصصة)، فإن أداة CLI الرسمية نفسها تدعم حرف البدل:

npx skills add kuya-egg/Monozukuri --skill '*'

(توفر الوثائق الرسمية أيضًا طريقة تثبيت بديلة كإضافة لـ Claude Code: بعد تنفيذ /plugin marketplace add kuya-egg/Monozukuri ثم /plugin install monozukuri@monozukuri، تُثبَّت المهارات الـ 12 جميعها وتُحمَّل ضمن نطاق الأسماء monozukuri؛ لا نعتبر هذا المسار الرئيسي الموازي في هذا المقال.)

تشغيل مهمة منخفضة المخاطر: بعد التثبيت، اكتب $monozukuri-core بشكل صريح في الوكيل، وأعطه مهمة صغيرة للقراءة/التحليل فقط، مثل «راجع صحة وإيجاز دالة صغيرة وفق سير عمل craftsmanship». سير العمل الأساسي هو: Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen.

إشارة النجاح: ينظم الوكيل إجابته وفق المراحل السبع المذكورة أعلاه بدلًا من إلقاء الكود مباشرة؛ وعندما تُربط المهارات المتخصصة بالترتيب الرسمي (مثل nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka) فهذا يعني أن جميع المهارات قد فُعِّلت. ملاحظة: هذه المهارة موجهة لمهام الكود، ولا يوجد معيار تقييم (rubric) بمسارات منفصلة للروايات/المستندات المتخصصة؛ وإذا أعطيتها مهمة كتابة نصية، فالأدلة لا تضمن وجود سير عمل مقابل لذلك. $monozukuri-core ليست سوى طريقة الاستدعاء الصريح، وما إذا كانت تقرأ الملفات وتكتبها أو تنفّذ أوامر أو تصل إلى الشبكة لم توضحه الوثائق الرسمية، فاختر في محاولتك الأولى مهمة لا تسبب آثارًا جانبية.

حالات الاستخدام

الحالة الأولى: مراجعة حرفية لدالة صغيرة السيناريو: تريد أن يفحص الوكيل بتمعّن كودًا موجودًا. طريقة البدء: اكتب $monozukuri-core في وكيل يدعم الصيغة، مع إرفاق الكود المستهدف وطلب تقييمه وفق سير العمل. سير العمل المستخدم: مراحل المهارة المظلة Observe → Understand → Plan → Craft → Verify → Reflect → Kaizen. النتيجة المتوقعة: يقدم الوكيل ملاحظاته وفهمه وخطته واقتراحات التحقق مرحلةً بمرحلة، بدلًا من إعادة الكتابة مباشرة؛ أما ما إذا كان يطلب تأكيدك قبل تعديل الملفات فلم توضحه الأدلة، لذا يُنصح بطلب التحليل فقط دون تعديل الملفات بشكل صريح.

الحالة الثانية: تطوير ميزة كاملة عبر سلسلة المهارات المتخصصة السيناريو: ثبّت جميع المهارات أولًا (--skill '*' أو عبر إضافة Claude Code)، ثم اطلب من الوكيل تطوير ميزة صغيرة. سير العمل المستخدم: تُربط المهارات المتخصصة بالترتيب الرسمي nemawashi → genchi-genbutsu → kanso → kata → poka-yoke → kodawari → andon → shukka، لتغطي السلسلة الكاملة من التجهيز إلى التحقق. النتيجة المتوقعة: يتقدم الوكيل وفق مراحل كل مهارة ويقدم مخرجات كل مرحلة؛ أما طريقة تفعيل كل مهارة متخصصة وآثارها الجانبية المحددة فلم تتوسع فيها الأدلة، فتأكد من الوكيل قبل التنفيذ الفعلي ما إذا كانت كل خطوة ستعدّل الكود.

حدود الاستخدام

• اختلاف التثبيت حسب المنصة: أداة skills CLI (npx skills add ...) هي المسار العام؛ أما منصة Claude Code فتستخدم /plugin marketplace add ثم /plugin install monozukuri@monozukuri، مما يثبّت المهارات الـ 12 جميعها مع نطاق الأسماء monozukuri. لا تخلط بين الاثنين أو تستنتج طريقة تثبيت لعملاء آخرين.
• طريقة التفعيل: تذكر الوثائق الرسمية أنها الاستدعاء الصريح $monozukuri-core؛ أما صيغة استدعاء المهارات الأخرى فلم تقدمها الأدلة.
• الآثار الجانبية ونقاط التأكيد: توجه هذه المهارة الوكيل إلى كتابة الكود، لكن الأدلة لم توضح ما إذا كانت تعدّل ملفاتك مباشرة أو تنفّذ أوامر أو تصل إلى الشبكة؛ كل ذلك غير معلوم. اجعل محاولتك الأولى مهمة تحليل للقراءة فقط، واطلب من الوكيل عرض خطته قبل أي تعديل.
• القيود الرسمية الصريحة: تثبيت monozukuri-core بمفرده يتضمن سير عمل المهارة المظلة فقط؛ وسلسلة المهارات الكاملة تتطلب تثبيت المهارات الـ 12 جميعها. لم تقدم الوثائق الرسمية لغات البرمجة المدعومة، أو البيئات اللغوية، أو متطلبات الشبكة، أو قائمة العملاء.
• معلومات أساسية غير مؤكدة: السلوك المحدد لكل مهارة متخصصة، وطرق التحديث/إلغاء التثبيت، وشروط الاستخدام خارج الترخيص — لم تغطها الأدلة، فراجع نص المستودع الأصلي قبل الاستخدام.