Codex: مهارات وكيل Codex
آخر تحديث: 2026-08-31
Agent Skills تمنح Codex خبرة متخصصة في المجالات، مشابهة للشهادات المهنية للبشر.
📋 المتطلبات المسبقة: فهم العمليات الأساسية لـ Codex والإعداد
1. ما ستتعلمه
- مفاهيم Agent Skills
- المهارات المدمجة
- المهارات المخصصة
- سوق المهارات
2. ما هي Agent Skills
Agent Skills هي وحدات توسيع قدرات Codex. كل Skill يغلف معرفة متخصصة في مجال ما وسير عمل.
| البُعد | الوصف |
|---|---|
| التعريف | حزمة قدرة متخصصة في مجال |
| المحتويات | System prompt + استدعاءات أدوات + سير عمل |
| الصيغة | ملف Markdown |
| الموقع | دليل .codex/skills/ |
3. المهارات المدمجة
يتضمن Codex عدة مهارات شائعة الاستخدام:
| المهارة | القدرة | الأفضل لـ |
|---|---|---|
| code-review | مراجعة الكود | مراجعة PR |
| debug | التصحيح والإصلاح | إصلاح الأخطاء |
| test-gen | توليد الاختبارات | استكمال الاختبارات |
| doc-gen | توليد التوثيق | توثيق API |
| refactor | إعادة الهيكلة | تحسين الكود |
| security | المسح الأمني | التدقيق الأمني |
(1) استخدام المهارات المدمجة
TEXT
📖 للعرض فقط
> /skill code-review
> Review the code quality of src/auth.ts
> /skill debug
> Fix TypeError: Cannot read property 'id' of undefined
▶ مثال 1: أليس تستخدم المهارات المدمجة
TEXT
📖 للعرض فقط
# Alice uses the security Skill for a security audit
> /skill security
> Scan the entire project for security vulnerabilities
# Output:
# 🔴 [Critical] src/auth.ts:45 - Hardcoded secret key
# 🟡 [Medium] src/api.ts:23 - SQL concatenation not parameterized
# 🟢 [Low] src/utils.ts:12 - Missing input validation
4. المهارات المخصصة
(1) إنشاء ملف مهارة
MARKDOWN
<!-- .codex/skills/react-component.md -->
# React Component Generator
## Role
You are a React component development expert, proficient in TypeScript and modern React patterns.
## Rules
- Use functional components
- Use TypeScript type annotations
- Define Props with interface
- Use CSS Modules or Tailwind
- Include Storybook story
- Include unit tests
## Workflow
1. Analyze component requirements
2. Define Props interface
3. Implement component logic
4. Add styles
5. Create Storybook story
6. Write unit tests
7. Verify TypeScript compilation
## Output Format
- Component file: src/components/ComponentName.tsx
- Style file: src/components/ComponentName.module.css
- Story file: src/components/ComponentName.stories.tsx
- Test file: src/components/ComponentName.test.tsx
(2) استخدام مهارة مخصصة
TEXT
📖 للعرض فقط
> /skill react-component
> Create a DatePicker component with date range selection support
▶ مثال 2: بوب ينشئ مهارة مخصصة
MARKDOWN
<!-- .codex/skills/api-endpoint.md -->
# API Endpoint Generator
## Role
You are a FastAPI endpoint development expert.
## Rules
- Use Pydantic models for request/response validation
- All endpoints include error handling
- Use dependency injection
- Include Swagger documentation
- Write pytest tests
## Template
Reference src/api/templates/standard_endpoint.py
## Workflow
1. Define Pydantic request model
2. Define Pydantic response model
3. Implement endpoint logic
4. Add error handling
5. Write tests
6. Ensure pytest passes
5. إدارة المهارات
(1) عرض المهارات
TEXT
📖 للعرض فقط
/skills list
(2) عرض تفاصيل المهارة
TEXT
📖 للعرض فقط
/skills info code-review
(3) تفعيل/تعطيل المهارات
TEXT
📖 للعرض فقط
/skills enable react-component
/skills disable doc-gen
(4) التثبيت من السوق
TEXT
📖 للعرض فقط
/skills install graphql-api
6. أفضل ممارسات المهارات
| الممارسة | الوصف |
|---|---|
| مجال واحد | كل Skill يغطي مجالًا واحدًا فقط |
| تضمين القوالب | وفر قوالب كود كمراجع |
| سير عمل واضح | عرّف خطوات تنفيذ صريحة |
| تضمين التحقق | حدد كيفية التحقق من الإخراج |
| تحسين مستمر | حسّن المهارات بناءً على ملاحظات الاستخدام |
❓ أسئلة شائعة
س ما الفرق بين Skills و AGENTS.md؟
ج AGENTS.md هو قواعد على مستوى المشروع (تنطبق على جميع المهام)؛ Skills هي توسعات قدرات اختيارية (تُفعّل عند الحاجة).
س هل يمكنني مشاركة المهارات؟
ج نعم. التزم بملفات المهارة في المستودع وسيحصل عليها أعضاء الفريق تلقائيًا. يمكنك أيضًا النشر في سوق المهارات.
س هل تزيد المهارات من استهلاك tokens؟
ج نعم. system prompt للمهارة يشغل مساحة نافذة السياق، لكنها أكثر كفاءة من الوصف المتكرر بدون Skill.
س هل يمكن تعديل المهارات المدمجة؟
ج ليس مباشرة، لكن يمكنك إنشاء مهارة مخصصة بنفس الاسم لتجاوز الإصدار المدمج.
س هل يمكن لمهمة واحدة استخدام مهارات متعددة؟
ج غير موصى به. يجب أن تستخدم كل مهمة مهارة واحدة فقط لتجنب تعارضات التعليمات.
📖 ملخص
- Skills هي وحدات توسيع قدرات Codex
- المهارات المدمجة: code-review / debug / test-gen / doc-gen / refactor / security
- المهارات المخصصة: توضع في دليل
.codex/skills/ - تحتوي المهارات على: تعريف دور + قواعد + سير عمل + صيغة إخراج
- مجال واحد، تضمين قوالب، سير عمل واضح
📝 تمارين
- أساسي (⭐): أكمل مهمة باستخدام مهارة مدمجة، قارن النتائج بدون Skill.
- متوسط (⭐⭐): أنشئ مهارة مخصصة لسيناريوهات التطوير الشائعة لديك.
- متقدم (⭐⭐⭐): أنشئ مكتبة مهارات كاملة تغطي جميع سيناريوهات تطوير فريقك.