المستخدم المتقدم
تقنيات متقدمة تُخرج أقصى ما في وكلاء الذكاء الاصطناعي — المهارات، والخطافات، والأمان، والتنسيق.
اللبنات الأساسية
ثماني قطع. كل واحدة تحلّ مشكلة واحدة، وهذه الوحدة كلها عن التمييز بينها.
/commit)ببساطة: الورشة فيها عُدّة يدوية، ومقبس تُوصِّل به آلات جديدة، ولائحة قواعد للبيت، ووصفات مكتوبة، ومتدربون تُرسلهم في مهام. لا أحد يخلط بين الوصفة والمقبس — وهذه هي الشريحة كلها.
تقنيًّا: القطع الثماني تختلف على محورين: هل تضيف قدرة (الأدوات، MCP) أم تعليمات (CLAUDE.md، المهارات، الخطافات)، وهل تُنفَّذ داخل نافذة سياقك أم في نافذة خاصة بها (الوكلاء الفرعيون، الوكلاء المخصصون).
كيف تتركّب مع بعضها
المهارة تستطيع أن تستخدم أي مزيج من الأدوات وخوادم MCP والوكلاء الفرعيين. هي طبقة التنسيق.
ببساطة: الوصفة هي المسؤولة. تستطيع أن تلتقط أي أداة، وأن تتصل بأي مورّد، وأن تُسنِد التقطيع إلى مساعد — لكن الوصفة هي التي تقرر الترتيب.
تقنيًّا: المهارات تجلس في طبقة التنسيق. الأمر المائل هو نقطة الدخول، ومتن المهارة يؤلّف بين الأدوات المدمجة والأدوات التي توفّرها خوادم MCP والوكلاء الفرعيين المفوَّضين في تسلسل واحد — فيُكتب التأليف مرة واحدة بدل إعادة صياغته في كل مرة.
شاهد الفرق وهو يعمل
الهدف نفسه — بطرق مختلفة. راقب كيف يتغيّر السياق مع كل طريقة.
ببساطة: أربع طرق للإجابة عن السؤال نفسه، وكلٌّ منها يحتلّ قدراً مختلفاً من مساحة مكتبك. تشغيل أمر واحد يترك ورقة لاصقة، أما أن تطلب من مساعد قراءة خزانة الملفات كلها فيترك لك فقرة واحدة.
تقنيًّا: التبويبات الأربعة تتفاوت بمرتبة عشرية في عدد الرموز المضافة إلى نافذة المُنادي: نحو 50 لنداء أداة مباشر، و1,200 لمستندات تحقنها خوادم MCP، و800 لمهارة تسلسل ثلاثة نداءات، و200 لوكيل فرعي لا تعبر قراءته البالغة 15 ألف رمز إليك أبداً.
ما يشغل نافذتك
ببساطة: مكتبك مساحته ثابتة، وهو ليس خالياً عندما تجلس إليه — فالمراجع ودليل الأسلوب وقائمة من تتّصل به موجودة عليه أصلاً. وما تبقّى من السطح وحده هو لك.
تقنيًّا: الأوامر نفسها مادة التجربة العملية 1، وما يهمّ هنا هو الفاتورة. فموجّه النظام، وتعريفات أدوات كل خادم موصول، ومهاراتك، وملف CLAUDE.md، كلها محسوبة قبل كلمتك الأولى، وفي كل دور بعدها لا مرة واحدة عند البدء. ولهذا تكون الجلسة الموصولة بعشرة خوادم أبطأ وأغلى من جلسة مجرّدة تؤدّي العمل نفسه — ولهذا فإن إطفاء خادم واحد تحسين حقيقي لا مجرّد ترتيب.
كل رسالة، وكل ملف تقرأه، وكل نتيجة أداة تتراكم في مساحة واحدة لا تكبر. خمسة أوامر تدير هذه المساحة. القراءة عنها لا تغيّر شيئاً — فاكتب /compact، اضغط «شغّل»، وراقب شريحة المحادثة وهي تنكمش.نافذة السياق
/compact حين تكمل المهمة نفسها لكن سجلّ الحوار صار قديماً. /clear حين لا علاقة للمهمة القادمة بالتي قبلها. /context قبل أي عمل مكلف. /init مرة واحدة، أول شيء، في كل مشروع جديد.المهارات — سير عمل قابل لإعادة الاستخدام
المهارات حزم أوامر تلفّ سير عمل معقّداً داخل أمر واحد بسيط.
/commit و/review-pr و/simplify و/loop — جاهزة من الصندوق.ببساطة: بدل أن تشرح أسلوب بيتك من الصفر في كل مرة، تكتبه مرة واحدة وتشير إليه. الملاحظة لا تؤدي العمل — بل تخبر العامل كيف تريد أن يُؤدَّى.
تقنيًّا: المهارة حزمة موجّهات مُصدَّرة بإصدار: تعليمات، وأذونات أدوات، وشروط تفعيل في مجلد واحد. وتُستدعى إما صراحةً بأمر مائل، أو ضمناً حين يطابق شرط تفعيلها المهمة المطروحة.
بناء خادم MCP
خادم MCP هو برنامج يعرض أدوات وموارد عبر بروتوكول Model Context Protocol.
get_weather يستطيع أي عميل MCP نداءها — ومنه Claude Code. والبروتوكول يتولّى الاكتشاف والتسلسل ومعالجة الأخطاء.ببساطة: أنت تركّب قابساً جديداً لجهاز تملكه أصلاً. الجهاز يعمل بالفعل، والقابس هو ما يتيح لأي شيء في البيت أن يشغّله دون أن يعرف كيف صُنع.
تقنيًّا: خادم MCP يعلن أداة باسم محدد ومخطّط معاملات مُنمَّط ودالة معالجة. وطبقة البروتوكول توفّر الاكتشاف وتسلسل JSON ونقل الأخطاء، فيصير الخادم نفسه صالحاً لأي عميل متوافق دون كتابة أي كود من جهة العميل.
نظام MCP البيئي
أنت في الغالب لا تكتب خوادم MCP — بل تُثبّتها. خمسة منها تتولّاها Anthropic وشركاؤها، والبقية من المجتمع.
mcp-server. وأعلى قيمة عادةً في الصف الأخير: أن تلفّ خطّ النشر عندك، أو لوحة المراقبة، أو نظام التذاكر — فتمنح الوكيل الأدوات نفسها التي يستخدمها فريقك كل يوم.
ببساطة: لا أحد تقريباً يصنع غلّاية بنفسه، بل يشتري واحدة تناسب المقبس. والاستثناء المثير هو الشيء الذي لا يملكه سوى بيتك — لا أحد يبيعه، فتوصّله بنفسك.
تقنيًّا: النظام البيئي ينقسم ثلاثاً: خوادم تصونها الشركات لواجهات SaaS الشائعة، وخوادم مجتمعية متفاوتة الجودة، وخوادم داخلية تغلّف أنظمة لا نظير عام لها. والفئة الثالثة هي التي يثبت فيها MCP قيمته، لأنها تعرض سير عملك الخاص عبر الواجهة نفسها.
ما يكلّفك خادم MCP قبل أن تسأله شيئاً
ببساطة: كل جهاز توصّله يأتي معه دليل استعمال، والدليل يبقى على مكتبك سواء استعملت الجهاز أم لا. أوصِل ما يكفي منها ولن يبقى للأدلة مكان تعمل فيه.
تقنيًّا: كل خادم متصل يحقن كتالوج مخطّطات أدواته كاملاً في موجّه النظام منذ الدور الأول — نحو 150 إلى 200 رمز لكل أداة، فخادمٌ بـ42 أداة يقارب 8,000 وخادمٌ بأداتين يقارب 1,500. وهذه كلفة قائمة تُدفع قبل أي سؤال، وتبقى محفوظة عبر الضغط التلقائي لأنها تصف ما يستطيع الدور التالي مناداته.
وصل خادم ليس مجاناً. كل خادم يسلّم النموذج فهرساً بكل ما يستطيع فعله — نحو 150 إلى 200 رمز لكل أداة يعرضها الخادم — ويُدفع هذا في الدورة الأولى، قبل سؤالك الأول. ثم تنزل النتائج فوقه. انقر read page مرة بعد مرة وراقب ما يحدث حين يمتلئ الشريط.مخططات الأدوات
الوكلاء الفرعيون — فرّق تسُد
أطلق وكلاء متخصصين للمهام الفرعية. كل منهم يحصل على نافذة سياق خاصة.
ببساطة: ترسل أحدهم إلى المكتبة بدل أن تجرّ المكتبة إلى مكتبك. هو يقرأ الرفّ، وأنت تستلم الملاحظة.
تقنيًّا: التفويض آلية لعزل السياق لا لتسريعه. الوكيل الفرعي يعمل في نافذة منفصلة، فلا تُحتسب قراءاته الوسيطة على ميزانية المُنادي إطلاقاً — يُحتسب الملخّص العائد وحده.
كيف يعمل الوكلاء الفرعيون
الوكيل الفرعي هو مساعد معزول بنافذة سياق خاصة يعمل بشكل مستقل ويعيد ملخصاً.
ببساطة: المساعد يذهب، وينجز العمل، ويعود ليخبرك كيف سار. لا يستطيع أن يربت على كتفك في منتصف الطريق ليسأل — ولهذا يجب أن يكون التكليف مكتملاً لحظة تسليمه.
تقنيًّا: دورة الحياة هي: إطلاق ثم تنفيذ معزول ثم عودة واحدة. لا يوجد دور وسيط يعود فيه إلى المستخدم، ولهذا يجب تثبيت الخصائص الأربع في هذه الشريحة — السياق النظيف، والتوازي، وضيق النطاق، وقائمة الأدوات المسموحة — لحظة الإطلاق.
إنشاء وكلاء فرعيين مخصصين
استخدم الأمر /agents أو الراية --agents لبناء وكلاء فرعيين متخصصين.
ببساطة: وصف وظيفي مكتوب. من هو، ولأي غرض، وأي المفاتيح يُسمح له بحملها.
تقنيًّا: الوكيل المخصص ثلاثيّ مُسمّى: وصف يُستعمل للتوجيه، وموجّه نظام يثبّت الدور، وقائمة allowedTools مسموحة. لاحظ أن المراجع هنا لا يملك أداة كتابة أصلاً — القيد يفرضه الضبط، لا مناشدة النموذج بلُطف.
تصميم وكلاء فرعيين فعالين
أنماط تجعل الوكلاء الفرعيين موثوقين وقابلين للتنبؤ.
--effort low للمسح السريعببساطة: أخبره كيف يبدو «الإنجاز»، وما الذي يتركه وشأنه، وأن يرفع صوته إن تعثّر. كل قاعدة من هذه الخمس شيء كنت ستقوله لزميل جديد في صباحه الأول.
تقنيًّا: القواعد الخمس كلها موجودة لأن الوكيل الفرعي لا يستطيع طرح سؤال استيضاحي أثناء العمل. مخطّط عائد مُعلَن يجعل المخرجات قابلة للتحليل، وبند الإبلاغ عن العوائق يحوّل الفشل الصامت إلى فشل مُبلَّغ عنه، وحدود النطاق والأدوات تقلّص المساحة التي يمكن أن يخطئ فيها دون إشراف.
متى تستخدم (ومتى لا)
مراجعات متوازية لملفات متعددة
مهام بحثية تُخرج نصاً مطوّلاً
عمل مستقل لا يحتاج سياقك
مهام مترابطة — تحتاج السياق الرئيسي
تعديلات سريعة — أسرع أن تفعلها بنفسك
عمل تفاعلي — الوكيل الفرعي لا يستطيع أن يسألك في منتصف المهمة
--bg الجلسة كوكيل يعمل في الخلفية ويعيد إليك طرفيتك، وclaude agents هو ما تتابعهم به بعد ذلك. وعندما تصل جلسة طويلة إلى مفترق طريق، يفرّع --fork-session من هذه النقطة بدل أن يطمسها، فتستطيع تجربة النسخة المحفوفة بالمخاطر دون أن تفقد الآمنة — وهو السبب نفسه لوجود --from-pr لاستئناف مراجعة من حيث توقّفت.ببساطة: التفويض له كلفة أيضاً: الشرح، والانتظار، والتسليم. أما مهمة من دقيقتين فتنجزها بنفسك. لكن إن كانت مهمة طويلة فسلّمها واذهب لعمل آخر بدل أن تقف تراقب.
تقنيًّا: القرار نسبة لا تفضيل: فوّض حين يكون حجم المخرجات الوسيطة التي تولّدها المهمة كبيراً قياساً بالملخّص الذي تُنتجه. أما المهام التي تحتاج سياق المُنادي المتراكم، أو تتطلّب استيضاحاً في منتصف الطريق، فلا يمكن تفويضها مهما كان حجمها. والعمل في الخلفية محور متعامد على ذلك — فهو يغيّر ما إذا كان عليك أنت أن تنتظر، لا ما إذا كان العمل قابلاً للتفويض، وتفريع الجلسة هو ما يجعل تجربة تبدو غير قابلة للتراجع رخيصةَ التخلّي.
الوكلاء الفرعيون المتوازيون
القوة الحقيقية: شغّل عدة وكلاء فرعيين بالتوازي على مهام مستقلة.
auth module
write tests
update API docs
ببساطة: ثلاثة أشخاص يدهنون ثلاث غرف مختلفة ينتهون في زمن دهن غرفة واحدة — ما دام أيٌّ منهم لا يحتاج السُّلَّم الذي يقف عليه الآخرون.
تقنيًّا: زمن الساعة يقترب من زمن أبطأ فرع لا من مجموع الفروع، لكن للمهام المستقلة فعلاً فقط. أي حالة مشتركة أو ترتيب متبادل بين الفروع يعيدها إلى التتابع، ويظل كل فرع ينفق رموزه الخاصة وإن لم يرها المُنادي.
المخطط نفسه، لكنه يحدث الآن
ببساطة: راقب الشريط الذي يقيس مكتبك أنت. ثلاثة أشخاص يعملون بأقصى طاقتهم ومكتبك بالكاد يمتلئ. هذه هي الحيلة كلها.
تقنيًّا: أشرطة التقدّم الثلاثة تتابع عملاً يجري داخل ثلاث نوافذ منفصلة، أما شريط السياق أسفلها فيتابع نافذة المُنادي وحدها. يُنفَق نحو 17,400 رمز عبر الفروع ويعبر نحو 200 رمز عائداً، فينفصل امتلاء نافذة المُنادي عن حجم العمل المُنجَز كله.
المخطط في الشريحة السابقة هو الخريطة. وهذه هي الرحلة. ثلاثة مساعدين يذهبون كل بدفتره، يقرأون أكثر بكثير مما ترى، ويعود كل واحد بفقرة. راقب الأشرطة الثلاثة وهي تمتلئ — ثم اقرأ السطر الأخير، فهو كل السبب في فعل هذا.تفويض الوكلاء الفرعيين
تجربة عملية: اجعل مساعدين يقرآن ورقتين في وقت واحد
ورقتان في مجلد واحد. وهما الورقتان التي تقابل الدورة بينهما دائماً — إحداهما تكتب إلى الأمام والأخرى تقرأ الجملة كاملة في مرة واحدة — فأنت تعرف تقريباً ما ينبغي أن تكون الإجابات. وهذا هو المقصود: أنت تختبر الطريقة لا تتعلّم الورقتين.
“Use a subagent to read the first paper and return only: three claims it makes, and one question it leaves unanswered.”إجابة قصيرة منظّمة. والآن لاحظ ما لم يحدث: نصّ الورقة لم يدخل محادثتك — دخل الملخّص وحده. وطلب شكل إجابة محدّد هو الجزء المهم، والخطوة التالية تُظهر لك السبب.
“In parallel, one subagent per paper: same three-claims-and-one-question shape for each. Then give me one table comparing them.”ينطلق مساعدان معاً وينتهيان بترتيب مختلف، ثم يظهر جدول مقارنة واحد. ويستغرق الأمر كله تقريباً زمن الورقة الأبطأ منهما لا مجموع زمنيهما. وبدون الشكل المحدّد من الخطوة 2 ستحصل على ملخّصين لا يمكن صفّهما جنباً إلى جنب — والمقارنة هي القيمة كلها.
/contextلم يتحرّك تقريباً — مقابل ورقتين بحثيتين كاملتين. وهذه الفجوة هي كل سبب العمل بهذه الطريقة. فلو ألصقت الورقتين بنفسك لكنت استهلكت معظم مساحتك المتاحة قبل أن تطرح سؤالك الحقيقي الأول.
تجربة عملية: وكلاء فرعيون متوازون على عدة مستودعات
ثلاثة مجلدات متجاورة. وهذه هي الخطوة الوحيدة التي تحتاج إلى الشبكة، وكل ما بعدها قراءة محلية.
claude --add-dir ../repo-b --add-dir ../repo-cتستطيع الجلسة الآن القراءة خارج المجلد الذي بدأت منه. تأكّد بـ/status. وبدون ذلك يبقى كل وكيل فرعي محصوراً في مستودع واحد وتصبح المقارنة مستحيلة.
“For each of the three folders, one subagent answers exactly: (a) what it is for, (b) how a newcomer would start using it, (c) how actively it is being worked on, (d) one risk. Nothing else.”مساعد لكل مجلد، يعملون معاً، ثم يظهر جدول. واختيار أربعة حقول قصيرة مقصود — فلو طلبت تقريراً حرّاً لحصلت على ثلاثة مقالات لا يمكن صفّها بعضها إلى جانب بعض.
“Prove your answer to (c) for the second folder by quoting the file and the line you got it from.”إشارة مرجعية يمكنك فتحها وقراءتها بنفسك. ومجموعة الإجابات جديرة بالثقة بمقدار أقل صفوفها تحقّقاً، والتحقّق من صف واحد في كل تشغيل أرخص عادة للصدق — وأرخص بكثير من كشف الخطأ بعد أن تكون تصرّفت بناءً عليه.
عند عدد معيّن تصل النتائج أبطأ ويصبح الجدول المدموج أقل دقة. التوازي محدود بمرحلة الدمج لا بعدد العاملين: فما ينسّقهم لا بد أن يحمل كل النتائج في نافذة واحدة.
أنبوب الخطافات
الخطافات تعترض الوكيل في لحظات مفصلية. انقر كل مرحلة لتستكشفها.
امنع كل نداءات Write إلى ملفات .env — فيمنع الوكيل من الكتابة فوق الأسرار سهواً.
ببساطة: باب بحارس على كل جانب. واحد يفحص ما تحمله داخلاً، والآخر يفحص ما تحمله خارجاً، ولا أحد منهما هو الوكيل — هما قواعدك أنت، ولا يمكن إقناعهما بالعدول عنها.
تقنيًّا: الخطافات برامجك أنت، تُطلَق عند أحداث دورة الحياة. ولأن خطاف PreToolUse يستطيع نقض النداء قبل تنفيذه، يعيش الفرض خارج استدلال النموذج — فتعليمة في الموجّه قد يتجاوزها سياق مُقنِع، أما رمز خروج غير صفري فلا.
أمثلة الخطافات
npx eslint --fix $FILE && npx prettier --write $FILEالأخطاء تعود إلى الوكيل، فيصلحها في الدورة نفسها.
[14:23:01] Bash: npm test
[14:23:05] Read: src/auth/middleware.js
[14:23:06] Edit: src/auth/middleware.js:22rm -rf وgit push --force، والكتابة إلى .env أو ملفات بيانات الدخول، وDROP TABLE / DELETE FROM. ويُخبر الوكيل لماذا مُنع.#dev-notifications: «انتهى الوكيل: أصلح 3 اختبارات فاشلة في وحدة المصادقة. الاختبارات الـ47 كلها تمرّ.»ببساطة: أربع مهام صغيرة لا أحد يريد تذكّرها: رتّب بعد كل تعديل، واحتفظ بيوميّات لما جرى مسّه، وارفض الطلبات الخطرة حقاً، وأخبر الفريق حين ينتهي العمل.
تقنيًّا: الأمثلة الأربعة تنقسم على ثلاث نقاط أحداث متمايزة. التدقيق التلقائي خطاف PostToolUse ويعيد إخفاقاته إلى الدورة نفسها فيصحّح الوكيل نفسه، أما حارس الأمان فخطاف PreToolUse ويجب أن يُرجع سبباً، لأن منعاً صامتاً يترك الوكيل يعيد المحاولة على غير هدى.
الأذونات والأمان
سؤال واحد يُطرح مرة واحدة: كم يُسمح له أن يفعل قبل أن يستشيرك؟ وهذه هي القيم الحقيقية التي يقبلها --permission-mode.
--allowedTools و--disallowedTools، اللذان يسمّيان ما يُسمح بتشغيله أصلاً، وخطّاف PreToolUse الذي يرفض نداءً معيّناً حتى وإن لم يكن أحد يراقب. وإذا كان الإعداد نفسه هو المتّهم، فإن --safe-mode يبدأ بكل التخصيصات مُعطّلة، ويحدّد --setting-sources أي ملفات إعدادات تُحمَّل أصلاً.ببساطة: كم يُسمح لأحدهم أن يشتري ببطاقتك قبل أن يتّصل بك؟ الجواب يختلف بين بقّالة الحيّ ومعرض السيارات — وهناك متاجر لا تعطيه البطاقة لأجلها أبداً، وهذا أمر منفصل.
تقنيًّا: آليتان مختلفتان، والخلط بينهما هو الخطأ الشائع. النمط حالة جلسة وأنت البوّابة — فهو يغيّر متى تُسأل. أما قائمة السماح أو الخطّاف فهي إعداد والقاعدة هي البوّابة — وتبقى فاعلة في تشغيل غير مراقَب لا يوجد فيه أحد ليجيب عن طلب إذن أصلاً. خفّف النمط طلباً للسرعة، واعتمد على قائمة السماح والخطّاف طلباً للأمان. والأسماء والسلوك تتغيّر بين الإصدارات، فتحقّق بـclaude --help ولا تثق بشريحة عرض.
ما هي مهارات الوكيل؟
المهارات هي مجلدات من التعليمات والسكربتات والموارد يكتشفها الوكلاء ويستخدمها عند الطلب.
ببساطة: الخبرة التي تسكن عادةً في رأس زميل واحد مخضرم، مكتوبةً في مجلد يستطيع أي أحد نسخه. وحين يسافر في إجازة، يبقى المجلد.
تقنيًّا: المهارة قطعة على مستوى نظام الملفات، فترث كل ما يمنحه نظام الملفات أصلاً: التحكم بالإصدارات، والفروق، والمراجعة، والتوزيع. ولأن الصيغة مواصفة مفتوحة لا ضبطاً خاصاً بمنتج واحد، يصبح المجلد نفسه قابلاً للنقل بين الوكلاء المتوافقين.
تشريح المهارة
كل مهارة تعيش في مجلد فيه ملف SKILL.md.
ببساطة: بطاقة وصفة عليها لافتة في أعلاها. اللافتة تقول متى تمدّ يدك إلى هذه البطاقة، وبقيتها تقول ماذا تفعل بعد أن تمسكها.
تقنيًّا: الترويسة الأمامية بصيغة YAML تُقرأ آلياً للتوجيه — الاسم والإصدار وأنماط التفعيل هي ما يقرر هل تُعرَض المهارة أصلاً. أما متن Markdown تحتها فهو ما يقرأه النموذج فعلاً، ولا يُقرأ إلا بعد أن تطابق الترويسة.
إنشاء مهارتك الأولى
المهارات يمكن أن تكون محلية للمشروع أو عامة للمستخدم أو مشتركة عبر فريقك.
mkdir -p .claude/skills/my-skillببساطة: أنشئ مجلداً، واكتب الملاحظة، وضع فيه ما تشير إليه، ثم جرّبه وأصلح ما لم يعمل. الخطوة الرابعة هي التي يتخطّاها الناس، وهي وحدها التي تقول لك الحقيقة.
تقنيًّا: خطوتان من الأربع قرارا موضع لا قرارا تأليف. وضع .claude/skills/ داخل المشروع يجعل المهارة تسافر مع المستودع وتنطبق على المتعاونين، أما المجلد نفسه تحت دليل المستخدم فيبقيها شخصية وينطبق على كل مشروع تفتحه.
الإعدادات والمهارات متعددة الملفات
المهارات المعقدة تستخدم ملفات متعددة لجوانب مختلفة من سير العمل.
ببساطة: كتاب طبخ فيه فهرس. أنت لا تقرأ ثلاثمئة صفحة لتُعِدّ طبقاً واحداً — تقرأ الفهرس، ثم الصفحة الواحدة التي تحتاجها.
تقنيًّا: الحجم المثبَّت والحجم المُحمَّل رقمان مختلفان. ملف SKILL.md وحده مضمون الدخول إلى نافذة السياق، أما ملفات الموارد فيُشار إليها بالاسم وتُجلَب عند الطلب، فيكون لمجلد مهارة ضخم كلفةٌ مقيمةٌ صغيرة.
حمّل 3 ملفات من 6 — شاهده يختار
ببساطة: لم تكن مضطراً إلى تسمية الوصفة. قلت ما تريده على العشاء فنزلت البطاقة الصحيحة عن الرف — ولم يُقرأ بصوت عالٍ إلا ما يهمّ من صفحاتها.
تقنيًّا: آليتان تعملان هنا في آن واحد. مطابقة شرط التفعيل تختار المجلد من طلب بلغة عادية دون أي أمر مائل، ثم يحمّل الإفصاح التدريجي مجموعة جزئية من ملفات ذلك المجلد، فينمو القطاع الأخضر بمقدار ما قُرئ لا بمقدار ما ثُبِّت.
المهارة قد تُثبّت مئة صفحة وتقرأ أربعاً منها. أربع مهارات مثبَّتة أدناه، ومطويّة. اوصف مهمة بلغة عادية — كما في أزرار التلميح أدناه: المجلد المطابق يُفتح، ويُوسم كل ملف بـ ✓ محمَّل أو ⊘ متجاهَل، وتنمو الشريحة الخضراء بمقدار ما قُرئ بالضبط — لا بمقدار ما ثُبِّت.الإفصاح التدريجي
نظام المهارات البيئي
مهارات الوكيل هي معيار مفتوح معتمد من أكثر من 25 أداة تطوير ذكاء اصطناعي.
ببساطة: أشبه بشكل قابس اتفقت عليه كل الدول. جهازك يعمل حين تنتقل إلى بيت جديد، ولست حبيس صانع واحد لأن محوّلاتك لا تناسب سواه.
تقنيًّا: تبنّي شركات متنافسة للصيغة هو ما يحوّل ملف ضبط إلى معيار: يصير مجلد المهارة أصلاً قابلاً للنقل بدل أن يكون كلفة انتقال. مرتبط بالزمن — قائمة الأدوات في هذه الشريحة لقطة لحظية، فعامل العدد على أنه توضيحي لا راهن.
مشاركة وتوزيع المهارات
المهارات مجرد مجلدات — شاركها كأي كود آخر.
~/.claude/skills/ للمهارات الشخصية في كل مشاريعك.ببساطة: إنه مجلد. أنت تعرف أصلاً أربع طرق لتعطي أحدهم مجلداً، والأربع كلها تنفع هنا.
تقنيًّا: المسارات الأربعة تختلف في النطاق لا في الآلية. الإيداع في المستودع يربط المهارة بمشروع واحد وبالمتعاونين عليه، ونشرها كحزمة يفصل إصدار المهارة عن إصدار المشروع المستهلك، أما موضع دليل المستخدم فينطبق على كل مشروع لكنه يسافر معك أنت لا مع الكود.
استكشاف أخطاء المهارات
.claude/skills/)، أو اسم الملف ليس SKILL.md بحرفه، أو فواصل الواجهة الأمامية YAML مكسورة، أو لا شرط تشغيل مطابق. للتشخيص: claude --debug "skills".**/*.yaml يطابق كل ملف YAML — واسع أكثر من اللازم. و**/deploy*.yaml يطابق إعدادات النشر وحدها. وsrc/components/**/*.tsx مكوّنات React وحدها. والراية --verbose تُظهر أي المهارات انطلقت.SKILL.md دون 500 سطر، واجعل أنماط التشغيل ضيّقة، ومهارة واحدة لكل مجال، وادفع التفاصيل إلى ملفات موارد لا تُحمَّل إلا عند قراءتها.ببساطة: حين لا تفعل المهارة شيئاً، فالسبب لا يكاد يكون الصياغة — بل الأرشفة. الدرج الخطأ، أو اللافتة الخطأ على الواجهة، أو لافتة مبهمة إلى حد أنها تُفتح لكل شيء.
تقنيًّا: ثلاثة من أنماط الفشل الأربعة إخفاقات اكتشاف لا إخفاقات تعليمات: المسار واسم الملف وتحليل الترويسة الأمامية تحدث كلها قبل أن يُقرأ المتن أصلاً. أما الرابع فأنماط تفعيل أوسع من اللازم، حيث تُحمَّل المهارة بنجاح وما كان ينبغي لها.
تجربة عملية: ثبّت مهارة كتبها شخص آخر
“Build a single-file HTML pricing page for a small product. No frameworks.”صفحة تعمل وتبدو كـ HTML مولّد افتراضي. احفظها. فهي الدليل الوحيد الذي سيكون لديك على أن تثبيت المهارة أحدث فرقاً — وبدونها تصبح عبارة «المهارة حسّنت النتيجة» غير قابلة للتكذيب.
المجلد موجود وفيه SKILL.md. وترويسته تحتاج حقلين فقط، الاسم والوصف — والوصف ليس توثيقاً بل هو المُطلِق الذي يطابق النموذج طلبك عليه.
/exit then claudeتظهر المهارة بين مهاراتك المتاحة مع وصفها المختصر. وتُكتشف المهارات عند بدء الجلسة، فالمهارة المثبّتة في منتصف الجلسة قد لا تظهر حتى تعيد التشغيل — وهذا أشيع سبب لأن تبدو مهارة مكتوبة بشكل صحيح بلا أثر.
ناتج مختلف بوضوح — تدرّج خطوط حقيقي، ومسافات مدروسة، ولوحة ألوان مختارة. لم تطلب شيئاً من ذلك، ومع هذا طُبِّق. هذا هو معنى المهارة: تعليمات تنطلق عند المناسبة لا عند المناداة.
مثال: هيكل مهارة العرض التقديمي
style-guide.md وحده.ببساطة: بطاقة الوصفة لا تحتوي الكعكة. هي تخبرك أي قالب وأي درجة فرن وأين تُحفظ تعليمات التزيين — فيغيّر تغييرُ التزيين كل كعكة دون إعادة كتابة البطاقة.
تقنيًّا: فصل التوجيه عن المحتوى هو ما يجعل المهارة قابلة للصيانة. شكل المخرجات يعيش في ملف موارد، فيسري تعديل واحد في style-guide.md على كل ما تنتجه المهارة، ويبقى SKILL.md دون الحجم الذي يبدأ عنده منافسة السياق.
تجربة عملية: ألّف مهارة لعروض HTML واتركها تسألك
تظهر في قائمة مهاراتك. ولم يُولَّد شيء بعد — وهذا صحيح: فالخطوة التالية هي حيث تعرف ما تحتاج إلى معرفته.
“Use skill-creator to build a skill that generates self-contained HTML presentations from an outline. Interview me first — ask about slide layouts, theme and colours, fonts, how to handle speaker notes, where to save output, and whether to deploy — then write it.”أسئلة لا ملف. وهذا هو مقصد البداية بأكمله: تسألك عن التنسيقات واللوحة والخطوط والملاحظات قبل أن تكتب شيئاً، فيصف ملف SKILL.md عرضك أنت لا عرضاً عامّاً. والمهارة المكتوبة بلا أسئلة تُرسّخ إعدادات النموذج الافتراضية لا معاييرك.
cat .claude/skills/html-presentation/SKILL.mdترويسة فيها اسم ووصف، ومتن تعليمات قصير، وإشارات إلى أي ملفات مرجعية أطول. ودقّق في الوصف أكثر من غيره — فهو المُطلِق، والوصف الغامض يعني مهارة لا تنطلق أبداً مهما كان المتن جيداً.
“Using that skill, make a six-slide deck explaining how HTTP caching works.”ملف HTML واحد يُفتح في المتصفّح ويطابق الخيارات التي قدّمتها أثناء الأسئلة. وإذا لم يطابقها فإن الخلل في SKILL.md لا في العرض — أصلح التعليمات وأعِد التوليد.
git add .claude/skills && git commit -m "Add html-presentation skill"أصبحت المهارة ناتجاً مُدار الإصدارات يحصل عليه زميلك بمجرّد git pull — لا حالة جلسة تنتهي بإغلاق نافذتك. وهذا هو الفرق بين حيلة تعرفها وقدرة يملكها فريقك.
.claude/agents/reviewer.md تضبط ترويسته name وdescription يوضّح متى يُستخدم وtools: Read, Grep, Glob.ملف قصير بترويسة YAML. كل وكيل فرعي في هذا المقرر حتى الآن كان آنيّاً — وصفته بجملة، وانتهى بانتهاء الجلسة. أما هذا فهو مُسمّى وقابل لإعادة الاستخدام ومرفوع في المستودع. وسطر tools هو جوهر الفكرة: المراجع الذي لا يستطيع الكتابة لا يمكنه أن «يساعد» بإصلاح ما طُلب منه أن يحكم عليه. استخدم وكيلاً معرَّفاً حين تريد الدور نفسه مراراً بالحدود نفسها دون إعادة وصفه كل مرة. ستة أساليب كلها تضيف قدرة ويُخلط بينها دائماً: CLAUDE.md هو ما يصحّ دائماً عن المشروع، والمهارة إجراء مع ملفات، والأمر المختصر نص طلب مللت إعادة كتابته، والوكيل الفرعي سياق ثانٍ ينفّذ عملاً محدَّداً، والخطّاف قاعدة تنطلق سواء راقب أحد أم لا، وخادم MCP يصل إلى نظام خارج مستودعك. حقائق، وإجراءات، وتوسّع، وسلامة، ووصول — وتحقّق من المسارات الدقيقة بـ/help في إصدارك ولا تثق بأي قائمة، بما فيها هذه.
تنسيق الوكلاء
وكيل منسق يفوض المهام الفرعية للمتخصصين. انقر على وكيل لرؤية دوره.
ببساطة: لا بد لأحدهم أن يكون مدير الموقع. لا لأنه يرصف الطوب، بل لأن أحداً يجب أن يقرر من يبدأ الآن ومن ينتظر الجدران.
تقنيًّا: المنسّق هو من يحمل مخطّط التبعيات. يفكّك الطلب، ويرسل الفروع المستقلة على التوازي، ويحجز الفروع التابعة حتى تصل مدخلاتها، ثم يركّب العائدات — ولهذا يظهر وكيل الاختبار «في الانتظار» بينما يظهر وكيلا الخلفية والواجهة «قيد التشغيل».
طلب واحد، أربع عشرة خطوة
ببساطة: كل قطعة في هذه الوحدة، في صورة واحدة، وسؤالك يمشي فيها. تابع النقطة: تدخل من طرف جملةً وتخرج من الطرف الآخر جواباً.
تقنيًّا: حلقتان تحملان المعمارية كلها. الداخلية بين النموذج وبيئة التشغيل — وهي حلقة الوكيل من الوحدة الرابعة. والخارجية بين بيئة التشغيل والعالم، تمدّ يدها إلى المهارات طلباً للتعليمات، وإلى خوادم MCP طلباً للبيانات، وإلى الوكلاء الفرعيين لعمل لا ينبغي أن يُحتسب على هذه النافذة.
كل ما في هذه الوحدة في صورة واحدة، والطلب يتحرك داخلها. تطلب شيئاً؛ فيدور الوكيل بين النموذج والكود، ويسحب مهارة، وينادي عبر خوادم MCP بيانات حقيقية، ويدفع شريحتين من العمل إلى وكيلين فرعيين. شغّلها مرة، ثم امشِ فيها خطوة خطوة.معمارية الوكيل
أنت تصفه، والوكيل يكتبه
الذي تغيّر هو مَن يطبع الحروف. أنت ما زلت تقرّر ما يجب أن يفعله البرنامج، وما زال عليك أن تتحقّق أنه يفعله — لكنك تقوله بلغتك بدل أن تطبعه بلغة برمجة. وقد سمّى أندريه كارباثي نصفَي هذا التحوّل.vibe codingSoftware 3.0
ببساطة: صرت الآن الشخص الذي يقول ماذا يجب أن يفعل المبنى ويطوف في آخر اليوم ليتحقق. غيرك يمسك المِسْطَرين. أما أن تقول ما تريد وأن تتأكد أنك حصلت عليه فما زالا عملك — وهما الجزء الصعب.
تقنيًّا: صياغة Karpathy عام 2025 هي أن اللغة الطبيعية تصير طبقة التأليف بينما يبقى الكود المولَّد هو القطعة التي تعمل. وعبء التحقق لا ينتقل مع الكتابة: المراجع ما زال يحتاج من النموذج الذهني ما يكفي ليميّز المخرجات الصحيحة من المخرجات المعقولة الشكل.
الموارد والتعلم الإضافي
عمّق مهاراتك مع هذه الدورات والمراجع الرسمية.
اختبار المعرفة
ثمانية أسئلة على هذه الوحدة. أجب لترى السبب — يظهر الشرح سواء أصبتَ أم أخطأت.