دليل قراءة متعدد اللغات للمهارة
writing-plansالغرض والاستخدام والمصدر
استخدم هذه الطريقة عندما يكون لديك مواصفات أو متطلبات لمهمة متعددة الخطوات، قبل البدء في كتابة التعليمات البرمجية.
تم استرجاع المصدر:
- مستودع المصدر
- obra/superpowers
- SKILL.md
skills/writing-plans/SKILL.md- نجوم المستودع
- 309,479
- آخر تحديث للمستودع
- 2026-10-30
- تصنيف القدرات
- سير عمل الوكيل
- وقت التجميع الأخير
الترخيص: MIT
مقتطفات سير العمل هي أدوات مساعدة للقراءة، وليست تعليمات تنفيذية من Codez. لم يتم تشغيل أي مهارة تابعة لجهة خارجية لإنتاج هذه الصفحة.
تُعدّ فقرات الغرض وسير العمل الواردة أدناه موادًا أساسية، مُنظّمة ومترجمة لتسهيل القراءة. وهي تختلف عن التحليل التحريري لـ Codez المُصنّف بشكل منفصل.
ما تفعله هذه المهارة
استخدم هذه الطريقة عندما يكون لديك مواصفات أو متطلبات لمهمة متعددة الخطوات، قبل البدء في كتابة التعليمات البرمجية.
طريقة الاستخدام وفق المستند الأصلي
ملخص
اكتب خطط تنفيذ لمهندس لم يطلع على قاعدة البيانات أو المواصفات هذه. افترض أنه سيكتب كودًا متوافقًا مع لغة المشروع بمجرد معرفته بالواجهة والاختبار بدقة، وأنه سيتخذ خيارًا منطقيًا حيثما تترك الخطة مجالًا للخطأ. ما لا يمكنه معرفته هو ما قررته أنت: أي الملفات، وأي الأسماء والتوقيعات، وأي القيم من المواصفات، وأي الاختبارات تثبت كل مهمة. وثّق كل ذلك. قدّم له الخطة كاملةً على شكل مهام صغيرة. التزم بمبدأ DRY (لا تكرر نفسك). لا حاجة لك. اعتمد منهجية TDD (التطوير القائم على الاختبار). قم بعمليات إيداع متكررة. أعلن في البداية: "أستخدم مهارة كتابة الخطط لإنشاء خطة التنفيذ." السياق: إذا كنت تعمل في بيئة عمل معزولة، فيجب أن تكون قد أُنشئت عبرsuperpowers:using-git-worktreesمهارة التنفيذ. احفظ الخطط في:docs/superpowers/plans/YYYY-MM-DD-.md
دقة الخطوة
كل خطوة هي إجراء واحد بنتيجة قابلة للتحقق: "اكتب الاختبار الفاشل" - خطوة، "شغّله للتأكد من فشله" - خطوة، "نفّذ الحد الأدنى من التعليمات البرمجية لنجاح الاختبار" - خطوة
مقتطف من المصدر · L43 ↗ما تحتويه الخطوة
تُعتبر الخطوة مكتملة عندما يتمكن المُنفذ من كتابة شيء واحد منطقي منها. هذا هو الشرط الأساسي: الوضوح التام، وليس الاكتمال. كل نوع من الخطوات يحمل ما يجعله واضحًا لا غير: خطوة الاختبار: اسم الاختبار وتأكيداته، كشفرة برمجية، مع القيم الدقيقة للمواصفات. خطوة الشفرة: التوقيع الدقيق (الاسم، المعاملات، نوع الإرجاع)، والملف الذي يوجد فيه، والقيم المحددة التي تثبتها المواصفات. يكتب المُنفذ جسم الشفرة. يظهر جسم الشفرة فقط للخوارزمية التي لا يحددها التوقيع والاختبارات، أو للنسخ الدقيق الذي تُصلحه المواصفات. خطوة التحقق: الأمر المراد تنفيذه والناتج الذي يدل على نجاحه.
مقتطف من المصدر · L140 ↗المتطلبات والإعداد
لم يتم اختيار أي فقرة متطلبات مختصرة من هذا الملف. هذا لا يعني أن المهارة لا تعتمد على أي ملفات أخرى. راجع تعليمات إعداد المستودع والملفات المرجعية.
الحدود وفحوصات الجودة
لم يتم تحديد أي مقطع حدود منفصل من هذا الملف. هذا لا يعني أن المهارة آمنة لكل مدخلات أو بيئة. راجع المصدر بالكامل وتحقق من صحة النتيجة بنفسك.
ابدأ بتجربة آمنة
- تحقق من المضيف المدعوم وتعليمات تثبيت المستودع. احتفظ بمجلد المهارات والبرامج النصية والأصول والوثائق المشار إليها معًا؛SKILL.mdقد يؤدي وجود شخص واحد فقط إلى إغفال بعض التبعيات.
- زوّد البرنامج ببياناتك الفعلية، والمخرجات المطلوبة، ومعايير القبول. يعتمد بناء جملة الاستدعاء والأدوات المتاحة على النظام المضيف؛ ولا يفترض هذا الموقع وجود أمر تثبيت موحد.
- جرّب سير العمل الأصلي في مشروع مؤقت أو على نسخة احتياطية. راجع العمليات التي تُغيّر الملفات أو الخدمات البعيدة أو الموارد القابلة للفوترة قبل السماح بها.
- تحقق من صحة المخرجات بمقارنتها بفحوصات جودة المصدر ومتطلباتك الخاصة. لا يُعدّ نجاح عملية التشغيل أو ارتفاع عدد النجوم في المستودع دليلاً على صحة النتيجة.
اقرأ المزيد في المصدر
المهارات ذات الصلة
الترجمة والنطاق
يختار دليل القراءة هذا مقاطع من المصدر الرئيسي المثبتSKILL.mdهذه الترجمة مساعدة. وهي ليست دليلاً كاملاً ولا تضمن التوافق المُختَبَر. يُرجى قراءة النص الأصلي والملفات المُشار إليها قبل الاستخدام.
تشير هذه المقدمة إلى النسخة المثبتة أدناه؛ ويتم عرض نشاط المستودع الحالي ووقت التجميع بشكل منفصل.
- المصدر بإصدار ثابت
- اقرأ الأصل ↗
- تم استرجاع المصدر
- معرّف نسخة Git
2ce8aa15d05bd57213e6f746f953aafb7ded7a8b- المصدر SHA-256
a6c67c1900064347c2a329990dd3c555657c51c3ec53b259a08aa01a2c26139a