Skills: التثبيت وإعداد البيئة
آخر تحديث: 2026-08-31
اصقل أدواتك قبل أن تبدأ. أعدّ بيئة تطوير المهارات في 5 دقائق واترك مساعد الذكاء الاصطناعي يتعلم مهارات جديدة.
1. متطلبات البيئة
| العنصر | الحد الأدنى | الموصى به |
|---|---|---|
| مساعد البرمجة بالذكاء الاصطناعي | Claude Code / OpenCode | أحدث إصدار |
| Node.js | 18+ | 20+ |
| Git | 2.30+ | أحدث إصدار |
| نظام التشغيل | Windows / macOS / Linux | أي منها |
| المحرر | VS Code / Cursor | أحدث إصدار |
تحقق من بيئتك:
BASH
node --version # v20.11.0
git --version # git version 2.43.0
claude --version # Claude Code v1.0+ (إذا كنت تستخدمه)
2. أدلة المهارات حسب المنصة
(1) Claude Code
BASH
# مهارات على مستوى المشروع (موصى بها، تتبع إدارة إصدارات المشروع)
mkdir -p .claude/skills
# مهارات على مستوى المستخدم (مشتركة عبر جميع المشاريع)
mkdir -p ~/.claude/skills
(2) OpenCode
BASH
# مهارات على مستوى المشروع
mkdir -p skills
# مهارات على مستوى المستخدم
mkdir -p ~/.config/opencode/skills
(3) Cursor Rules
BASH
# قواعد على مستوى المشروع
mkdir -p .cursor/rules
3. معايير هيكل الدليل
مشروع مهارات جدول البناء:
TEXT
📖 للعرض فقط
project/
├── .claude/
│ ├── skills/ # دليل مهارات Claude Code
│ │ ├── code-review.md # مهارة مراجعة الكود
│ │ ├── deploy.md # مهارة النشر
│ │ └── test-gen.md # مهارة توليد الاختبارات
│ └── settings.json # إعدادات Claude Code
├── skills/ # دليل مهارات OpenCode
│ ├── code-review.md
│ └── deploy.md
├── .cursor/
│ └── rules/ # دليل قواعد Cursor
│ └── review.mdc
└── .gitignore
(1) تنسيق المهارة بملف واحد
كل مهارة هي ملف Markdown:
MARKDOWN
---
name: code-review
description: "مهارة مراجعة الكود، اكتشاف تلقائي لمشاكل الأمان وعنق زجاجة الأداء"
triggers:
- keyword: "review"
- file_pattern: "**/*.{py,ts,js}"
tools:
- Read
- Grep
- Glob
---
# مهارة مراجعة الكود
عندما يطلب المستخدم مراجعة الكود، اتبع هذه العملية:
1. اقرأ الملفات المستهدفة
2. تحقق من مشاكل الأمان
3. تحقق من عنق زجاجة الأداء
4. أنشئ تقرير المراجعة
(2) تنسيق المهارة متعددة الملفات
المهارات المعقدة يمكن تقسيمها إلى ملفات متعددة:
TEXT
📖 للعرض فقط
.claude/skills/code-review/
├── SKILL.md # ملف المهارة الرئيسي
├── prompts/ # قوالب القوالب
│ ├── security.md
│ └── performance.md
├── examples/ # أمثلة
│ └── sample-review.md
└── config.yaml # إعدادات إضافية
4. تكوين تفعيل المهارة
(1) التحميل التلقائي
المهارات الموضوعة في الدليل المناسب تكون متاحة تلقائيًا بدون تكوين إضافي.
(2) المرجع اليدوي
على بعض المنصات، يمكنك الإشارة صراحةً إلى مهارة:
JSON
// .claude/settings.json
{
"skills": [
"code-review",
"deploy",
"test-gen"
]
}
(3) التفعيل الشرطي
YAML
# تفعيل فقط على فروع محددة
triggers:
- condition: "git_branch == 'main'"
- condition: "file_changed matches '**/api/**'"
5. تحقق من بيئتك
أنشئ مهارة اختبار للتحقق من إعداد بيئتك بشكل صحيح:
MARKDOWN
---
name: hello-skill
description: "مهارة اختبار، تحقق من إعداد البيئة"
triggers:
- keyword: "hello-skill"
---
# مهارة الترحيب
عندما يقول المستخدم "hello-skill"، استجب:
"تم تكوين بيئة المهارات بنجاح! المشروع الحالي: {project_name}، الأدوات المتاحة: Read، Write، Bash"
بعد أن أنشأت Alice الدليل ومهارة الاختبار باتباع الخطوات أعلاه، كتبت "hello-skill" ورأت استجابة فورًا. قال Bob: "تشغيل في 5 دقائق — أبسط بكثير من إعداد CI/CD."
❓ الأسئلة الشائعة
س ما الفرق بين المهارات على مستوى المشروع وعلى مستوى المستخدم؟
ج مهارات مستوى المشروع توضع في دليل
.claude/skills/ الخاص بالمشروع، وتتبع إدارة Git للمشروع، وتُشارك مع الفريق؛ مهارات مستوى المستخدم توضع في ~/.claude/skills/، متاحة عبر جميع المشاريع لكن غير مُدارة بالإصدارات.س هل يمكن استخدام مهارات المنصات المختلفة بشكل متبادل؟
ج أجزاء القالب الأساسية قابلة للنقل، لكن صياغة المحفزات وروابط الأدوات تختلف حسب المنصة. نوصي باستخدام Markdown كتنسيق أساسي وعزل التكوين الخاص بالمنصة بتعليقات شرطية.
س هل هناك اصطلاحات لتسمية ملفات المهارات؟
ج نوصي بتسمية kebab-case (مثلاً
code-review.md)، مع إبقاء اسم الملف متسقًا مع حقل name لتسهيل الإدارة.📖 ملخص
- لكل منصة مواقع أدلة مهارات مختلفة، لكن الهيكل الأساسي هو نفسه
- المهارات بملف واحد تستخدم Markdown + YAML frontmatter
- مهارات مستوى المشروع تتبع إدارة إصدارات Git؛ مهارات مستوى المستخدم متاحة عالميًا
- استخدم hello-skill لاختبار ما إذا كان إعداد البيئة ناجحًا
📝 تمارين
- أساسي (⭐): أنشئ دليل مهارات في مساعد البرمجة بالذكاء الاصطناعي وأنشئ اختبار hello-skill.
- متوسط (⭐⭐): صمّم هيكل دليل مهارات لمشروعك مع تخطيط 3 ملفات مهارات على الأقل.
- متقدم (⭐⭐⭐): اكتب نصًا برمجيًا يكتشف تلقائيًا منصة الذكاء الاصطناعي المستخدمة في المشروع الحالي وينشئ دليل المهارات وملفات الأمثلة المقابلة.