Install
npx skills add feature-sliced/skillsلمن يناسب
إن كنت تعيد تنظيم مجلدات مشروع واجهة أمامية، أو تحتار مرارًا هل قطعة شيفرة تذهب إلى app أو pages أو features أو entities أو shared، فهذه المجموعة أنسب. تعلّم وكيل ترميز تطبيق Feature-Sliced Design (FSD) v2.1: الطبقات وقواعد الاستيراد وقرارات الوضع والأنماط الشائعة. متن المنهج:
https://fsd.how/
تفترض أن لديك أصلًا مستودع واجهة أمامية وتقبل إضافة المهارات إلى وكيل ترميز بـ npx. من يريد قراءة المنهج فقط ولا ينوي أن يغيّر وكيل المجلدات يبدأ بالوثائق أعلاه. الصفحة لا تعطي قائمة عملاء ولا تكتب FSD كإضافة حصرية لإطار واحد، فلا تخترع ربط إطار.
أنهِ أول محاولة في 3 دقائق
أمر التثبيت الرسمي هذا فقط:
npx skills add feature-sliced/skills
يكتب المهارات في بيئة Agent لديك. أكّد أولاً أن الجهاز فيه npx وأن هذا وكيل الترميز الذي تريد تغييره ثم نفّذ.
بعد التثبيت افحص للقراءة فقط أولاً؛ لا تعيد تنظيم المستودع فورًا. اجعل الوكيل يقابل بنية الواجهة الأمامية الحالية بـ FSD v2.1: ما يقع أصلًا في app/ وpages/ وshared/ وأي اتجاهات استيراد تبدو مريبة. إشارة النجاح: يستطيع الحديث عن الطبقات وقواعد الاستيراد ويُظهر انحياز pages-first — انظر هذه الطبقات الثلاث أولاً بدل إنشاء features/ أو entities/ فورًا. إن بدأ نقل الملفات دفعة فتوقف أولاً.
SKILL.md هو المدخل. يطلب أن يقرأ الوكيل ملفات المرجع فقط عندما تحتاجها المهمة، لإبقاء السياق الأولي صغيرًا. يجب أن يبقى السؤال الأول ملموسًا عند «افحص البنية / أين تذهب هذه الشيفرة» وتجنب تحميل كل المراجع دفعة.
حالات استخدام
الحالة 1: ابنِ أو أعد تنظيم بنية مشروع واجهة أمامية. الصفحة الرسمية تعدّ هذا النوع من المهام لحظة استخدام. يجب أن يطبّق الوكيل طبقات v2.1 والأنماط الشائعة، لكن الانحياز pages-first: ابدأ من app/ وpages/ وshared/ ولا تفتح features أو entities إلا عندما تستحق مسؤولية مشتركة مستقرة أصلًا حدًا. المقتطف لا يعطي أرشيف قالب مجلدات ولا سكربت ترحيل. لذا يجب أن تنتج أول إعادة تنظيم أولاً مذكرة مقابلة تسرد المسارات التي ستُنقل؛ تؤكد أنت ثم تغيّر الملفات.
الحالة 2: احكم موضع الشيفرة. لحظة استخدام أخرى هي تقرير هل الشيفرة تنتمي إلى app أو pages أو features أو entities أو shared. سلّم وحدة قائمة إلى الوكيل واسأل فقط «وفق FSD v2.1 أي طبقة، وهل الاستيراد يخالف». لا يكتب قواعد إصلاح تلقائي ولا جدول مقابلة مع مكتبة توجيه معيّنة. القبول يرى فقط: اقتراح طبقة وسبب استيراد؛ إن اقترح قطع feature/entity فورًا يجب أن يشرح معًا لماذا تلك المسؤولية المشتركة مستقرة أصلًا. فتح حد جديد بلا هذا الشرح خارج هذه المادة.
حدود الاستخدام
هذه المجموعة تعلّم FSD v2.1 لا نسخة شفهية من أي سنة. تفاصيل المنهج تتبع
https://fsd.how/
الصفحة لا تغطي طبقات الخلفية ولا تخوّل الوكيل إعادة التسمية على نطاق واسع بلا تأكيد.
مسار التثبيت هو npx skills add feature-sliced/skills. لا تضع مثبّتين جنبًا. المدخل دائمًا SKILL.md؛ ملفات المرجع تُقرأ عند الحاجة. لا تستطيع تسمية تلك الملفات من هذا المقتطف، فلا تتظاهر بأنك تعرف جردًا كاملاً أصلًا.
في المرة الأولى توقف عند فحص البنية وحكم الموضع. أي نقل مجلدات أو إنشاء features/entities أو تغيير أسماء استيراد مستعارة يجب أن يجعل الوكيل يسرد أولاً الملفات التي سيغيّرها والأسباب؛ تؤكد أنت ثم تتابع.