skill

خطط الكتابة

استخدمه عندما يكون لديك مواصفات أو متطلبات لمهمة متعددة الخطوات، قبل البدء في كتابة الكود.

obra263,646+ تثبيتموثوق

نبذة

# خطط الكتابة

## نظرة عامة

اكتب خطط تنفيذ لمهندس لم ير قاعدة الكود هذه أو هذا المواصفات. افترض أنه يكتب كودا اصطلاحيا بلغة المشروع بمجرد معرفته بالواجهة الدقيقة والاختبار الدقيق، وأنه سيتخذ خيارا معقولا حيثما تترك الخطة خيارا مفتوحا. ما لا يمكنهم معرفته هو ما قررته: أي الملفات، أي الأسماء والتوقيعات، أي القيم من المواصفات، أي الاختبارات تثبت كل مهمة. وثق هذه الأمور. امنحهم الخطة بأكملها كمهام صغيرة. 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

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

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

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

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

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

أصول ذات صلة

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

كل بدائل خطط الكتابة ←
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+

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

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

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