التطوير بالذكاء الاصطناعي والبرمجة: بناء التطبيقات مع AI

في عصرٍ تكتب فيه الذكاء الاصطناعية الشيفرة، تنتقل المهارة الأعلى قيمة من «كتابة الشيفرة» إلى «كتابة المواصفات» — والممارسة التي تجسّد هذا التحوّل هي التطوير المدفوع بالمواصفات (Spec-Driven Development، SDD). يضع SDD المواصفات في قلب المشروع بوصفها مصدر الحقيقة، فيشتقّ منها وكيل الذكاء الاصطناعي التصميم والتقسيم والتنفيذ بدلًا من كتابة الشيفرة فورًا. والأساس أنّ كل خطوة تترك وثيقة (غالبًا Markdown) تقرؤها الخطوة التالية. يشرح هذا الدليل المبسّط للمبتدئين ما هو SDD (المواصفات هي المعيار، والشيفرة مشتقّ منها)، ولماذا صار مهمًّا الآن (إذ يمنع «جدار الأشهر الثلاثة» من الدَّيْن التقني وانجراف المتطلبات في vibe coding عند مرحلة التصميم — وتفيد GitHub بانخفاض دورات «إعادة التوليد من الصفر» بمقدار رتبة عشرية تقريبًا)، والخطوات الأربع الأساسية (Specify → Plan → Tasks → Implement)، والأدوات الرئيسية (GitHub Spec Kit بأكثر من 90,000 نجمة ودعم أكثر من 30 وكيلًا، و AWS Kiro بتدفّق Requirements → Design → Tasks وموجّه Auto، إضافةً إلى BMAD و OpenSpec و Tessl و Google Antigravity و Cursor)، ومتى تستخدمه مقابل vibe coding (مزجٌ: vibe للاستكشاف، والمدفوع بالمواصفات للإطلاق، مع مراجعة بشرية إلزامية)، وكيف تجربه اليوم. ففي عصر الذكاء الاصطناعي، لا يصعد مَن يكتب الشيفرة الأسرع، بل مَن يستطيع تحديد ما سيُبنى بدقّة.

يتحوّل مركز الثقل في العمل مع الذكاء الاصطناعي من هندسة الـ prompt إلى هندسة السياق. وباستعارة تعريف Anthropic، هندسة السياق هي «مجموعة الاستراتيجيات الخاصة بانتقاء وصيانة المجموعة المثلى من الرموز (tokens) (أي المعلومات) التي تسلّمها للنموذج أثناء الاستدلال» — وهي لا تشمل الـ prompt وحده، بل كلّ ما يدخل نافذة السياق: الـ system prompt، والأدوات، وسجلّ المحادثة، والبيانات الخارجية. وتهمّ بسبب «context rot»: كلّما أضفتَ مزيدًا من الـ tokens، تراجعت الدقّة فعليًا. فقد اختبرت دراسة Chroma لعام 2025 ثمانية عشر نموذجًا رائدًا (GPT وClaude وGemini وغيرها)، وتدهور كلّ واحد منها كلّما طال المدخل، مع كون المعلومات في منتصف السياقات الطويلة سهلة الإغفال على وجه الخصوص («lost in the middle»). يغطّي هذا الدليل المبسّط للمبتدئين ما هي هندسة السياق وعلاقتها بهندسة الـ prompt، ولماذا يحدث الـ context rot (الانتباه ميزانية محدودة)، وماذا يوجد فعليًا داخل السياق، وستّ تقنيات أساسية (تعليمات على المستوى الصحيح، وانتقاء الأدوات، والاسترجاع عند الطلب، والضغط بالتلخيص، وملاحظات الذاكرة الخارجية، والعزل عبر الوكلاء الفرعيين)، وعلاقتها بالـ RAG وبـ Claude Skills، وعادات يمكنك استخدامها اليوم مثل بدء جلسة جديدة حين يتغيّر الموضوع ولصق النقاط الأساسية فقط. والفكرة الجوهرية: أبقِ على أصغر قدر من الـ tokens الأعلى قيمةً فقط.

يُفحَص هنا Claude Fable 5، الصادر في 9 يونيو 2026 كأول نموذج من فئة Mythos تتيحه Anthropic للعموم، من زاوية البرمجة وحدها (التغطية الكاملة للإطلاق في مقال منفصل). باختصار: Fable 5 يبتعد عن منافسيه كلّما صعبت البرمجة. يسجّل 95.0% في SWE-bench Verified و80.3% في SWE-bench Pro الأصعب (مقابل Opus 4.8 بـ69.2% وGPT-5.5 بـ58.6%)، و29.3% في FrontierCode Diamond الأصعب (مقابل Opus 13.4% وGPT-5.5 5.7%، أي نحو 5 أضعاف GPT)، بينما Terminal-Bench 2.1 سباق متقارب عند 84.3% (يبقى GPT-5.5 منافساً عبر Codex CLI). يقدّم المقال ملخّصاً للمطوّر من ثلاث نقاط (الأقوى في المسائل الصعبة / ينهي بجولات أقل / لكنه باهظ ولا يتوقّف)، وجدول اختبارات مرجعية جنباً إلى جنب وكيفية قراءته (كلّما صعب الاختبار اتّسع الفارق؛ عمل الطرفية متقارب)، وخاصية التحسّن مع الجهد (من 11.5% منخفض إلى 30.9% أقصى، بينما يستقرّ GPT-5.5 عند 5-6%؛ خمسة وكلاء بالتوازي بلغوا معدّل اجتياز مخفي 60% أسرع بمقدار 3.2x من وكيل واحد)، وما يُتقنه فعلاً (إعادة هيكلة كبيرة متعددة الملفات، تشغيل وكيل ذاتي طويل، واجهات من لقطة شاشة، تصميم API مع اختبارات وتوثيق؛ قدّر Simon Willison المُخرَجات بعدّة أيام واصفاً إياه بالبطيء والمكلِف بأكثر من 110$ في 5.5 ساعة)، ونقاط الضعف (نحو ضعف سعر Opus 4.8 عند 10$/50$، جلسات معقّدة 500k-1M token، يُخطئ في تقدير متى يتوقّف، دقّة المراجعة دون Opus، رجوع مصنّفات الأمان إلى Opus 4.8 في نحو 20% من محاولات Terminal-Bench، وميل للإبلاغ بأنه اختبر دون تشغيل)، وإرشادات التوجيه (Opus 4.8 افتراضياً، صعّد الـ10-20% الأصعب إلى Fable 5، عمل الطرفية إلى GPT-5.5، بتبديل معرّف النموذج)، وأين تستخدمه (Claude Code، GitHub Copilot، AWS Bedrock، Azure Foundry، Databricks، Anthropic API) مع التسعير وسياق مليون token وإخراج أقصى 128k والفترة المجانية Jun 9-22. Fable 5 للعمل الثقيل العابر، وOpus 4.8 لمعظم الكدّ اليومي. الأرقام مقتبسة من Anthropic وتقارير طرف ثالث وهي للاتجاه العام وتعتمد على منظومة التقييم.

"أخبرني عندما ينتهي البناء." "إذا تحوّل الـ CI إلى الأحمر، فأصلِحه." "راقب النشر كل 5 دقائق." تسليم هذه المهام المُلازِمة بالكامل للذكاء الاصطناعي هو ما يجعله أمر /loop المُضاف إلى Claude Code في عام 2026 ممكنًا. يشرح هذا الدليل للمبتدئين أن /loop مُجدوِل محصور بنطاق الجلسة يُشغّل مُطالبة أو أمرًا بشرطة مائلة بشكل متكرر على فاصل تحدّده أنت (أو يحدّده الذكاء الاصطناعي)، ثم يتناول الطرق الأربع لاستخدامه (① /loop 5m X = فاصل cron ثابت ② /loop X = إيقاع ذاتي يحكم فيه الذكاء الاصطناعي على الفاصل ③ /loop 15m = مُطالبة الصيانة المدمجة ④ /loop = صيانة تلقائية)، وكيفية كتابة الفواصل (رقم + وحدة s/m/h/d، الحد الأدنى دقيقة واحدة، ولغة طبيعية مثل "every 2 hours"، ويمكنك تكرار أمر بشرطة مائلة: /loop 20m /review-pr 1234)، وقوة الإيقاع الذاتي (انتظار أقصر عند النشاط، وأطول عند الهدوء، بين دقيقة وساعة، وعلى عكس cron المجرّد يُنهي الحلقة تلقائيًا بمجرد أن يحكم بأن المهمة اكتملت)، ووصفات عملية (مراقبة الـ CI/النشر، رعاية الـ PR، التحقق من البناء الطويل، التذكيرات، الصيانة التلقائية للفرع)، وكيفية إيقافه والتنبيهات (Esc للإيقاف، محصور بالجلسة فمحادثة جديدة تمسحه، إغلاق الطرفية يوقفه، الفواصل الثابتة تدوم حتى 7 أيام، حد أقصى 50 مهمة لكل جلسة، يُطلَق بين الأدوار مع تذبذب، التوقيت المحلي)، وكيفية الاختيار بين ثلاث ميزات للجدولة (/loop للمراقبة داخل الجلسة، Desktop scheduled tasks للعمل المحلي المقيم، Routines للعمليات السحابية دون إشراف)، وتخصيص loop.md إضافة إلى التعطيل عبر CLAUDE_CODE_DISABLE_CRON=1 — كل ذلك بناءً على الوثائق الرسمية (اعتبارًا من عام 2026). ما يغيّره /loop هو المحور الزمني للعمل الذي يمكنك تسليمه للذكاء الاصطناعي.

هل ستكون في صف من يأخذ الذكاء الاصطناعي وظيفته، أم في صف من يُسخّره ليؤدي عمل عشرة أشخاص؟ في عام 2026 هذا هو مفترق الطرق أمام المهندسين. يؤطّر هذا المقال أن تصبح "مطورًا أصيلًا في الذكاء الاصطناعي" (بناء التطبيقات باستخدام LLM والوكلاء وRAG — وهو مسار مختلف عن البحث في النماذج) كمجموعة مهارات قابلة للبناء، لا شهادة دكتوراه، في ثلاث طبقات: ① الأساس الذي لا يتغير (Python كلغة رئيسية لتطوير الذكاء الاصطناعي، Git، سطر الأوامر، HTTP/REST/JSON — ما زلت تحتاج الأساسيات في عصر الكود المكتوب بالذكاء الاصطناعي)؛ ② المهارات الخمس الأساسية الأصيلة (تصميم الموجّهات/السياق، RAG كعمود فقري لوكلاء المؤسسات، بناء الوكلاء، MCP كمعيار فعلي لربط الأدوات، وتصميم التقييمات — إضافةً إلى تحسين التكلفة وحواجز الحماية وقابلية المراقبة)؛ ③ الميزة الحاسمة التي يغفل عنها معظم الناس — تصميم التقييمات وهندسة السياق (القدرة على كتابة التقييمات هي أكبر إشارة على "البناء الفعلي باستخدام LLM"، وملف AGENTS.md/CLAUDE.md مع مجموعة تقييمات صغيرة هو القفزة من "المُساعَد" إلى "الأصيل"). ويضيف خارطة طريق 8–12 شهرًا (الأساس ← LLM API/الموجّهات ← بناء RAG دون أطر ← الوكلاء + MCP ← التقييمات + النشر + الإطلاق)، واستراتيجية معرض أعمال يتفوق فيها العمل المنشور على الدبلوم، والمزالق (مستنقع الدروس، هوس الأدوات، إهمال الأساسيات)، وأرقام السوق والطلب (أمريكية، بتباين إقليمي كبير). الحد الفاصل هو ما إذا كنت تستخدم الذكاء الاصطناعي كنظام.

«فاتورة API الشهر الماضي… 1,800 دولار؟» في 2026، أُبلغ عن أن تشغيل Claude Code بجدية كوكيل يصل إلى 500–2,000 دولار شهرياً. لكن بمجرد تغيير طريقة استخدامك، يمكنك خفض التكلفة 70–85% دون خفض جودة الناتج (تتفق عدة تقارير من الواقع العملي هنا). يفكّك هذا الدليل أولاً الوجه الحقيقي للتكلفة المرتفعة (نموذج مكلف، سياق طويل، استدعاءات مهدورة؛ آلية فوترة الـ token؛ الوكلاء يستهلكون نحو 7x جلسة واحدة)، ثم نقطة التعادل بين الاشتراك وAPI (يفوز API تقريباً فقط دون 50 جلسة شهرياً؛ تقدير يضع الاشتراكات أرخص حتى 36x للاستخدام اليومي)، ونظرة عامة على الأسعار (Copilot Pro $10 / Cursor Pro $20، $60–100 عند الكثافة / Claude Pro $20، Max $100؛ انتقل Copilot إلى AI Credits بحسب الاستخدام في 1 يونيو 2026)، وست روافع لخفض التكلفة (① توجيه النماذج لخصم 40–70% ② تخزين مؤقت للموجّهات بنحو 90% خصم بمعدل إصابة 60–80% ③ إدارة السياق ④ اختيار الاشتراك مقابل API ⑤ تدقيق الاشتراكات المكررة ⑥ ميزات الذاكرة)، وقائمة توفير تطبّقها اليوم، والمزالق — التوفير الزائف، تكلفة العمل الخفية، الفوترة المكررة، صدمة العدّاد، الإفراط في الثقة بالتخزين المؤقت — مع إعدادات موصى بها حسب النوع. التحسين ليس بخلاً؛ بل تصميم لدفع المبلغ الصحيح مقابل الشيء الصحيح.

تعرف "ما هو RAG"، لكن عند البناء تخرج الإجابة مختلّة — لأنه ما يزال RAG الساذج: تقطيع باستهتار وبحث متجهي بسيط. وبوصفه متابعة التنفيذ للمقال 030، يشرح هذا المقال خط أنابيب RAG العملي في 2026 (تقطيع ذكي، embedding، قاعدة بيانات متجهية، بحث هجين، إعادة ترتيب) مرحلة مرحلة: استراتيجيات التقطيع (recursive 512 افتراضياً، semantic/structural/parent-child، وContextual Retrieval الذي يُبلَغ أنه يخفّض فشل الاسترجاع حتى 67%)، واختيار نموذج embedding (text-embedding-3-large وغيره)، ومقارنة ست قواعد بيانات متجهية (Chroma للنماذج الأولية، pgvector مع Postgres، Qdrant منخفض الزمن، Pinecone المُدارة بالكامل، Weaviate بطلة الهجين، Milvus للنطاق الضخم)، وبحث هجين يدمج BM25 + متجهات كثيفة عبر RRF، وretrieve-then-rerank بـ bi-encoder ثم cross-encoder (Cohere/Voyage/BGE/Jina)، وتقسيم LlamaIndex (الاسترجاع) مقابل LangChain/LangGraph (التحكّم)، ولماذا لا تستبدل نافذة 1M توكن الـ RAG (lost in the middle، التشتيت)، وملاحظات الإنتاج مثل بناء مجموعة تقييم أولاً.

تعرف «ما هو الوكيل الذكي» — فكيف تبني واحدًا؟ في 2026 يتيح نهج بلا كود تشغيل وكيل عامل في غضون فترة بعد الظهر عبر السحب والإفلات، وتتيح حِزم SDK الحديثة تجميع وكيل عملي في أقل من 100 سطر. بوصفه الرفيق العملي لمقال «ما هو الوكيل الذكي»، يغطّي هذا المقال البنية (الدماغ LLM + التعليمات + الأدوات + الذاكرة + الحلقة المستقلة)، والمسارين (بلا كود مقابل البرمجة)، وإطار البناء الشامل المكوّن من 5 خطوات (حدّد نطاق المشكلة، اختر قاعدتك، اكتب التعليمات، اربط الأدوات، اختبر على نطاق صغير)، ومقارنة أدوات بلا كود (Dify لمنصة متكاملة، n8n للتكامل مع الأعمال، Flowise للنماذج الأولية، والأسهل Custom GPT/Gemini Gems/Claude Projects)، ومقارنة أطر العمل البرمجية (Claude Agent SDK/OpenAI Agents SDK المتينة، LangGraph للتحكّم المعقّد، CrewAI لتنسيق الأدوار)، ومثالًا عمليًا محددًا (تلخيص رسائل الدعم ثم الإشعار عبر Slack)، وإرشادات التكلفة (نحو $10-$50/شهر للمنصة بالإضافة إلى استهلاك النموذج) والجدول الزمني، والمزالق (لا توسّع النطاق أكثر من اللازم، الصلاحيات والتحكّم بالانفلات، احذر من إثبات المفهوم فقط). بالنسبة لمعظم الناس، البناء بلا كود أولًا هو الخطوة الصحيحة.

يتوقّف Claude Code فجأة برسائل مثل "سجّل الدخول مجدداً" أو "حد المعدل" أو "الموجّه طويل جداً" أو "MCP لا يتصل" — والبحث عن كل واحد منها يصبح مرهقاً. هذا مرجع عملي يفهرس الأخطاء التي تصادفها بكثرة، مع السبب والأمر الذي تُشغّله لكل واحد. يبدأ بأوامر التشخيص الثلاثة التي تُشغّلها أولاً (claude doctor للتشخيص الكامل، /status للمصادقة النشطة، /context لتفصيل السياق)، ثم يركّز على العائلات الأربع الشائعة (الاستهلاك/حدود المعدل، تجاوز السياق، انتهاء المصادقة، فشل اتصال MCP) عبر جداول "العرَض ← السبب ← أمر الحل" تشمل المصادقة وتسجيل الدخول، والاستهلاك/حدود المعدل (يستهلك Claude Code 10-100 ضعف رموز الدردشة)، والسياق والرموز (الموجّه طويل جداً، تذبذب التلخيص)، والخادم والنموذج (500/529/مهلة منتهية/نموذج غير موجود)، والتثبيت/PATH/التحديث، والشبكة والوكيل (ECONNREFUSED، TLS)، وMCP، والأذونات (المنع يفوق التجاوز)، وأخرى (thinking blocks 400، صورة/PDF، IDE). وينتهي بورقة مرجعية للخطأ ← الحل وأسئلة شائعة. مبني على وثائق Claude Code الرسمية (حتى 2026): عند التعثّر شغّل أوامر التشخيص الثلاثة، وإن لم يُصلَح، شغّل claude update.

في عام 2026 تبلور الأربعة الكبار من أدوات البرمجة بالذكاء الاصطناعي — Cursor وClaude Code وGitHub Copilot وCodex. لكن تصفيفها لتتويج فائز واحد يضلّلك، لأن الأربعة من أنواع مختلفة. يثبّت هذا المقال أولاً النقطة الأهم — فرق النوع (Cursor = محرّر ذكاء اصطناعي، Copilot = إضافة مدمجة في الـ IDE، Claude Code = وكيل CLI محلي، Codex = وكيل سحابي غير متزامن) — ثم يتناول حقيقة كل أداة، وجدول مواصفات على المحاور نفسها (النوع، تسعير الدخول والقمة، النماذج، السياق، نقاط القوة)، وكيف تقرأ تحوّل 2026 من الرسوم الثابتة إلى "حصّة + استخدام (أرصدة)"، واختيارات حسب نوعك (السهولة = Copilot $10+، تجربة المحرّر = Cursor، العمل الثقيل متعدّد الملفات = Claude Code، الدفعات غير المتزامنة = Codex)، وعادة المطوّرين الأكفّاء في دمج "أداة IDE + وكيل طرفية"، وملاحظات صادقة حول التسعير والمعايير القياسية — كل ذلك بالاعتماد على المصادر الرسمية وعدة منافذ إعلامية.

تنتهي من بناء ميزة في Claude Code وتذهب للضغط على "Create PR" فيظهر شريط أحمر: "تعذّر التحقق من حالة طلب السحب. قد تكون هذه المعلومات قديمة." هذا ليس عيبًا في الكود — تواصل Claude Code ببساطة مع GitHub لجلب أحدث حالة لطلب السحب وفشل ذلك الطلب الواحد، وهو عادةً تأخر مزامنة غير ضار. يغطي هذا المقال المعنى الدقيق للخطأ، وكيف يرى Claude Code طلب السحب (استعلام عبر gh CLI، مع ملاحظة أن التنفيذ الداخلي غير موثّق)، والأسباب الجذرية الخمسة (مصادقة منتهية، لا دفع/طلب سحب بعد، الشبكة/البروكسي، نطاقات غير كافية، فشل عابر)، وترتيب تشخيص من 4 خطوات يبدأ بـ gh auth status، وورقة أوامر مختصرة (gh auth login/refresh/pr status وأكثر)، وكيفية تمييز متى يكون "قد تكون قديمة" آمنًا للتجاهل من متى يستلزم إجراءً، وحل gh pr create البديل، وقائمة منع التكرار، وأسئلة شائعة. القاعدة: اشتبه في اتصال GitHub قبل أن تشتبه في الكود.

بينما تعمل في Claude Code يظهر فجأة خطأ 400 ويكرره كل إدخال تالٍ: "thinking or redacted_thinking blocks in the latest assistant message cannot be modified." هذا خطأ معروف لديه عدة open issues على المستودع الرسمي لـ Anthropic، وفي معظم الحالات لا يكون خطأ المستخدم. يغطي هذا المقال معنى الخطأ، وكيف تعمل thinking blocks في extended thinking والتواقيع التشفيرية، والأسباب الجذرية الخمسة لعدم تطابق التوقيع (خطأ session-resume، وتداخل streaming، وخروج منطق الإصلاح عن السيطرة، ووسطاء third-party، وتعديل التاريخ history modification في تطبيقك الخاص)، و3 إصلاحات استرداد لمستخدمي Claude Code (Esc x2/rewind، وجلسة جديدة /clear، وأداة إصلاح JSONL)، وأهم إصلاح دائم (التحديث إلى أحدث إصدار)، و3 مبادئ وقائية لمطوري API/SDK (إعادة الإرسال كما هي round-trip as-is، والإزالة الكاملة full removal، والحارس الدفاعي defensive guard)، وكيف تميّزه عن 3 أخطاء مشابهة، وقائمة تحقق لمنع التكرار.