انتقل إلى المحتوى الرئيسي

وضع وكيل الإرشادات Task Master

تلميح

يساعدك وضع وكيل الإرشادات Task Master على إدارة مهام البرمجة المعقدة من خلال تقسيمها إلى خطوات قابلة للإدارة وتوفير مساعدة ذكية.

فهم وضع Task Master​

Task Master هو وضع وكيل ذكاء اصطناعي متقدم يقوم بما يلي:

  • تقسيم المهام المعقدة
  • إدارة سير عمل المشروع
  • توفير إرشادات خطوة بخطوة
  • الحفاظ على السياق عبر الجلسات

البدء​

تفعيل وضع Task Master​

  1. افتح لوحة الأوامر (Ctrl/Cmd + Shift + P)
  2. اكتب "Enable Task Master Agent"
  3. حدد للتفعيل

الاستخدام الأساسي​

# مثال على وصف المهمة
/task إنشاء مكون React للمصادقة

تقسيم المهام​

1. تحليل المهمة​

سيقوم الوكيل بتحليل طلبك وتقسيمه:

المهمة: إنشاء مكون مصادقة React
1. إعداد بنية المكون الأساسية
2. تنفيذ عناصر النموذج
3. إضافة التحقق من الصحة
4. الاتصال بخدمة المصادقة
5. معالجة الاستجابات والأخطاء

2. إرشادات خطوة بخطوة​

لكل خطوة، يوفر الوكيل:

  • تعليمات مفصلة
  • مقتطفات الكود
  • أفضل الممارسات
  • نصائح للتعامل مع الأخطاء

الميزات المتقدمة​

إدارة السياق​

يحافظ الوكيل على السياق عبر:

  • ملفات متعددة
  • جلسات مختلفة
  • مهام ذات صلة

مثال على تتبع السياق:

TaskContext.js
const TaskContext = {
  currentStep: 1,
  completedSteps: [],
  dependencies: {
    installed: ['react', 'auth-service'],
    required: ['validation-library']
  },
  projectState: {
    // حالة المشروع الحالية
  }
};

اقتراحات ذكية​

يقدم الوكيل اقتراحات ذكية:

AuthComponent.tsx
// اقتراح الوكيل:
interface AuthProps {
  onSuccess?: (user: User) => void;
  onError?: (error: Error) => void;
  mode?: 'login' | 'register';
}

// توفير إرشادات التنفيذ

أفضل الممارسات​

1. تعريفات واضحة للمهام​

✅ افعل:

/task إنشاء شريط تنقل متجاوب مع قائمة للجوال

❌ لا تفعل:

/task تحسين الموقع

2. التطوير التكراري​

اتبع سير العمل المقترح من الوكيل:

  1. التخطيط

    /task-plan إنشاء لوحة تحكم المستخدم

  2. التنفيذ

    /task-implement البدء بالتخطيط الأساسي

  3. المراجعة

    /task-review التحقق من وظائف المكون

3. استخدام نقاط التفتيش​

قم بتعيين نقاط تفتيش للمهام المعقدة:

/task-checkpoint حفظ التقدم الحالي
/task-restore العودة إلى آخر نقطة تفتيش

قوالب المهام​

قالب مكون React​

/task-template react-component

البنية المولدة:

interface ComponentProps {
  // تعريف الخصائص
}

const Component: React.FC<ComponentProps> = (props) => {
  // منطق المكون
  return (
    // بنية JSX
  );
};

قالب تكامل API​

/task-template api-integration

البنية المولدة:

interface ApiConfig {
  endpoint: string;
  methods: {
    get: () => Promise<any>;
    post: (data: any) => Promise<any>;
  };
}

سير العمل المتقدم​

1. مهام متعددة الملفات​

إدارة الملفات ذات الصلة:

/task-group إنشاء نظام إدارة المستخدمين

يتعامل الوكيل مع:

  • ملفات المكونات
  • الأنماط
  • الاختبارات
  • التوثيق

2. مراجعات الكود​

اقتراحات مراجعة الكود الآلية:

/task-review التحقق من تغييرات PR

يحلل الوكيل:

  • جودة الكود
  • أفضل الممارسات
  • المشكلات المحتملة
  • تأثيرات الأداء

3. إعادة الهيكلة​

اقتراحات ذكية لإعادة الهيكلة:

/task-refactor تحسين أداء المكون

استكشاف الأخطاء وإصلاحها​

المشكلات الشائعة​

  1. الوكيل لا يستجيب

    /task-reset إعادة تعيين حالة الوكيل

  2. فقدان السياق

    /task-context استعادة السياق السابق

  3. تعليمات غير واضحة

    /task-clarify ماذا تقصد بـ X؟

التكامل مع سير عمل التطوير​

1. تكامل Git​

/task-git إنشاء رسالة الالتزام

ينشئ الوكيل رسائل التزام دلالية:

feat(auth): تنفيذ مكون مصادقة المستخدم
- إضافة نموذج تسجيل الدخول
- التكامل مع خدمة المصادقة
- معالجة حالات الخطأ

2. التوثيق​

توليد التوثيق التلقائي:

/task-docs توليد توثيق المكون

الناتج:

## AuthComponent

مكون المصادقة مع الميزات التالية:
- أوضاع تسجيل الدخول/التسجيل
- التحقق من صحة النموذج
- معالجة الأخطاء
- استدعاءات النجاح

3. الاختبار​

توليد سيناريوهات الاختبار:

/task-test توليد حالات الاختبار

الاختبارات المولدة:

Auth.test.tsx
describe('AuthComponent', () => {
  it('يجب أن يتعامل مع تسجيل الدخول الناجح', () => {
    // تنفيذ الاختبار
  });

  it('يجب أن يعرض أخطاء التحقق', () => {
    // تنفيذ الاختبار
  });
});

نصائح للنجاح​

  1. كن محددًا

    • قدم متطلبات واضحة
    • حدد أهدافًا قابلة للقياس
    • حدد النتائج المتوقعة

  2. استخدم خطوات تدريجية

    • قسم المهام الكبيرة
    • تحقق من كل خطوة
    • ابنِ بشكل تكراري

  3. حافظ على السياق

    • احتفظ بالمهام ذات الصلة مجمعة
    • وثق التبعيات
    • تتبع التقدم
تلميح

تذكر أن تحفظ سياق مهمتك بانتظام باستخدام /task-save لمنع فقدان التقدم!

الموارد ذات الصلة​