البرمجة بأسلوب فايب مع Blockstudio
صاغ Andrej Karpathy مصطلح «البرمجة بأسلوب الفايب» في فبراير 2025 لوصف سير عمل تشرح فيه للذكاء الاصطناعي ما تريده فيكتب الكود. وبعد عام، نضجت الممارسة إلى ما يسميه الآن «الهندسة الوكيلة»: إذ ينسق المطورون عمل وكلاء الذكاء الاصطناعي بدلًا من كتابة الكود سطرًا بسطر.
صُمم Blockstudio لهذا الغرض. فبنيته القائمة على الملفات، وغياب أدوات البناء، وهيكل مشروعه المتوقع، تجعله من أفضل البيئات لتطوير WordPress بمساعدة الذكاء الاصطناعي.
يستعرض هذا الدليل أنماطًا عملية لاستخدام وكلاء البرمجة بالذكاء الاصطناعي مع Blockstudio، بدءًا من إعداد المشروع وحتى إنشاء موقع كامل.
لماذا يناسب Blockstudio وكلاء الذكاء الاصطناعي
ملفات، لا قواعد بيانات
تقرأ وكلاء البرمجة بالذكاء الاصطناعي الملفات وتكتبها؛ فهذا هو أسلوب تعاملها الأساسي. يحتفظ Blockstudio بكل شيء في نظام الملفات: ملف block.json وملف قالب لكل كتلة، وملف page.json لكل صفحة، وملف pattern.json لكل نمط. لا إدخالات في قاعدة البيانات لإدارتها، ولا صفحات إدارة UI للتنقل بينها، ولا خطوة بناء للتشغيل.
هذا مهم لأن أنظمة الملفات وأوامر الصدفة تمثل أحد أكبر مصادر بيانات التدريب المسبق لنماذج اللغة الكبيرة. فقد شاهد كل نموذج ملايين الأمثلة على قراءة الملفات وكتابتها وتنظيمها. وعندما يتوافق سير عمل تطوير WordPress مع هذا الأسلوب، تتمكن الوكلاء من العمل بتعليمات قليلة.
بنية متوقعة
يتبع كل مكون Blockstudio النمط نفسه:
my-block/
├── block.json # Configuration + fields
├── index.php # Template
└── style.css # Styles (optional)
يعني هذا الاتساق أن الوكيل الذي أنشأ كتلة واحدة يستطيع إنشاء مئة. فلا مفاجآت ولا حالات خاصة ولا إعدادات مخفية. وينطبق النمط نفسه على الصفحات (page.json + قالب) والأنماط (pattern.json + قالب) والإضافات (extend.json).
الصفحات الكاملة كملفات
يتطلب إنشاء الصفحات التقليدي باستخدام WordPress محرر الكتل: سحب الكتل، وضبط الإعدادات، والحفظ عبر لوحة الإدارة. لا تستطيع وكلاء الذكاء الاصطناعي فعل أي من ذلك. فهي تحتاج إلى ملفات.
تحل Blockstudioالصفحات المستندة إلى الملفات المشكلة بالكامل. يحدد page.json بيانات الصفحة الوصفية، ويحدد قالب index.php بنية الكتل باستخدام HTML:
pages/about/
├── page.json # Title, slug, post type, template lock
└── index.php # Block structure as HTML
<block name="core/cover" key="hero" url="https://example.com/bg.jpg">
<h1 blockEditingMode="contentOnly">About Us</h1>
<p blockEditingMode="contentOnly">Our story.</p>
</block>
<div key="team">
<h2>The Team</h2>
<block name="my/team-member" />
<block name="my/team-member" />
</div>
يمكن للوكيل إنشاء صفحة WordPress كاملة، تشمل المكوّنات الأساسية والمخصصة، وقفل القالب، وعناصر التحكم في التحرير، وذلك بكتابة ملفين فقط. شغّل wp bs pages sync لتطبيق المصدر على WordPress؛ ففتح لوحة الإدارة لا ينفذ هذه المزامنة تلقائيًا.
هذه إحدى أقوى ميزات التطوير بمساعدة الذكاء الاصطناعي. فبدلًا من وصف تخطيط الصفحة وتجميعه يدويًا في المحرر، تصفه للوكيل فيكتب القالب. تكون النتيجة خاضعة للتحكم في الإصدارات وقابلة لإعادة الإنتاج، ويمكن تكرار تحسينها في ثوانٍ.
لا حاجة إلى خطوة بناء
لا شيء يحتاج إلى تجميع أو حزم أو تحويل. ينشئ الوكيل ملفًا فيعمل فورًا. يُجمّع SCSS على الخادم. وتُحل وحدات ES وقت التشغيل. ويُجمّع Tailwind CSS مع كل طلب للواجهة الأمامية. لا يمكن تقصير دورة الملاحظات بين «كتابة الوكيل للأكواد» و«تشغيل الأكواد في المتصفح» أكثر من ذلك.
لماذا يعد Tailwind CSS الخيار المناسب
يدعم Blockstudio كلًا من CSS العادي وTailwind CSS، لكن لـ Tailwind ميزة كبيرة عند العمل مع وكلاء الذكاء الاصطناعي.
تعرف نماذج اللغة الكبيرة Tailwind جيدًا جدًا
يُستخدم Tailwind CSS في عشرات الآلاف من مستودعات المصادر المفتوحة. ويشغّل واجهات Claude.ai وVercel وShopify وCursor ومنتجات OpenAI نفسها. هذا الانتشار في بيانات التدريب يعني أن نماذج اللغة الكبيرة تنشئ أصناف Tailwind بدقة عالية ونادرًا ما تختلق أدوات غير موجودة.
مفردات الأصناف محدودة ومحددة جيدًا. لا يستطيع الوكيل اختلاق خاصية CSS غير موجودة، ما يقلل أخطاء التنسيق كثيرًا مقارنةً بـ CSS الحر، حيث قد ينشئ الوكيل محددات غير صالحة أو يسيء فهم سلوك التتالي.
الأنماط داخل الترميز
مع Tailwind، توجد كل معلومات التنسيق معًا في قالب HTML. يرى الوكيل الوصف المرئي الكامل للعنصر في مكان واحد. فلا حاجة إلى الرجوع إلى ملفات .css منفصلة أو فهم ترتيب التتالي أو تتبع تعارضات الأولوية.
تكون هذه الميزة فعالة بشكل خاص مع مكوّنات Blockstudio، إذ يكون القالب ملفًا واحدًا بالفعل. ويمكن للوكيل إنشاء مكوّن كامل التنسيق في خطوة واحدة:
<div useBlockProps class="bg-white rounded-2xl shadow-lg p-8">
<h2 class="text-2xl font-bold text-gray-900">
<?php echo $a['title']; ?>
</h2>
<p class="mt-4 text-gray-600 leading-relaxed">
<?php echo $a['description']; ?>
</p>
</div>
وكلاء متوازون بلا تعارضات
بما أن أنماط Tailwind محصورة في كل قالب، يمكن لعدة وكلاء (أو مطورين) العمل على مكوّنات مختلفة في الوقت نفسه دون CSS تعارضات دمج. فلا توجد ورقة أنماط مشتركة قد تؤدي فيها تغييرات مكوّن إلى كسر آخر عن طريق الخطأ. كل مكوّن مستقل بذاته.
يعمل هذا جيدًا أيضًا مع CSS العادي عند استخدام الأنماط المحصورة في Blockstudio (style.scoped.css)، لكن Tailwind يلغي ملف CSS بالكامل، ما يعني ملفًا أقل على الوكيل إدارته لكل مكوّن.
يظل CSS العادي صالحًا للاستخدام
ليس Tailwind مطلوبًا. يتعامل مسار الأصول في Blockstudio تلقائيًا مع ملفات .css و.scss، بما فيها الأنماط المحصورة ضمن نطاق المكوّن. إذا كان مشروعك يستخدم منهجية CSS مختلفة، فيمكن للوكلاء العمل بها أيضًا. تقتصر ميزة Tailwind على أن نماذج اللغة الكبيرة تتعامل معه بشكل أفضل بفضل تغطيته في بيانات التدريب ووجود الأنماط مع الترميز.
وكلاء البرمجة بالذكاء الاصطناعي
يمكن لأدوات CLI التالية العمل مع مشاريع Blockstudio مباشرةً. فهي تقرأ الملفات وتكتبها، وتشغّل أوامر الصدفة، وتفهم بنية المشروع من ملفات السياق.
وكلاء الطرفية (CLI)
| الأداة | المزوّد | ملاحظات |
|---|---|---|
| Claude Code | Anthropic | وكيل يركز على الطرفية. يقرأ CLAUDE.md لفهم سياق المشروع. |
| Codex CLI | OpenAI | CLI مفتوح المصدر ومكتوب بلغة Rust. متاح أيضًا كتطبيق لسطح المكتب. |
| Gemini CLI | مفتوح المصدر مع نافذة سياق بسعة مليون رمز. يقرأ GEMINI.md. |
|
| GitHub Copilot CLI | GitHub | وكلاء متوازون متخصصون للاستكشاف والمهام والتخطيط والمراجعة. |
| Aider | مفتوح المصدر | يدعم أكثر من 100 مزوّد لنماذج اللغة الكبيرة، بما فيها النماذج المحلية. |
| OpenCode | مفتوح المصدر | واجهة مستخدم نصية للطرفية مع تكامل LSP. يدعم أكثر من 75 مزوّدًا. |
| Amazon Q Developer CLI | AWS | تتوفر فئة مجانية. مناسب جدًا للمشاريع المتكاملة مع AWS. |
وكلاء بيئات التطوير المتكاملة
| الأداة | المزوّد | ملاحظات |
|---|---|---|
| Cursor | Cursor | نسخة متفرعة من VS Code مع ذكاء اصطناعي مدمج. يتوفر أيضًا CLI (إصدار تجريبي). |
| Windsurf | Cognition AI | نسخة متفرعة من VS Code مع مساعد Cascade الوكيل. |
| Cline | مفتوح المصدر | إضافة لـ VS Code تتطلب الموافقة خطوة بخطوة. يتوفر أيضًا CLI. |
| Kilo Code | مفتوح المصدر | وضع تنسيق مع وكلاء فرعيين يعملون بتنسيق مشترك. |
| Continue | مفتوح المصدر | إضافة لـ VS Code/JetBrains مع وكلاء غير متزامنين لـ CI/CD. |
| Augment Code | Augment | يركز على المؤسسات مع فهرسة معمقة لقاعدة الأكواد. |
يمكن لكل هذه الأدوات إنشاء الملفات وتعديلها في مجلد مشروع Blockstudio. وتناسب وكلاء الطرفية هذا العمل خصوصًا، لأن تطوير Blockstudio لا يتطلب ميزات خاصة ببيئة تطوير متكاملة، فهو يعتمد بالكامل على الملفات.
إعداد مشروعك لوكلاء الذكاء الاصطناعي
ملف سياق نماذج اللغة الكبيرة
يأتي Blockstudio مزودًا بملف سياق مُعد مسبقًا يفهرس وثائق إطار العمل كاملة. وهو ليس ملخصًا أو دليلًا مختصرًا: تُدرج كل وثيقة مرة واحدة مع مسارها والغرض منها والمعرّفات التي تملكها، كي يتمكن الوكيل من العثور على الصفحة التي تجيب عن السؤال وفتحها وحدها. ويظل النص الكامل لكل وثيقة ومخطط متاحًا في ملف ثانٍ للأدوات التي تحتاج إلى المجموعة كاملة دفعة واحدة.
فعّله في blockstudio.json:
{
"ai": {
"enableContextGeneration": true
}
}
يتوفر الفهرس الآن في your-site.com/blockstudio-llm.txt، والنص الكامل في your-site.com/blockstudio-llm-full.txt. وجّه أداة الذكاء الاصطناعي إلى الفهرس لتتمكن من الوصول إلى كامل Blockstudio API دون أي تعليمات إضافية. راجع وثائق تكامل الذكاء الاصطناعي لإعداد كل أداة على حدة.
يحل هذا محل الحاجة إلى كتابة تعليمات خاصة بإطار العمل بنفسك. يستطيع الوكيل الذي يصل إلى blockstudio-llm.txt معرفة كيفية إنشاء المكوّنات وتعريف الحقول وكتابة القوالب وضبط Tailwind وإعداد الصفحات واستخدام كل خطاف يوفره Blockstudio.
ملفات السياق الخاصة بالمشروع
تقرأ معظم وكلاء البرمجة بالذكاء الاصطناعي أيضًا ملف سياق على مستوى المشروع، يتضمن تعليمات خاصة بقاعدة الأكواد لديك. ويختلف الاسم المتعارف عليه حسب الأداة:
| الملف | الأداة |
|---|---|
CLAUDE.md |
Claude Code |
AGENTS.md |
Codex CLI وGemini CLI وCopilot CLI وأدوات أخرى |
.cursor/rules/*.mdc |
Cursor |
.github/copilot-instructions.md |
GitHub Copilot |
بما أن blockstudio-llm.txt يغطي إطار العمل بالفعل، لا يحتاج ملف سياق مشروعك إلا إلى وصف ما يميّز مشروعك: تخطيط المجلدات، واصطلاحات التسمية، والأوامر، والحدود.
إذا ثبّت blockstudio/phpstan، فلن تحتاج إلى كتابة هذا الوصف يدويًا. ينشئ vendor/bin/blockstudio-agents ملف AGENTS.md من blockstudio.json وملفاتك، ويوضح ما ينشئه المشروع، والميزات المفعّلة، وما سيرفضه التحليل، والأوامر المناسبة. ويرفض استبدال ملف لم ينشئه، ويحافظ على ملاحظاتك عند إعادة إنشائه.
# My WordPress Site
Built with Blockstudio 7. File-based blocks with Tailwind CSS.
Fetch https://example.com/blockstudio-llm.txt for full framework docs.
## Structure
- `blockstudio/` - Custom blocks (block.json + index.php)
- `pages/` - File-based pages (page.json + index.php)
- `patterns/` - Block patterns (pattern.json + index.php)
- `blockstudio.json` - Plugin settings
## Conventions
- Use Tailwind utility classes for all styling
- Keep blocks small and focused: one component per block
- Use `$a['fieldId']` to access field values in templates
## Commands
- `wp server` - Start local development server
أدوات المطورين لسير عمل الذكاء الاصطناعي
يتضمن Blockstudio أداتين للمطورين صُممتا خصيصًا للتطوير بمساعدة الذكاء الاصطناعي.
اللوحة
تمثل اللوحة عرضًا شاملًا شبيهًا بـ Figma لكل صفحات Blockstudio لديك، تظهر فيه لوحات فنية مباشرة عبر إطارات iframe في عرض واحد. حرّك العرض بلوحة التتبع، وكبّره أو صغّره بإيماءة الضم أو Ctrl+التمرير.
تفيد هذه الأداة عند العمل مع وكلاء الذكاء الاصطناعي، لأنها تعرض لمحة مرئية عن كل صفحة دون تبديل علامات التبويب أو التنقل في لوحة إدارة WordPress. وعندما يعدّل الوكيل قالب صفحة، يمكنك رؤية النتيجة فورًا. فعّل الوضع المباشر لتُحدّث اللوحة تلقائيًا عند تغيّر الملفات.
فعّلها في blockstudio.json:
{
"dev": {
"canvas": {
"enabled": true,
"adminBar": false
}
}
}
ثم انتقل إلى /wp-admin/admin.php?page=blockstudio-canvas. بدّل بين عرض الصفحات (لوحات فنية بعرض كامل) وعرض المكوّنات (شبكة تضم كل المكوّنات المسجلة بقيمها الافتراضية).
أداة تحديد العناصر
تحل أداة تحديد العناصر مشكلة شائعة في سير عمل الذكاء الاصطناعي: إخبار الوكيل بالملف الذي يعرض عنصرًا معينًا في الصفحة.
أضف ?blockstudio-devtools إلى نهاية أي URL للواجهة الأمامية، ثم اضغط باستمرار على Cmd+C (Mac) أو Ctrl+C (Windows) لمدة 100ms. سيظهر محدد بعلامة تصويب ويسلط الضوء على مكوّنات Blockstudio أثناء تمرير المؤشر عليها. انقر عنصرًا لنسخ سياقه إلى الحافظة:
@<div>
<div class="my-block">
Hello world
</div>
in theme-name/blockstudio/blocks/my-block/index.php
ألصق هذا في أداة البرمجة بالذكاء الاصطناعي، وسيعرف الوكيل فورًا مسار الملف وبنية HTML والعنصر الذي تشير إليه. لا حاجة بعد الآن للبحث يدويًا عن مسارات ملفات القوالب.
فعّلها في blockstudio.json:
{
"dev": {
"grab": {
"enabled": true
}
}
}
أنماط عملية
إنشاء مكوّن واحد
أبسط سير عمل: صِف ما تريده ودع الوكيل ينشئه.
الموجّه:
أنشئ مكوّنًا لشهادة يتضمن حقولًا للاقتباس (منطقة نصية) واسم المؤلف (نص) ومنصب المؤلف (نص) وصورة المؤلف (ملفات). استخدم Tailwind للتنسيق. اجعل الاقتباس بخط كبير ومائل مع علامة اقتباس زخرفية.
سينشئ الوكيل ما يلي:
blockstudio/testimonial/
├── block.json
└── index.php
إنشاء صفحة كاملة
تتيح الصفحات المعتمدة على الملفات في Blockstudio للوكيل إنشاء صفحة WordPress كاملة على هيئة قالب. هنا تظهر الفائدة الحقيقية: فبدلًا من إنشاء المكوّنات واحدًا تلو الآخر، ينشئ الوكيل بنية الصفحة كاملة مع كل مكوّناتها في خطوة واحدة.
الموجّه:
أنشئ صفحة «من نحن» بقسم رئيسي وشبكة للفريق ونموذج اتصال تجريبي. استخدم المكوّنات الموجودة حيثما أمكن، وأنشئ مكوّنات جديدة عند الحاجة. اربطها بمعرّف المنشور 2. اقفل القالب مع إتاحة تحرير محتوى العناوين والفقرات.
ينشئ الوكيل ما يلي:
pages/about/
├── page.json # postId: 2, templateLock: "all"
└── index.php # Full block structure with core + custom blocks
بالإضافة إلى أي مكوّنات مخصصة تشير إليها (e.g، blockstudio/team-member/). شغّل
wp bs pages sync لإنشاء المنشور WordPress مع قفل القالب
وعناصر التحكم في التحرير. تكون الصفحة كاملة خاضعة للتحكم في الإصدارات وقابلة لإعادة الإنتاج.
إنشاء موقع كامل
هنا تتألق بنية Blockstudio فعلًا. يمكن لموجّه واحد إنشاء موقع كامل لأن كل عنصر فيه ملف:
الموجّه:
أنشئ موقعًا للأعمال يضم الصفحات التالية: الرئيسية والأعمال ومن نحن والاتصال. أنشئ مكوّنات مخصصة للقسم الرئيسي وشبكة المشاريع وبطاقة المشروع وعضو الفريق ومعلومات الاتصال والتذييل. استخدم مظهرًا داكنًا مع Tailwind. اضبط Tailwind في blockstudio.json باستخدام لوحة ألوان مخصصة.
ينشئ الوكيل مجلدات المكوّنات وقوالب الصفحات وblockstudio.json مع إعدادات Tailwind، ويمكنه اختياريًا إنشاء أنماط لأقسام قابلة لإعادة الاستخدام. تُحفظ جميع العناصر في git ضمن مجموعة تغييرات واحدة.
سير عمل الوكلاء المتوازيين
تدعم بعض الأدوات (تطبيق Codex لسطح المكتب وGitHub Copilot CLI وKilo Code) تشغيل عدة وكلاء بالتوازي. تجعل بنية Blockstudio القائمة على ملف لكل مكوّن ذلك آمنًا:
- الوكيل 1: ينشئ المكوّن الرئيسي والصفحة الرئيسية
- الوكيل 2: ينشئ مكوّن بطاقة المشروع وصفحة الأعمال
- الوكيل 3: ينشئ مكوّن نموذج الاتصال وصفحة الاتصال
بما أن لكل مكوّن مجلده الخاص وأنماط Tailwind موجودة مع القوالب، فلن تتعارض هذه الوكلاء. الملف المشترك الوحيد هو blockstudio.json، وعادةً لا يحتاج إلى إعداد إلا مرة واحدة في البداية.
نصائح للحصول على نتائج أفضل
-
أشر إلى ملف سياق نماذج اللغة الكبيرة. تنتج الوكلاء أكواد Blockstudio أفضل بكثير عندما تتمكن من الوصول إلى وثائق إطار العمل. وجّهها دائمًا إلى
blockstudio-llm.txt، وزوّدها بملفAGENTS.mdمُنشأ للمشروع نفسه. -
حدد أنواع الحقول بدقة. بدلًا من قول «أضف حقل صورة»، قل «أضف حقل ملفات يتضمن
allowedTypes: ['image']وreturnFormat: 'object'». كلما زادت دقة تعريفات الحقول، قلّت جولات التعديل اللازمة. -
ابدأ بمكوّن واحد ثم توسّع. دع الوكيل ينشئ مكوّنًا واحدًا على نحو صحيح، وراجع أنماطه، ثم اطلب منه إنشاء البقية وفق الاصطلاحات نفسها. يوفر ذلك مرجعًا يحسّن النتائج اللاحقة.
-
راجع النتائج. لا يعني البرمجة بالإحساس قبول الأكواد دون مراجعة. تحقق من توافق أنواع الحقول مع ما تريده، ومن عرض القوالب بشكل صحيح، ومن أن أصناف Tailwind تنتج المظهر المناسب. ينبغي مراجعة الأكواد المنشأة بالذكاء الاصطناعي قبل نشرها.
-
استخدم مخططات
block.json. يوفر Blockstudio مخطط JSON فيhttps://blockstudio.dev/schema/block. توفّر إضافة"$schema"إلى block.json للوكلاء ملاحظات التحقق، وتمنع الإعدادات غير السليمة. -
اجعل المكوّنات صغيرة ومركزة. خصص مكوّنًا واحدًا لكل عنصر مرئي. يسهل هذا على الوكيل تحليل كل مكوّن، ويبقي القوالب قصيرة بما يكفي لتتسع لها نافذة سياق واحدة.