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

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

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

إدارة التوثيق على نطاق واسع تؤدي إلى تكرار المحتوى وهياكل غير متسقة. توفر هذه المهارة أدوات التحرير على مستوى الأقسام والقوالب وسير العمل للحفاظ على توثيق نظيف ومتوافق مع مبدأ DRY ومتزامن مع الكود.

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

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

الوثائق السيئة تضيع وقت الفريق وتسبب الارتباك. تفرض هذه المهارة معايير التوثيق لملفات README والتعليقات JSDoc والشروحات المضمنة في الكود遵循 مبدأ لماذا وليس ماذا. احصل على وثائق متسقة وقابلة للصيانة تشرح السياق والمنطق.

غالبًا ما يواجه المستخدمون صعوبة في إنشاء مهارات وكيل منظمة جيدًا وتتبع أفضل الممارسات. توفر هذه المهارة إرشادات خطوة بخطوة لإنشاء مهارات Claude Code والتحقق منها واختبارها ببنية مناسبة وواجهة أمامية (frontmatter) وتوثيق صحيح.

تقوم هذه المهارة بتقييم مكونات واجهة المستخدم والصفحات وفقًا لإرشادات WCAG 2.1. تحدد مشاكل إمكانية الوصول وتوفر إصلاحات محددة. استخدمها لضمان أن واجهاتك قابلة للاستخدام من قبل الأشخاص ذوي الإعاقة.

كتابة المهارات تساعدك على بناء وثائق قابلة لإعادة الاستخدام ومُختبرة يمكن لـ Claude اكتشافها وتطبيقها. تكييف هذه المهارة منهجية التطوير المُوجَّه بالاختبارات للوثائق العملية، مما يضمن أن مهاراتك تعمل فعلياً عندما يحتاجها الوكلاء.

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

تنحرف الوثائق عن واقع قاعدة الأكواد بمرور الوقت. توفر هذه المهارة عملية منهجية لمراجعة وتحديث ومزامنة جميع الوثائق مع حالة التنفيذ الحالية.

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

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

تتطلب المشاريع المعقدة توثيقًا منظمًا يبقى سهل التصفح كلما توسعت. توفر هذه المهارة قوالب وتدفقات عمل لإنشاء ويكي Markdown متوافق مع Obsidian مع الكشف التدريجي وتتبع المهام ودمج الأبحاث.

السياق يُفقد في اللحظة التي تتوقف فيها عن التفكير في المشكلة. تلتقط هذه المهارة أقصى قدر من السياق في وقت إنشاء التذكرة، بما في ذلك المتطلبات وتفاصيل التنفيذ ومواقع الملفات ومعايير القبول. والنتيجة هي تذاكر يمكن للمطورين تنفيذها فورًا دون طرح أسئلة متابعة.

إنشاء طلبات سحب بدون روابط للمشكلات يفقد فرص إغلاق المشكلات تلقائياً وتتبع العمل. تضمن هذه المهارة ربط كل طلب سحب بالمشكلات ذات الصلة واستخدام كلمات الإغلاق للحصول على إدارة سلسة للمشكلات.

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

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

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