skill

مهارات الكتابة

يستخدم عند إنشاء مهارات جديدة، أو تعديل مهارات موجودة، أو التحقق من عمل المهارات قبل النشر.

obra218,436+ تثبيتموثوق

نبذة

# مهارات الكتابة

## نظرة عامة

**مهارات الكتابة هي تطوير قائم على الاختبار (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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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.

هل مهارات الكتابة مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في إنشاء المحتوى.

كل بدائل مهارات الكتابة ←
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء مع المستندات
مقابلة مكثفة لصقل خطة أو تصميم، والتي تنشئ أيضا وثائق (ADR's ومسردا) أثناء تقدمنا.1,062,214+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
إعداد مهارات مات بوكوك
قم بتهيئة هذا المستودع لمهارات الهندسة: إعداد متتبع المشكلات الخاص به، ومفردات تصنيف الفرز، وتخطيط وثائق المجال. يشغل مرة واحدة قبل الاستخدام الأول لم…967,342+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
Hyperframes الأساسية
عقد تركيب HyperFrames — أنشئ مشروعا واحدا قابلا للتقديم. استخدمه لهيكل التركيب، وسمات التوقيت `data-*`، و`class="clip"`، والمسارات، والتركيبات الفرعية…876,697+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
نمذجة النطاق
لبناء وصقل النموذج النطاقي للمشروع. يستخدم عند مناقشة مصطلحات قاعدة الكود، أو كتابة أو تعديل ملف GLOSSARY.md، أو تسجيل أو تعديل ADR.747,767+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
بوابة Azure AI
تهيئة Azure API Management كبوابة للذكاء الاصطناعي لنماذج الذكاء الاصطناعي وأدوات MCP والوكلاء. متى: التخزين المؤقت الدلالي، حد الرمز المميز، سلامة ال…605,853+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
بحث
تحقق من سؤال مقابل مصادر أولية موثوقة للغاية، وسجل النتائج كملف Markdown في المستودع. استخدم هذا عندما يريد المستخدم البحث في موضوع، أو جمع حقائق حول…576,164+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في إنشاء المحتوى