دليل قراءة متعدد اللغات للمهارة
writing-skillsالغرض والاستخدام والمصدر
استخدم هذه الميزة عند إنشاء مهارات جديدة، أو تعديل المهارات الموجودة، أو التحقق من عمل المهارات قبل نشرها.
تم استرجاع المصدر:
- مستودع المصدر
- obra/superpowers
- SKILL.md
skills/writing-skills/SKILL.md- نجوم المستودع
- 309,479
- آخر تحديث للمستودع
- 2026-10-30
- تصنيف القدرات
- سير عمل الوكيل
- وقت التجميع الأخير
الترخيص: MIT
مقتطفات سير العمل هي أدوات مساعدة للقراءة، وليست تعليمات تنفيذية من Codez. لم يتم تشغيل أي مهارة تابعة لجهة خارجية لإنتاج هذه الصفحة.
تُعدّ فقرات الغرض وسير العمل الواردة أدناه موادًا أساسية، مُنظّمة ومترجمة لتسهيل القراءة. وهي تختلف عن التحليل التحريري لـ Codez المُصنّف بشكل منفصل.
ما تفعله هذه المهارة
استخدم هذه الميزة عند إنشاء مهارات جديدة، أو تعديل المهارات الموجودة، أو التحقق من عمل المهارات قبل نشرها.
طريقة الاستخدام وفق المستند الأصلي
سير عمل الاكتشاف
كيف يعثر العملاء المستقبليون على مهارتك: يواجه مشكلة ("الاختبارات غير موثوقة") يبحث عن المهارات (يستعرض الأوصاف، ويتصفح الفئات) يعثر على المهارة (تطابق الوصف)
مقتطف من المصدر · L388 ↗ملخص
مهارات الكتابة في تطوير البرمجيات الموجهة بالاختبارات تُطبق على توثيق العمليات. المهارات الشخصية موجودة في دليل المهارات الخاص بوقت التشغيل (~/.claude/skills/(على كود كلود) — انظرcodex-tools.mdأوgemini-tools.mdبالنسبة للمسار في بيئات التشغيل هذه. كما يتعرف كل من Codex و Copilot CLI و Gemini CLI على ذلك.~/.agents/skills/كاسم بديل عبر بيئات التشغيل المختلفة. تكتب حالات اختبار (سيناريوهات ضغط مع وكلاء فرعيين)، وتراقب فشلها (السلوك الأساسي)، وتكتب المهارة (التوثيق)، وتراقب نجاح الاختبارات (امتثال الوكلاء)، وتعيد هيكلة الكود (سد الثغرات). المبدأ الأساسي: إذا لم تراقب فشل وكيل بدون المهارة، فلن تعرف ما إذا كانت المهارة تُعلّم الشيء الصحيح.
متى يجب تطوير مهارة
لم تكن التقنية واضحة لك بشكل بديهي. ستعود إليها في مشاريع أخرى. ينطبق هذا النمط على نطاق واسع (وليس خاصًا بمشروع معين). سيستفيد منه الآخرون.
مقتطف من المصدر · L47 ↗skills/
skill-name/
SKILL.md # Main reference (required)
supporting-file.* # Only if neededالمتطلبات والإعداد
مهارات فرض الانضباط (rules/requirements)
أمثلة: تطوير البرمجيات الموجه بالاختبار، التحقق قبل الإكمال، التصميم قبل البرمجة. أسئلة أكاديمية: هل يفهمون القواعد؟
مقتطف من المصدر · L188 ↗الحدود وفحوصات الجودة
لم يتم تحديد أي مقطع حدود منفصل من هذا الملف. هذا لا يعني أن المهارة آمنة لكل مدخلات أو بيئة. راجع المصدر بالكامل وتحقق من صحة النتيجة بنفسك.
ابدأ بتجربة آمنة
- تحقق من المضيف المدعوم وتعليمات تثبيت المستودع. احتفظ بمجلد المهارات والبرامج النصية والأصول والوثائق المشار إليها معًا؛SKILL.mdقد يؤدي وجود شخص واحد فقط إلى إغفال بعض التبعيات.
- زوّد البرنامج ببياناتك الفعلية، والمخرجات المطلوبة، ومعايير القبول. يعتمد بناء جملة الاستدعاء والأدوات المتاحة على النظام المضيف؛ ولا يفترض هذا الموقع وجود أمر تثبيت موحد.
- جرّب سير العمل الأصلي في مشروع مؤقت أو على نسخة احتياطية. راجع العمليات التي تُغيّر الملفات أو الخدمات البعيدة أو الموارد القابلة للفوترة قبل السماح بها.
- تحقق من صحة المخرجات بمقارنتها بفحوصات جودة المصدر ومتطلباتك الخاصة. لا يُعدّ نجاح عملية التشغيل أو ارتفاع عدد النجوم في المستودع دليلاً على صحة النتيجة.
اقرأ المزيد في المصدر
- ملخص
- ما هي المهارة؟
- تخطيط تطوير البرمجيات القائم على الاختبار للمهارات
- متى يجب تطوير مهارة
- تقنية
- نمط
- مرجع
- بنية الدليل
- كتابةSKILL.md
- مخططات انسيابية
- أمثلة برمجية
- مهارة مكتفية ذاتيًا
- مهارة استخدام الأدوات القابلة لإعادة الاستخدام
- مهارة مع مرجعية مكثفة
- القانون الحديدي (نفس قانون تطوير البرمجيات القائم على الاختبار)
- اختبار جميع أنواع المهارات
- مهارات فرض الانضباط (rules/requirements)
- المهارات التقنية (أدلة إرشادية)
- مهارات الأنماط (النماذج الذهنية)
- مهارات مرجعية (documentation/APIs)
- المبررات الشائعة لتجاوز الاختبارات
- طابق الشكل مع الفشل
- التحصين ضد التبرير
- الأحمر والأخضر والمُحوِّل للمهارات
- الأحمر: كتابة اختبار فاشل (الأساسي)
- الأخضر: كتابة الحد الأدنى من المهارات
- المُحَوِّل: سدّ الثغرات
- صياغة الاختبار المصغر قبل السيناريوهات الكاملة
- ❌ مثال سردي
- ❌ تخفيف متعدد اللغات
المهارات ذات الصلة
الترجمة والنطاق
يختار دليل القراءة هذا مقاطع من المصدر الرئيسي المثبتSKILL.mdهذه الترجمة مساعدة. وهي ليست دليلاً كاملاً ولا تضمن التوافق المُختَبَر. يُرجى قراءة النص الأصلي والملفات المُشار إليها قبل الاستخدام.
تشير هذه المقدمة إلى النسخة المثبتة أدناه؛ ويتم عرض نشاط المستودع الحالي ووقت التجميع بشكل منفصل.
- المصدر بإصدار ثابت
- اقرأ الأصل ↗
- تم استرجاع المصدر
- معرّف نسخة Git
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- المصدر SHA-256
8cb3ac68c6d8c4bb46886b998b09af7989643cab8bd0e46ee86dd62e64546bbe