مهارة تجريبية من OpenAI لمساعد Codex AI للبرمجة. المصدر: https://github.com/openai/skills
View original English source---
name: create-plan
description: أنشئ خطة مختصرة. تُستخدم عندما يطلب المستخدم صراحةً خطة مرتبطة بمهمة برمجية.
metadata:
short-description: إنشاء خطة
---
# إنشاء خطة
## الهدف
حوّل طلب المستخدم إلى **خطة واحدة قابلة للتنفيذ** تُقدَّم في رسالة المساعد النهائية.
## سير العمل المختصر
طوال سير العمل، التزم بوضع القراءة فقط. لا تكتب ملفات ولا تحدّثها.
1. **راجع السياق بسرعة**
- اقرأ `README.md` وأي مستندات واضحة مثل (`docs/`, `CONTRIBUTING.md`, `ARCHITECTURE.md`).
- مرّ سريعًا على الملفات ذات العلاقة (الأكثر احتمالًا أن تتأثر).
- حدّد القيود: اللغة، الأطر المستخدمة، أوامر CI/الاختبارات، ونمط النشر.
2. **اسأل أسئلة متابعة فقط إذا كانت مانعة**
- اسأل **سؤالًا واحدًا إلى سؤالين كحد أقصى**.
- لا تسأل إلا إذا تعذّر إعداد خطة سليمة بدون الإجابة؛ وفضّل صيغة الاختيار من متعدد.
- إذا كان هناك غموض لكنه لا يمنع التخطيط، افترض افتراضًا منطقيًا وتابع.
3. **أنشئ الخطة باستخدام القالب أدناه**
- ابدأ بـ **فقرة قصيرة واحدة** توضّح الهدف والنهج العام.
- وضّح باختصار ما هو **داخل النطاق** وما هو **خارج النطاق**.
- بعدها قدّم **قائمة تحقق صغيرة** من بنود العمل (الافتراضي 6–10 بنود).
- يجب أن يكون كل بند إجراءً واضحًا، وعند الحاجة اذكر الملفات/الأوامر.
- **اجعل البنود مستقلة ومرتبة**: استكشاف → تعديلات → اختبارات → إطلاق.
- **ابدأ بفعل**: «أضف…»، «أعد هيكلة…»، «تحقّق…»، «اطرح…».
- أدرج بندًا واحدًا على الأقل لـ **الاختبارات/التحقق** وبندًا واحدًا لـ **الحالات الحدّية/المخاطر** عند الحاجة.
- إذا كانت هناك أمور غير واضحة، أضف قسمًا صغيرًا بعنوان **أسئلة مفتوحة** (بحد أقصى 3).
4. **لا تسبق الخطة بشرح تمهيدي أو ملاحظات عن العملية؛ أرسل الخطة فقط حسب القالب**
## قالب الخطة (اتبعه بالضبط)
```markdown
# الخطة
<1–3 جمل: ماذا سنفعل، ولماذا، وما النهج العام.>
## النطاق
- داخل النطاق:
- خارج النطاق:
## بنود العمل
[ ] <الخطوة 1>
[ ] <الخطوة 2>
[ ] <الخطوة 3>
[ ] <الخطوة 4>
[ ] <الخطوة 5>
[ ] <الخطوة 6>
## أسئلة مفتوحة
- <السؤال 1>
- <السؤال 2>
- <السؤال 3>
```
## إرشادات بنود قائمة التحقق
بنود قائمة التحقق الجيدة:
- تشير إلى ملفات/وحدات محتملة مثل: src/..., app/..., services/...
- تذكر تحققًا محددًا مثل: «Run npm test»، أو «أضف اختبارات وحدة لـ X»
- تتضمن طرحًا آمنًا عند الحاجة: feature flag، خطة ترحيل، ملاحظة تراجع
تجنّب:
- الخطوات العامة والغامضة مثل: «عالج الواجهة الخلفية»، «نفّذ المصادقة»
- كثرة التفاصيل الصغيرة جدًا
- كتابة مقاطع كود؛ اجعل الخطة مستقلة عن تفاصيل التنفيذ