skill

تمارين هيكلية

إنشاء هياكل دليل للتمارين مع أقسام ومسائل وحلول وشروحات تجتاز فحص linting. يستخدم عندما يرغب المستخدم في هيكلة التمارين، أو إنشاء قوالب للتمارين، أو إعداد قسم جديد في دورة تدريبية.

mattpocock392,671+ تثبيتموثوق

نبذة

# تمارين الهيكلة

أنشئ هياكل دليل التمارين التي تجتاز `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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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.

هل تمارين هيكلية مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في الإنتاجية والمكتب.

كل بدائل تمارين هيكلية ←
skillclaude_appclaude_codeclaude_api
npx skills add vercel-labs/skills
البحث عن المهارات
يساعد المستخدمين على اكتشاف وتثبيت مهارات الوكلاء عندما يطرحون أسئلة مثل "كيف أفعل X؟"، "ابحث عن مهارة ل X"، "هل توجد مهارة يمكنها..."، أو يعبرون عن ا…3,611,572+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
استخدام الوسائط
احصل على أو أنشئ أي وسائط لفيديو HyperFrames - موسيقى، مؤثرات صوتية، صور، أيقونات، شعارات، تعليق صوتي، صورة رمزية وفيديو مولد، نصوص، قصاصات، درجات ألو…1,085,267+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تحسين هيكلية قاعدة الكود
افحص قاعدة بيانات برمجية بحثا عن فرص للتحسين والتعميق، وقدمها كتقرير HTML مرئي، ثم تعمق في أي فرصة تختارها.1,040,100+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تسليم المهام
لخص المحادثة الحالية في وثيقة تسليم ليتابعها وكيل آخر.946,569+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
فرز أولي
نقل المشكلات وطلبات السحب الخارجية عبر آلة حالة لأدوار الفرز، وتصنيفها، والتحقق منها، والتدقيق فيها عند الحاجة، وكتابة ملخصات جاهزة للوكلاء.881,979+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
تعليم
علم المستخدم مهارة أو مفهوما جديدا ضمن مساحة العمل هذه.778,928+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في الإنتاجية والمكتب