دوز مباشرة للمحتوى الرئيسي
دروس فالذكاء الاصطناعي

دليل استعمال دفتر إنشاء المواقع: خلّي Codex ينشئ ويعدّل ويسلّم المواقع بموثوقية أكثر

كيشرح هاد الدليل كيفاش تثبّت وتستعمل Skill ديال «دفتر إنشاء المواقع» فـ Codex، باش تسوق صناعة المواقع وإصلاحاتها الجزئية ولا ترجيع الإصدارات بمطالب ومراجع واضحة، مع الحفاظ على الخدمة الموجودة، وتجريب الاستعمال الحقيقي، وترك مسار واضح للصيانة والنشر والرجوع للإصدار السابق.

دليل استعمال دفتر إنشاء المواقع مع Codex

شنو هو دفتر إنشاء المواقع

«دفتر إنشاء المواقع · Website Playbook» هو طريقة خدمة موجّهة لمساعدي إنشاء المواقع بالذكاء الاصطناعي، والنسخة الحالية ديالو هي 2.0.1، وتجرّبات بالأساس فـ بيئة Codex. ماشي إطار عمل للمواقع، ولا CMS ولا منصة استضافة، ولكن مجموعة ديال قواعد التنفيذ اللي كتعاون Agent يفهم المطالب مزيان، ويراجع التطبيق المرجعي، ويحافظ على المشروع الموجود، ويكمّل الاختبار والتسليم.

كيصلح للمواقع الشخصية، وملفات الأعمال، ومواقع البحث والمنظمات، ومواقع المحتوى، وكيقدر يتستعمل حتى لتطوير المواقع الموجودة وإصلاح أجزاء منها. وزيادة على مسار الخدمة الأساسي، المشروع كيوفّر حتى 16 تجربة مجهولة المصدر، وقالبين: واحد لملخص المشروع وواحد لتسليم الموقع.

القدرات الأساسية ومبادئ الخدمة

حافظ على نطاق المطالب

دفتر إنشاء المواقع كيطلب التمييز بين ثلاثة أنواع ديال المعلومات: المطالب اللي صرّح بها المستخدم بوضوح، وتفاصيل التنفيذ الضرورية لإكمال المهمة، والاقتراحات اللي ممكن تناقشوها ولكن مازال ما تأكداتش. بهاد الطريقة كينقص خطر أن الذكاء الاصطناعي يزيد بوحدو أقسام ولا وظائف ولا نصوص.

راجع التطبيق المرجعي قبل كلشي

تقدر تبدا من Awwwards باش تلقى الإلهام فالتصميم، ومن بعد تزور الموقع الأصلي وتراجع الكود المتاح والتفاعلات الحقيقية. المرجع البصري ما خاصوش يبقى غير فمستوى لقطات الشاشة، بل خاصك تتأكد كيفاش خدامة القوائم، والتمرير، والحركات، والاستجابة لمختلف الشاشات.

حافظ على النسخة المقبولة

قبل ما تعدّل موقع موجود، خاصك تحدد المشروع الصحيح وخط الأساس، وتعرف المحتوى اللي خاصو يبقى والتغييرات اللي مازال ما ترفعاتش. بلا تأكيد، ما خاصكش تغطي مباشرة على النسخة اللي سبق للمستخدم ووافق عليها.

اختبر الاستعمال الحقيقي

الاختبار ماشي غير تتأكد بأن الصفحة كتفتح. خاصك، حسب نطاق المهمة، تراجع العرض فالهاتف، واستعمال لوحة المفاتيح، وحالات القوائم، ومسار الحركات، وحالات الفشل، وتكتب بوضوح شنو اللي تجرّب فعلياً وشنو اللي مازال ما تراجعش.

خلّي طريق الصيانة واضح

ملي كتسلّم الموقع، خاصك توضّح فين كيتحدّث المحتوى، وفاش كيبانو التعديلات، وكيفاش كيتنشر الموقع، وشنو يتدار إلا وقع مشكل. بهاد الشكل كيبقى الناتج قابل للصيانة، وما كيبقاش مربوط غير بالشخص اللي نفّذو.

التحضير قبل التثبيت

قبل استعمال هاد Skill، خاص تكون عندك بيئة محلية كتدعم Skills. وكل مشروع موقع كيحتاج حتى للمحتوى المناسب، وبيئة التطوير، وصلاحيات الأدوات، وشروط الاختبار. وحيت المشروع تجرّب بالأساس فـ Codex، فالـ README ما كيضمنش التوافق الكامل مع جميع منصات الذكاء الاصطناعي.

تقدر تشوف ملاحظات إصدار v2.0.1، ولا تحمّل مباشرة حزمة Skill الكاملة ديال v2.0.1.

الطريقة الأولى: خلّي Codex يثبّت Skill

عطي الأمر التالي لـ Codex. الأمر كيطلب بالخصوص، إلا كان كاين إصدار بنفس الاسم، يتراجعو التعديلات المخصّصة قبل أي استبدال، باش ما يتغطاش على المحتوى الموجود مباشرة.

استعمل skill-installer وثبّت هاد Skill من https://github.com/7-an/website-playbook/tree/v2.0.1/skills/build-websites-v2.
إلا كان كاين إصدار بنفس الاسم، راجع التعديلات المخصّصة ديالي وحافظ عليها أولاً، وما تستبدلش المحتوى مباشرة.

من بعد ما يكمل التثبيت، من الأفضل تفتح مهمة جديدة وتستعمل Skill فيها، باش ما يأثرش سياق المحادثة السابقة على نطاق المطالب.

الطريقة الثانية: التثبيت اليدوي باستعمال ZIP

  1. حمّل حزمة Skill الكاملة ديال v2.0.1.
  2. فك الضغط على ملف ZIP اللي حمّلتي.
  3. لقى المجلد الكامل build-websites-v2.
  4. حط المجلد كامل فمجلد Skills اللي كيدعمو الجهاز ديالك.
  5. تأكد بأن جميع المجلدات الفرعية والملفات بقاو محفوظين.

ما تنسخش غير SKILL.md. هاد Skill كيعتمد حتى على README، والبيانات الوصفية ديال الاستدعاء، والمراجع، وموارد القوالب.

باش تعرف أكثر على طريقة تثبيت Skills واكتشافها، قرا الشرح الرسمي.

تعرّف على بنية ملفات المشروع

skills/build-websites-v2/
├── SKILL.md              # مدخل تنفيذ Agent
├── README.md             # التثبيت، الأمثلة، وحدود القدرات
├── agents/openai.yaml    # البيانات الوصفية ديال الاستدعاء
├── references/           # 5 مراجع حسب الحاجة، فيها سجل التجارب المجهولة
└── assets/               # قوالب ملخص المشروع وتسليم الموقع

SKILL.md هو مدخل التنفيذ ديال Agent، ولكن طريقة الخدمة كاملة كتعتمد حتى على المجلدات الأخرى. مجلد references فيه المراجع اللي كتستعمل حسب الحاجة، وassets فيه قالب ملخص المشروع وقالب تسليم الموقع.

أول استدعاء لدفتر إنشاء المواقع

الاسم العلني ديال المشروع هو «دفتر إنشاء المواقع»، ولكن اسم الاستدعاء الحالي باقي هو build-websites-v2 باش يبقى التوافق مع المستخدمين اللي سبق لهم ثبّتوه. من بعد التثبيت، تقدر تستعمل هاد الصيغة فمهمة جديدة:

استعمل $build-websites-v2، وعاونّي نصايب ولا نعدّل موقع.
الهدف: ……
المواد الموجودة ومسار المشروع: ……
المواقع المرجعية والجزء اللي بغيت نستافد منو: ……
خاصو يبقى بالضرورة: ……
نطاق هاد الدورة: التحليل / التنفيذ المحلي / النشر.

المهم فهاد البنية هو تفصل بين الهدف، ومكان المشروع، والمرجع، والحوايج اللي خاصها تبقى، ونطاق التنفيذ. ما تقولش غير «عاونّي نخليه زوين أكثر»، ولكن حدّد الصفحة بالضبط، والنتيجة اللي باغي، والمناطق اللي ممنوع تتبدّل.

مثال: إنشاء موقع لملف الأعمال

استعمل $build-websites-v2، وعاونّي نصايب موقع.
الهدف: نصايب موقع شخصي لملف الأعمال باش نعرض مشاريع البحث وأعمال التصميم.
المواد الموجودة ومسار المشروع: المشروع موجود فمجلد محلي محدد، والنصوص ومواد الأعمال مرتبة من قبل.
المواقع المرجعية والجزء اللي بغيت نستافد منو: نستافد من إيقاع الصفحة الرئيسية وتخطيط لائحة المشاريع فموقع محدد، بلا ما ننسخ الصور ولا الخطوط ولا الكود ديالو.
خاصو يبقى بالضرورة: النبذة الشخصية الحالية وأسماء المشاريع.
نطاق هاد الدورة: نبدا بالتحليل، ومن بعد التنفيذ المحلي، بلا نشر.

مثال: تعديل موقع موجود

استعمل $build-websites-v2، وعاونّي نعدّل موقع.
الهدف: نصلح مشكل فالقائمة ديال الهاتف كيخليها ما كتسدّش مزيان.
المواد الموجودة ومسار المشروع: المشروع موجود فمجلد محلي محدد.
المواقع المرجعية والجزء اللي بغيت نستافد منو: ما كاينش.
خاصو يبقى بالضرورة: محتوى الصفحة الرئيسية، ونمط التنقل فسطح المكتب، والتغييرات الحالية اللي مازال ما ترفعاتش.
نطاق هاد الدورة: التنفيذ المحلي والاختبارات المرتبطة بالمهمة، بلا نشر.

المثال الثاني حاصر المهمة فإصلاح القائمة، وما طلبش إعادة تصميم الموقع كامل. دفتر إنشاء المواقع كيدعم هاد النوع ديال المهام الجزئية، وماشي ضروري تدير مسار إنشاء موقع كامل فكل مرة.

اختار نطاق التنفيذ حسب المهمة

ملي كتستعمل Skill، تقدر توضّح واش هاد الدورة للتحليل، ولا للتنفيذ المحلي، ولا للنشر، وتقدر حتى تجمع بين أكثر من مرحلة.

  • التحليل فقط: كيتستعمل لدراسة المواقع المرجعية، وترتيب المطالب، ولا فحص المشروع الموجود، بلا تعديل مباشر للكود.
  • التنفيذ المحلي: كتعدّل الموقع من بعد التأكد من المشروع وخط الأساس، وكتدير الفحوصات المحلية المرتبطة بالمهمة.
  • النشر: كيحتاج الصلاحيات المناسبة، وخصك تأكد محتوى التسليم والمخاطر قبل النشر.
  • الإصلاح الجزئي: كتعالج غير القائمة، ولا التفاعل، ولا المشكل المحدد، وكتتفادى توسيع نطاق التعديلات.
  • ترجيع إصدار: كتحدد الإصدار ولا خط الأساس اللي بغيتي ترجع ليه، مع الحفاظ على التعديلات الأخرى الموجودة.

تقنيات متقدمة للاستعمال

وضّح «شنو بغيت تستافد منو»

ملي كتقدم موقع مرجعي، ما تبعثش غير الرابط. شرح واش باغي تستافد من التخطيط، ولا هرمية المعلومات، ولا سلوك القوائم، ولا إيقاع الحركات، ولا جزء محدد آخر. كون الكود مقروء للعموم ما كيعنيش أن الكود والخطوط والصور قابلة للنسخ كيف ما كان، وخاص احترام التراخيص المناسبة قبل إعادة الاستعمال.

كتب الحوايج المحمية فالتعليمات

إلا كان عند المشروع إصدار مقبول، حدّد بوضوح الصفحات، والنصوص، والتفاعلات، والتغييرات اللي مازال ما ترفعاتش واللي خاصها تبقى. وحتى ملي كتثبّت إصدار Skill بنفس الاسم، خاصك تتبع نفس المبدأ: راجع الفروقات أولاً، ومن بعد قرر كيفاش تحدّث، وما تغطيش على المحتوى مباشرة.

طلب سجل الاختبارات

تقدر تطلب من Agent من بعد ما يكمل يكتب لائحة بالحوايج اللي تجرّبات فعلاً، بحال واش تراجع تخطيط الهاتف، واستعمال لوحة المفاتيح، وفتح وسد القائمة، ومسار الحركة كامل، وحالة الفشل. إلا كان المتصفح، ولا الكود المرجعي، ولا الموارد الخارجية ما كيتوصلش ليها، خاصها تتسجل على أنها ما تراجعاتش، وماشي تفترض أنها دازت.

خلّي التسليم جزء من المهمة

زيد فالتعليمات ديالك مطالب التسليم، وخلي النتيجة النهائية توضّح فين كيتحدّث المحتوى، وشروط ظهور التعديلات، وخطوات النشر، وطريقة الرجوع. قالب التسليم اللي داخل المشروع يقدر يعاونك ترتب هاد المعلومات.

حلّل أولاً، ومن بعد سمح بالتنفيذ

إلا كان المرجع معقد، ولا المشروع الموجود ما مألوفش، ولا خطر التعديلات مرتفع، تقدر تحدد المهمة فالأول على أنها «التحليل فقط». من بعد ما توافق على نتيجة التحليل والنطاق، فعّل مهمة التنفيذ المحلي ولا النشر. هاد الطريقة المرحلية كتعاون تنقص من خطر التعديلات الغلط.

حدود القدرات والتنبيهات

  • هاد المشروع كيقدم طريقة خدمة وقواعد تنفيذ، وما كيعوضش محتوى الموقع، وبيئة التطوير، والصلاحيات الضرورية.
  • ما كيفرضش إطار عمل، ولا CMS، ولا منصة استضافة محددة.
  • تثبيت Skill ما كيعنيش الحصول على ترخيص نشر الموقع، حيث النشر باقي مرتبط بالصلاحيات الفعلية.
  • إلا ما أمكنش الوصول للكود المرجعي ولا للمتصفح، خاص تسجيل الحوايج اللي ما تراجعاتش.
  • المحتوى المنشور فيه غير طرق عامة، وتجارب مجهولة المصدر، وقوالب فارغة؛ وما فيهش المحادثات الأصلية، ولا مواد الزبناء، ولا الحسابات الخاصة، ولا سجلات التدقيق الداخلية.
  • المشروع تجرّب بالأساس فـ بيئة Codex، ومازال ما تكملش التحقق من التوافق مع جميع المنصات.

الخلاصة

القيمة ديال دفتر إنشاء المواقع ماشي فأنه يختار ليك التقنية، ولكن فأنه ينظّم طريقة إنشاء المواقع بالذكاء الاصطناعي: تسمع للمطالب والنطاق مزيان، وتراجع التطبيق المرجعي، وتحافظ على النسخة الموجودة، وتدير اختباراً حقيقياً مناسباً للمهمة، وفالأخير تخلّي مساراً واضحاً للصيانة والنشر والرجوع. من بعد تثبيت build-websites-v2، غالباً كيكون البدء بمهمة صغيرة وواضحة أكثر أماناً من أنك تطلب من الذكاء الاصطناعي يعاود يصايب الموقع كامل.