skill
مهارات الكتابة
يستخدم عند إنشاء مهارات جديدة، أو تعديل مهارات موجودة، أو التحقق من عمل المهارات قبل النشر.
نبذة
# مهارات الكتابة
## نظرة عامة
**مهارات الكتابة هي تطوير قائم على الاختبار (Test-Driven Development) مطبق على توثيق العمليات.**
**المهارات الشخصية توجد في دليل مهارات بيئة التشغيل الخاصة بك** (`~/.claude/skills/` على Claude Code) — انظر [codex-tools.md](../using-superpowers/references/codex-tools.md) أو [gemini-tools.md](../using-superpowers/references/gemini-tools.md) للمسار على بيئات التشغيل تلك. يتعرف Codex وCopilot CLI وGemini CLI أيضا على `~/.agents/skills/` كاسم مستعار مشترك لبيئات التشغيل.
أنت تكتب حالات اختبار (سيناريوهات ضغط مع وكلاء فرعيين)، وتشاهدها تفشل (السلوك الأساسي)، وتكتب المهارة (التوثيق)، وتشاهد الاختبارات تنجح (الوكلاء يمتثلون)، ثم تعيد الهيكلة (تغلق الثغرات).
**المبدأ الأساسي:** إذا لم تشاهد وكيلا يفشل بدون المهارة، فأنت لا تعرف ما إذا كانت المهارة تعلم الشيء الصحيح.
**الخلفية المطلوبة:** يجب أن تفهم superpowers:test-driven-development قبل استخدام هذه المهارة. تحدد تلك المهارة دورة RED-GREEN-REFACTOR الأساسية. هذه المهارة تكيف TDD مع التوثيق.
**الإرشادات الرسمية:** للحصول على أفضل ممارسات Anthropic الرسمية لتأليف المهارات، انظر references/anthropic-best-practices.md. يقدم هذا المستند أنماطا وإرشادات إضافية تكمل النهج المرتكز على TDD في هذه المهارة.
## ما هي المهارة؟
**المهارة** هي دليل مرجعي للتقنيات أو الأنماط أو الأدوات المثبتة. تساعد المهارات الوكلاء المستقبليين على إيجاد وتطبيق الأساليب الفعالة.
**المهارات هي:** تقنيات قابلة لإعادة الاستخدام، أنماط، أدوات، أدلة مرجعية
**المهارات ليست:** قصصا عن كيفية حل مشكلة مرة واحدة
## ربط TDD بالمهارات
| مفهوم TDD | إنشاء المهارة | |-------------|----------------| | **حالة الاختبار** | سيناريو ضغط مع وكيل فرعي | | **كود الإنتاج** | مستند المهارة (SKILL.md) | | **فشل الاختبار (أحمر)** | الوكيل ينتهك القاعدة بدون المهارة (الأساسي) | | **نجاح الاختبار (أخضر)** | الوكيل يمتثل بوجود المهارة | | **إعادة الهيكلة** | إغلاق الثغرات مع الحفاظ على الامتثال | | **كتابة الاختبار أولا** | تشغيل السيناريو الأساسي قبل كتابة المهارة | | **مشاهدته يفشل** | توثيق التبريرات الدقيقة التي يستخدمها الوكيل | | **الحد الأدنى من الكود** | كتابة المهارة التي تعالج تلك الانتهاكات المحددة | | **مشاهدته ينجح** | التحقق من امتثال الوكيل الآن | | **دورة إعادة الهيكلة** | إيجاد تبريرات جديدة ← سد الثغرة ← إعادة التحقق |
تتبع عملية إنشاء المهارة بأكملها دورة RED-GREEN-REFACTOR.
## متى تنشئ مهارة
**أنشئ عندما:** - لم تكن التقنية واضحة لك بشكل بديهي - سترجع إليها مرة أخرى عبر المشاريع - ينطبق النمط على نطاق واسع (وليس خاصا بمشروع معين) - سيستفيد الآخرون منها
**لا تنشئ من أجل:** - حلول لمرة واحدة - ممارسات قياسية موثقة جيدا في مكان آخر - اتفاقيات خاصة بالمشروع (ضعها في ملف التعليمات الخاص بك) - قيود ميكانيكية (إذا كان يمكن فرضها باستخدام regex/validation، قم بأتمتتها — احتفظ بالتوثيق لقرارات الحكم)
## أنواع المهارات
### تقنية طريقة ملموسة مع خطوات يجب اتباعها (الانتظار القائم على الشرط، تتبع السبب الجذري)
### نمط طريقة للتفكير في المشكلات (التسطيح باستخدام الأعلام، اختبار الثوابت)
### مرجع وثائق API، أدلة بناء الجملة، وثائق الأدوات (وثائق المكتب)
## هيكل الدليل
``` skills/ skill-name/ SKILL.md # المرجع الرئيسي (مطلوب) supporting-file.* # فقط إذا لزم الأمر ```
**مساحة اسم مسطحة** - جميع المهارات في مساحة اسم واحدة قابلة للبحث
**ملفات منفصلة ل:** 1. **مرجع ثقيل** (أكثر من 100 سطر) - وثائق API، بناء جملة شامل 2. **أدوات قابلة لإعادة الاستخدام** - نصوص برمجية، أدوات مساعدة، قوالب
**احتفظ بالداخل:** - المبادئ والمفاهيم - أنماط الكود (< 50 سطرا) - كل شيء آخر
## كتابة SKILL.md
يصف `description` الخاص بالمهارة فقط متى يجب استخدامها: شروط التشغيل و الأعراض، بدءا ب "استخدم عندما...". لا يلخص أبدا سير عمل المهارة، لأن الوكيل الذي يقرأ ملخص سير العمل يتبعه بدلا من قراءة المهارة.
عندما تكتب أو تغير الواجهة الأمامية للمهارة، أو اسمها أو وصفها، أو تحتاج إلى تقليل حجمها، اقرأ [references/discovery.md](references/discovery.md): قالب SKILL.md، إرشادات الوصف والكلمات المفتاحية، التسمية، ميزانيات الرمز، والإشارة المرجعية إلى المهارات الأخرى.
## المخططات الانسيابية
عند إضافة أو تغيير مخطط انسيابي في مهارة، اقرأ [references/flowcharts.md](references/flowcharts.md) أولا: متى يستحق المخطط الانسيابي مكانه، اتفاقيات graphviz، وكيفية عرضه.
## أمثلة الكود
**مثال ممتاز واحد أفضل من العديد من الأمثلة المتوسطة**
اختر اللغة الأكثر صلة: - تقنيات الاختبار ← TypeScript/JavaScript - تصحيح أخطاء النظام ← Shell/Python - معالجة البيانات ← Python
**مثال جيد:** - كامل وقابل للتشغيل - معلق جيدا يشرح السبب - من سيناريو حقيقي - يظهر النمط بوضوح - جاهز للتكيف (وليس قالبا عاما)
**لا تفعل:** - التنفيذ بأكثر من 5 لغات - إنشاء قوالب "املأ الفراغات" - كتابة أمثلة مصطنعة
أنت جيد في النقل - مثال واحد رائع يكفي.
## تنظيم الملفات
### مهارة مكتفية ذاتيا ``` defense-in-depth/ SKILL.md # كل شيء مضمن ``` متى: يتناسب كل المحتوى، لا حاجة لمرجع ثقيل
### مهارة مع قابلة لإعادة الاستخدام
التثبيت
شغل هذا الأمر
npx skills add obra/superpowersيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add obra/superpowers`، أو استنسخ المستودع وانسخ مجلد `skills/writing-skills` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة مهارات الكتابة؟
يستخدم عند إنشاء مهارات جديدة، أو تعديل مهارات موجودة، أو التحقق من عمل المهارات قبل النشر.
كيف أثبت مهارات الكتابة؟
شغل هذا الأمر في الطرفية:
npx skills add obra/superpowersمع أي أدوات ذكاء اصطناعي تعمل مهارات الكتابة؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور مهارات الكتابة؟
طورها obra.
هل مهارات الكتابة مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add microsoft/azure-skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى