skill
خطط الكتابة
استخدمه عندما يكون لديك مواصفات أو متطلبات لمهمة متعددة الخطوات، قبل البدء في كتابة الكود.
نبذة
# خطط الكتابة
## نظرة عامة
اكتب خطط تنفيذ لمهندس لم ير قاعدة الكود هذه أو هذا المواصفات. افترض أنه يكتب كودا اصطلاحيا بلغة المشروع بمجرد معرفته بالواجهة الدقيقة والاختبار الدقيق، وأنه سيتخذ خيارا معقولا حيثما تترك الخطة خيارا مفتوحا. ما لا يمكنهم معرفته هو ما قررته: أي الملفات، أي الأسماء والتوقيعات، أي القيم من المواصفات، أي الاختبارات تثبت كل مهمة. وثق هذه الأمور. امنحهم الخطة بأكملها كمهام صغيرة. DRY. YAGNI. TDD. التزامات متكررة.
**أعلن في البداية:** "أنا أستخدم مهارة كتابة الخطط لإنشاء خطة التنفيذ."
**السياق:** إذا كنت تعمل في شجرة عمل معزولة، فيجب أن تكون قد تم إنشاؤها عبر مهارة `superpowers:using-git-worktrees` في وقت التنفيذ.
**احفظ الخطط في:** `docs/superpowers/plans/YYYY-MM-DD-<feature-name>.md` - (تجاوز تفضيلات المستخدم لموقع الخطة هذا الافتراضي)
## فحص النطاق
إذا كانت المواصفات تغطي أنظمة فرعية مستقلة متعددة، فيجب أن تكون قد تم تقسيمها إلى مواصفات مشاريع فرعية أثناء العصف الذهني. إذا لم يكن الأمر كذلك، فاقترح تقسيم هذا إلى خطط منفصلة - واحدة لكل نظام فرعي. يجب أن تنتج كل خطة برنامجا عاملا وقابلا للاختبار بمفردها.
## هيكل الملفات
قبل تحديد المهام، قم بتخطيط الملفات التي سيتم إنشاؤها أو تعديلها وما هو مسؤولية كل منها. هذا هو المكان الذي يتم فيه تثبيت قرارات التفكيك.
- صمم وحدات ذات حدود واضحة وواجهات محددة جيدا. يجب أن يكون لكل ملف مسؤولية واضحة واحدة. - أنت تفكر بشكل أفضل في الكود الذي يمكنك الاحتفاظ به في السياق مرة واحدة، وتعديلاتك تكون أكثر موثوقية عندما تكون الملفات مركزة. فضل الملفات الأصغر والمركزة على الملفات الكبيرة التي تفعل الكثير. - يجب أن تعيش الملفات التي تتغير معا معا. قسم حسب المسؤولية، وليس حسب الطبقة التقنية. - في قواعد الكود الموجودة، اتبع الأنماط المعمول بها. إذا كانت قاعدة الكود تستخدم ملفات كبيرة، فلا تعيد الهيكلة من جانب واحد - ولكن إذا أصبح الملف الذي تعدله غير قابل للإدارة، فإن تضمين تقسيم في الخطة أمر معقول.
يعلم هذا الهيكل تفكيك المهام. يجب أن تنتج كل مهمة تغييرات مكتفية ذاتيا ومنطقية بشكل مستقل.
## تحديد حجم المهام
المهمة هي أصغر وحدة تحمل دورة اختبار خاصة بها وتستحق بوابة مراجع جديد. عند رسم حدود المهام: قم بطي خطوات الإعداد والتكوين والسقالات والتوثيق في المهمة التي تحتاجها مخرجاتها؛ قسم فقط حيث يمكن للمراجع أن يرفض مهمة واحدة بشكل هادف بينما يوافق على جارتها. تنتهي كل مهمة بمخرجات قابلة للاختبار بشكل مستقل.
## دقة الخطوات
**كل خطوة هي إجراء واحد بنتيجة قابلة للتحقق:** - "اكتب الاختبار الفاشل" - خطوة - "شغله للتأكد من فشله" - خطوة - "نفذ الحد الأدنى من الكود لجعل الاختبار يمر" - خطوة - "شغل الاختبارات وتأكد من نجاحها" - خطوة - "التزم" - خطوة
## رأس وثيقة الخطة
**يجب أن تبدأ كل خطة بهذا الرأس:**
```markdown # خطة تنفيذ [اسم الميزة]
> **للعاملين بالوكالة:** المهارة الفرعية المطلوبة: استخدم superpowers:subagent-driven-development (موصى به) أو superpowers:executing-plans لتنفيذ هذه الخطة مهمة بمهمة. تستخدم الخطوات صيغة مربع الاختيار (`- [ ]`) للتتبع.
**الهدف:** [جملة واحدة تصف ما يبنيه هذا]
**الهندسة المعمارية:** [2-3 جمل حول النهج]
**المكدس التقني:** [التقنيات/المكتبات الرئيسية]
**المواصفات:** [مسار إلى المواصفات/وثيقة التصميم التي تنفذها هذه الخطة — الخطة تستند إلى المواصفات، لذا المواصفات تنتقل معها؛ المنفذون يقرأون كلاهما]
## القيود العالمية
[متطلبات المواصفات على مستوى المشروع — حدود الإصدار، قيود التبعية، قواعد التسمية والنسخ، متطلبات النظام الأساسي — سطر واحد لكل منها، مع القيم الدقيقة المنسوخة حرفيا من المواصفات. تتضمن متطلبات كل مهمة ضمنيا هذا القسم.]
## تركيز المراجعة
[فئات الإدخال الخمس أو أوضاع الفشل التي تشير إليها المواصفات ولكن لا توجد اختبارات مهمة تمارسها والتي من المرجح أن تؤثر على شخص يستخدم هذا البرنامج — سطر واحد لكل منها، مع تسمية الإدخال أو الشرط والسلوك الذي يتوقعه شخص معقول، الأكثر احتمالا أولا. المواصفات هي وثيقة رؤية: إنها تقول ما يجب أن يفعله البرنامج، وليس كل ما سيلتقي به، وصمتها بشأن إدخال ليس إذنا لهذا الإدخال لكسر البرنامج. اكتب القائمة هنا، مرة واحدة، مع المواصفات أمامك. ثم، لكل سطر، أضف الاختبار الذي يربطه بالمهمة التي تملك الكود، بأسلوب خطوة تلك المهمة.]
--- ```
## هيكل المهمة
````markdown ### المهمة N: [اسم المكون]
**الملفات:** - إنشاء: `exact/path/to/file.py` - تعديل: `exact/path/to/existing.py:123-145` - اختبار: `tests/exact/path/to/test.py`
**الواجهات:** - تستهلك: [ما تستخدمه هذه المهمة من المهام السابقة — توقيعات دقيقة] - تنتج: [ما تعتمد عليه المهام اللاحقة — أسماء وظائف دقيقة، معلمات وأنواع إرجاع. يرى منفذ المهمة مهمته فقط؛ هذه الكتلة هي كيف يتعلمون الأسماء والأنواع التي تستخدمها المهام المجاورة.]
- [ ] **الخطوة 1: اكتب الاختبار الفاشل**
```python def test_specific_behavior(): result = function(input) assert result == expected ```
التثبيت
شغل هذا الأمر
npx skills add obra/superpowersيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add obra/superpowers`، أو استنسخ المستودع وانسخ مجلد `skills/writing-plans` إلى دليل مهارات 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
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى