skill
تمارين هيكلية
إنشاء هياكل دليل للتمارين مع أقسام ومسائل وحلول وشروحات تجتاز فحص linting. يستخدم عندما يرغب المستخدم في هيكلة التمارين، أو إنشاء قوالب للتمارين، أو إعداد قسم جديد في دورة تدريبية.
نبذة
# تمارين الهيكلة
أنشئ هياكل دليل التمارين التي تجتاز `pnpm ai-hero-cli internal lint`، ثم قم بالالتزام بالتغييرات باستخدام `git commit`.
## تسمية الدلائل
- **الأقسام**: `XX-section-name/` داخل `exercises/` (مثال: `01-retrieval-skill-building`) - **التمارين**: `XX.YY-exercise-name/` داخل قسم (مثال: `01.03-retrieval-with-bm25`) - رقم القسم = `XX`، رقم التمرين = `XX.YY` - الأسماء تستخدم صيغة dash-case (أحرف صغيرة، واصلات)
## أنواع التمارين
يحتاج كل تمرين إلى مجلد فرعي واحد على الأقل من هذه المجلدات:
- `problem/` - مساحة عمل الطالب مع مهام TODO - `solution/` - تطبيق مرجعي - `explainer/` - مواد مفاهيمية، بدون مهام TODO
عند إنشاء القوالب الأولية، استخدم `explainer/` افتراضيا ما لم تحدد الخطة خلاف ذلك.
## الملفات المطلوبة
يحتاج كل مجلد فرعي (`problem/`, `solution/`, `explainer/`) إلى ملف `readme.md` الذي:
- **ليس فارغا** (يجب أن يحتوي على محتوى حقيقي، حتى سطر عنوان واحد يكفي) - لا يحتوي على روابط معطلة
عند إنشاء القوالب الأولية، أنشئ ملف readme بسيطا يحتوي على عنوان ووصف:
```md # Exercise Title
Description here ```
إذا كان المجلد الفرعي يحتوي على تعليمات برمجية، فإنه يحتاج أيضا إلى ملف `main.ts` (أكثر من سطر واحد). ولكن بالنسبة للقوالب الأولية، فإن التمرين الذي يحتوي على readme فقط مقبول.
## سير العمل
1. **تحليل الخطة** - استخراج أسماء الأقسام، أسماء التمارين، وأنواع المتغيرات 2. **إنشاء الدلائل** - `mkdir -p` لكل مسار 3. **إنشاء ملفات readme الأولية** - ملف `readme.md` واحد لكل مجلد متغير مع عنوان 4. **تشغيل المدقق (lint)** - `pnpm ai-hero-cli internal lint` للتحقق من الصحة 5. **إصلاح أي أخطاء** - التكرار حتى يجتاز المدقق
## ملخص قواعد المدقق (Lint)
يقوم المدقق (`pnpm ai-hero-cli internal lint`) بالتحقق مما يلي:
- كل تمرين يحتوي على مجلدات فرعية (`problem/`, `solution/`, `explainer/`) - وجود واحد على الأقل من `problem/`, `explainer/`, أو `explainer.1/` - وجود ملف `readme.md` وغير فارغ في المجلد الفرعي الأساسي - عدم وجود ملفات `.gitkeep` - عدم وجود ملفات `speaker-notes.md` - عدم وجود روابط معطلة في ملفات readme - عدم وجود أوامر `pnpm run exercise` في ملفات readme - `main.ts` مطلوب لكل مجلد فرعي ما لم يكن التمرين يحتوي على readme فقط
## نقل/إعادة تسمية التمارين
عند إعادة ترقيم أو نقل التمارين:
1. استخدم `git mv` (وليس `mv`) لإعادة تسمية الدلائل - يحافظ على سجل Git 2. قم بتحديث البادئة الرقمية للحفاظ على الترتيب 3. أعد تشغيل المدقق بعد عمليات النقل
مثال:
```bash git mv exercises/01-retrieval/01.03-embeddings exercises/01-retrieval/01.04-embeddings ```
## مثال: إنشاء قالب أولي من خطة
بالنظر إلى خطة مثل:
``` Section 05: Memory Skill Building - 05.01 Introduction to Memory - 05.02 Short-term Memory (explainer + problem + solution) - 05.03 Long-term Memory ```
أنشئ:
```bash mkdir -p exercises/05-memory-skill-building/05.01-introduction-to-memory/explainer mkdir -p exercises/05-memory-skill-building/05.02-short-term-memory/{explainer,problem,solution} mkdir -p exercises/05-memory-skill-building/05.03-long-term-memory/explainer ```
ثم أنشئ قوالب readme الأولية:
``` exercises/05-memory-skill-building/05.01-introduction-to-memory/explainer/readme.md -> "# Introduction to Memory" exercises/05-memory-skill-building/05.02-short-term-memory/explainer/readme.md -> "# Short-term Memory" exercises/05-memory-skill-building/05.02-short-term-memory/problem/readme.md -> "# Short-term Memory" exercises/05-memory-skill-building/05.02-short-term-memory/solution/readme.md -> "# Short-term Memory" exercises/05-memory-skill-building/05.03-long-term-memory/explainer/readme.md -> "# Long-term Memory" ```
التثبيت
شغل هذا الأمر
npx skills add mattpocock/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add mattpocock/skills`، أو استنسخ المستودع وانسخ مجلد `skills/misc/scaffold-exercises` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة تمارين هيكلية؟
إنشاء هياكل دليل للتمارين مع أقسام ومسائل وحلول وشروحات تجتاز فحص linting. يستخدم عندما يرغب المستخدم في هيكلة التمارين، أو إنشاء قوالب للتمارين، أو إعداد قسم جديد في دورة تدريبية.
كيف أثبت تمارين هيكلية؟
شغل هذا الأمر في الطرفية:
npx skills add mattpocock/skillsمع أي أدوات ذكاء اصطناعي تعمل تمارين هيكلية؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور تمارين هيكلية؟
طورها mattpocock.
هل تمارين هيكلية مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add vercel-labs/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى