شرح agent-skills من Addy Osmani: 25 مهارة لتنظيم شغل وكلاء البرمجة

وكيل البرمجة ممكن يكتب لك كود بسرعة، لكن هل فهم المطلوب؟ وهل اختبر التغيير وراجع تأثيره قبل ما يقول «خلصت»؟ مشروع agent-skills من Addy Osmani بيحاول يعالج المشكلة دي عن طريق تحويل خطوات الشغل الهندسي إلى Skills واضحة يقدر وكيل الذكاء الاصطناعي يتبعها.

في المقال ده هتعرف فكرة المشروع، أهم المهارات اللي بيضمها، وطريقة تثبيته، وإزاي تبدأ بيه من غير تحميل تعليمات كتير على الوكيل دفعة واحدة. الشرح مبني على المستودع الرسمي ودليل تبني المهارات، وليس اختبارًا مستقلًا لنتائجها.

إيه هو مشروع agent-skills؟

هو مستودع مفتوح المصدر يضم إجراءات عمل مكتوبة لوكلاء البرمجة بالذكاء الاصطناعي. بدل توجيه عام زي «اكتب كود كويس»، الـSkill بتوضح للوكيل إمتى يستخدمها، وخطوات التنفيذ، ونقاط المراجعة، والأدلة المطلوبة قبل اعتبار المهمة منتهية.

بحسب README الحالي، الحزمة تضم 25 Skill: منها مهارة لتحديد المهارات المناسبة، و24 مهارة تغطي مراحل التطوير. وتشمل تحديد المتطلبات والتخطيط والتنفيذ والاختبار ومراجعة الكود والأمان والأداء وتجهيز الإطلاق.

وصف المشروع بأنه Production-grade بيعبر عن هدفه ومعاييره المقترحة؛ تثبيت الحزمة وحده مش ضمان إن الكود الناتج جاهز للإنتاج أو خالٍ من الأخطاء.

إيه اللي بتضيفه Skills لوكيل البرمجة؟

الفكرة الأساسية إنك تحدد طريقة الشغل قبل ما تراجع النتيجة. مثلًا: قبل بناء ميزة، يتكتب المطلوب وحدود التغيير. وأثناء التنفيذ، تتقسم المهمة لأجزاء قابلة للاختبار. وقبل الدمج، يتراجع الكود وتتقدم أدلة على التحقق.

ده ممكن يساعدك تقيم الشغل بشكل أوضح: بدل رد «الميزة شغالة»، تطلب نتيجة الاختبارات، والحالات اللي اتراجعت، والقيود اللي لسه موجودة. جودة التطبيق الفعلية تفضل معتمدة على النموذج والسياق والأدوات وطبيعة المشروع والمراجعة البشرية.

أهم المهارات الموجودة في الحزمة

• spec-driven-development: كتابة مواصفات وأهداف وحدود قبل التنفيذ.
• planning-and-task-breakdown: تقسيم المطلوب لمهام صغيرة بمعايير قبول.
• test-driven-development: توجيه سير العمل حول الاختبارات والتحقق من السلوك.
• debugging-and-error-recovery: تنظيم تشخيص الخطأ وإصلاحه ومنع تكراره.
• code-review-and-quality: مراجعة التغييرات وجودة الكود قبل الدمج.
• security-and-hardening: مراجعة التعامل مع المدخلات والهوية والأسرار والتبعيات.
• performance-optimization: قياس المشكلة قبل اقتراح تحسين الأداء.
• shipping-and-launch: مراجعة جاهزية الإطلاق وخطة الرجوع عند الحاجة.

دي أمثلة من الحزمة، مش قائمة بكل المهارات. اختار اللي يخدم المرحلة الحالية بدل تحميلها كلها في كل محادثة.

أوامر دورة التطوير

المستودع بيقدم 9 أوامر رئيسية. الجدول ده يلخص معناها، لكن طريقة إتاحتها بتختلف حسب أداة البرمجة والتكامل المستخدم:

الأمر	الغرض
/spec	تحديد المطلوب بناؤه
/plan	وضع خطة مهام صغيرة
/build	التنفيذ التدريجي
/test	التحقق بالاختبارات
/constraints	تحديد معايير الجودة
/review	مراجعة الكود
/webperf	تدقيق أداء الويب
/code-simplify	تبسيط الكود
/ship	مراجعة الإطلاق

في Claude Code تُثبّت الأوامر من خلال تكامل الإضافة. ولو اسم أمر بيتعارض مع أمر مدمج، التوثيق بيذكر استخدام اسم محدد مثل /agent-skills:review. لا تفترض إن نفس الأوامر هتظهر تلقائيًا في Codex أو Copilot أو أي مضيف تاني.

إزاي تثبّت agent-skills؟

اعرض المهارات قبل الاختيار

المسار العام المذكور في المشروع بيستخدم skills CLI:

npx skills add addyosmani/agent-skills --list

ولإضافة الحزمة استخدم:

npx skills add addyosmani/agent-skills

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

مثال لتثبيت مهارة واحدة

npx skills add addyosmani/agent-skills --skill code-review-and-quality

هنا فيه تفصيلة مهمة: التوثيق بيذكر إن التثبيت المنفرد ينسخ مجلد المهارة، لكنه لا ينسخ مجلد references المشترك على مستوى المستودع. بالتالي بعض مسارات قوائم المراجعة الإضافية قد لا تكون متاحة. راجع التفصيلة المتتبعة في issue 361، واستخدم تكامل المستودع الكامل أو وفّر المراجع المطلوبة حسب الدليل.

التثبيت كإضافة في Claude Code

/plugin marketplace add addyosmani/agent-skills
/plugin install agent-skills@addy-agent-skills

بالنسبة للأدوات الأخرى، اتبع دليلها داخل المستودع. تنزيل ملفات المهارات ودعم أوامر الإضافة واكتشافها تلقائيًا أمور مختلفة، ولازم تتأكد من اللي يدعمه المضيف عندك.

تبدأ إزاي في مشروع جديد أو مشروع قائم؟

دليل التبني بيفرق بين حالتين. في المشروع الجديد، تقدر تبدأ بتحديد المواصفات ثم التخطيط والتنفيذ والتحقق والمراجعة. في المشروع القائم، الأفضل فهم السياق والسلوك الحالي قبل تكليف الوكيل بتغييرات واسعة.

لو عندك نظام شغال، جرّب مراجعة تغيير محدود أولًا، ووفّر أوامر البناء والاختبار وحدود الملفات اللي ينفع تتعدل. وقبل تغيير جزء قديم غير مختبر، ثبّت سلوكه الحالي باختبارات مناسبة. كده تبقى عارف إذا كان التغيير أصلح المشكلة أو غيّر سلوكًا يعتمد عليه باقي النظام.

مثال عملي: مراجعة ميزة قبل دمجها

كمثال مقترح، لو وكيل البرمجة أضاف نموذج تسجيل، اطلب مراجعة التغيير باستخدام code-review-and-quality. وضّح السلوك المطلوب، وطريقة تشغيل الاختبارات، واطلب فصل المشاكل المؤثرة عن التحسينات الاختيارية.

ممكن يكون طلبك: «راجع تغيير نموذج التسجيل، وتحقق من المدخلات وحالات الخطأ والاختبارات الموجودة. اذكر كل مشكلة مع الملف وسبب تأثيرها، ولا تعتبر المهمة مكتملة من غير توضيح ما تم التحقق منه وما لم يتم اختباره».

المثال ده طريقة لاستخدام الفكرة، وليس نتيجة تجربة للحزمة هنا. ولو هدفك تطوير واجهات متسقة بمساعدة الوكلاء، اقرأ كمان شرح Astryx من Meta.

أسئلة شائعة

هل الحزمة بتغيّر النموذج نفسه؟

هي بتضيف إجراءات وتعليمات عمل للمضيف الذي يستخدمها، ولا تمثل تدريبًا جديدًا لأوزان النموذج أو ضمانًا لقدرات إضافية خارج أدواته المتاحة.

هل أقدر أستخدمها مع أكثر من أداة؟

المشروع يوضح تكاملات لعدة أدوات، منها Claude Code وCursor وCodex وCopilot. طريقة التثبيت والاستدعاء بتختلف، فارجع للدليل الخاص بأداتك.

هل المشروع مجاني؟

المستودع بترخيص MIT. تكلفة أداة البرمجة أو مزود النموذج تفضل منفصلة حسب حسابك وخطتك.

المصادر الرسمية

راجع مستودع agent-skills للاطلاع على المهارات والتكاملات، ودليل التبني للمشاريع الجديدة والقائمة لاختيار نقطة البداية. ولخطوات الإعداد التفصيلية استخدم دليل Getting Started.