إنتقل إلى المحتوى الرئيسي

سير العمل الاحترافي والحركات المتقدمة

متقدّم
What you'll learn
  • نسّق الوكلاء الفرعيين المتوازيين — واعرف متى تنتقل إلى سير عمل ديناميكي مدفوع بسكربت
  • اجعل الـ hooks الغراء الحتمي: التدقيق عند الحفظ، إيقاف نهاية الدور بشرط، حظر الكتابات الممنوعة
  • حوّل مطالباتك المتكررة إلى أوامر مختصرة مخصّصة ومهارات ونمط إخراج
  • ابنِ مكدّس MCP وخطوط أنابيب بلا واجهة (claude -p) تعمل دون إشراف في الـ CI
  • شغّل حلقة الاستكشاف ← التخطيط ← التنفيذ ← المراجعة بانضباط، وأبقِ السياق رشيقاً
  • عامل CLAUDE.md كأنه كود: قصير ومُقلَّم وعالي الإشارة

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

النموذج الذهني: مَن يمسك بالخطة؟

كل حركة متقدمة أدناه هي إجابة مختلفة على سؤال واحد — مَن يمسك بالخطة وبالنتائج الوسيطة؟ تُوضّح ذلك بدقّة الصياغة التي طرحتها Anthropic نفسها لميزة سير العمل الديناميكي الجديدة:

الأداةمَن يقرّر ما يُشغَّل تالياًأين تعيش النتائجالمقياس
الوكلاء الفرعيونClaude، دوراً بعد دورنافذة سياق Claudeعدد قليل لكل دور
المهاراتClaude، متّبعاً المطالبةنافذة سياق Claudeمثل الوكلاء الفرعيين
فِرق الوكلاءوكيل قائد، دوراً بعد دورقائمة مهام مشتركةحفنة من الأقران طويلي الأمد
سير العمل الديناميكيالسكربتمتغيّرات السكربتعشرات إلى مئات

التدرّج هو اللعبة كلها: ابدأ بـ Claude واحد، وفوّض إلى الوكلاء الفرعيين لحماية السياق، ولا تنقل الخطة إلى الكود إلا حين تحتاج مهمة إلى وكلاء أكثر مما يمكن لمحادثة واحدة أن تنسّقه.

الحركة 1 — وكلاء فرعيون متوازيون، ثم الترقية إلى سير عمل

الوكيل الفرعي هو Claude منفصل بنافذة سياق خاصة به ومجموعة أدوات محدودة النطاق؛ يُعيد نتيجة، لا نصّ محادثته. عادة المستخدم المتقدم هي توزيع العمل المستقل:

وزّع مراجعة عبر الوحدات

Review the changes in auth/, billing/, and api/ — use the code-reviewer
subagent on each, in parallel. Report only correctness bugs and missing tests.

ثلاثة مُراجعين يعملون دفعة واحدة، كلٌّ يستهلك سياقه الخاص على الفروقات، وجلستك الرئيسية ترى ثلاثة تقارير مرتّبة بدلاً من ثلاث فروقات خام. المأزق: التوازي لا يفيد إلا للمهام الفرعية المستقلة. إذا احتاجت الخطوة B إلى مُخرَج الخطوة A، فشغّلهما بالتسلسل؛ وإذا كانتا تكتبان الملفات نفسها، فاعزلهما في git worktrees.

حين تتجاوز المهمة محادثة واحدة — هجرة لـ 500 ملف، أو مسح للأخطاء على مستوى قاعدة الكود بأكملها، أو بحث مُتحقَّق منه بالمقارنة عبر مصادر كثيرة — فترقَّ إلى سير عمل ديناميكي. يكتب Claude سكربت تنسيق بـ JavaScript (توزيع ← اختزال ← تركيب)، وبيئة تشغيل تنفّذه في الخلفية بما يصل إلى 16 وكيلاً متزامناً، ولا تصل إلى سياقك إلا الإجابة النهائية فقط. أطلق واحداً بالكلمة المفتاحية ultracode أو فقط اطلب بكلمات عادية:

ابدأ سير عمل ديناميكي

ultracode: audit every API endpoint under src/routes/ for missing auth checks,
then cross-check each finding with a second agent before reporting

الميزة القاتلة ليست مجرد مزيد من الوكلاء — بل إن السكربت يستطيع تطبيق نمط جودة قابل للتكرار، مثل جعل وكلاء مستقلين يراجعون نتائج بعضهم خصومياً قبل الإبلاغ عن أيٍّ منها. جرّب الأمر المُضمَّن /deep-research <question> لترى النمط حياً: يصوّت على كل ادّعاء ويُصفّي تلك التي لا تصمد أمام التحقّق المتقاطع.

Pro tip
  • احفظ تشغيلة سير عمل جيدة كأمر: افتح /workflows، اختر التشغيلة، اضغط s. تصبح /اسمك في كل جلسة مستقبلية.
  • قِس التكلفة على شريحة أولاً — دليل واحد، لا المستودع بأكمله. يمكن لتشغيلة أن تولّد وكلاء (ورموزاً) أكثر بكثير من محادثة واحدة.

الحركة 2 — الـ Hooks: الغراء الحتمي

تعليمات CLAUDE.md استشارية — عادة ما يتّبعها Claude. الـ Hooks حتمية — تُشغّل سكربتاً عند نقطة ثابتة في الحلقة، مضموناً، في كل مرة. استدعِ hook حين يجب أن يحدث شيء بلا استثناء.

أنماط الـ hook الثلاثة الأعلى رافعةً:

Guided walkthrough1 of 3
  1. بعد أن يعدّل Claude ملفاً، شغّل المُنسّق أو المُدقّق آلياً كي لا تنحرف قاعدة الكود أبداً. كما تتدفّق التغذية الراجعة عائدةً إلى Claude، فيصحّح نفسه ذاتياً.

لست مضطراً لكتابة الـ JSON يدوياً. اطلب من Claude تأليف الـ hook نيابةً عنك:

اجعل Claude يكتب hook

Write a hook that runs eslint --fix after every file edit, and a second hook
that blocks any Write or Edit to the db/migrations/ folder. Add them to
.claude/settings.json and show me the config.
Watch out
  • سيتم تجاوز hook من نوع Stop يستمرّ في المنع بعد عدة عمليات منع متتالية كي لا تتجمّد الجلسة في طريق مسدود — قيدك حاجز أمان، لا حلقة لا نهائية.
  • تعمل الـ hooks بصلاحيات صدفتك. راجع أي سكربت hook قبل إيداعه، تماماً كما تفعل مع إعدادات الـ CI.

الحركة 3 — الأوامر المختصرة المخصّصة والمهارات وأنماط الإخراج

أي شيء تطالب به مرتين ينبغي أن يصير عنصراً أساسياً. القرار بسيط: المهارات معرفة، والـ hooks ضمانات، وMCP فعل، والأوامر المختصرة نقاط دخول.

الأمر المختصر (أو مهارة بـ disable-model-invocation: true) يُغلِّف سير عمل قابلاً للتكرار تُطلقه يدوياً. تجعله $ARGUMENTS ذا معاملات:

.claude/skills/fix-issue/SKILL.md

---
name: fix-issue
description: Triage and fix a GitHub issue end-to-end
disable-model-invocation: true
---
Fix GitHub issue $ARGUMENTS:
1. gh issue view to read the issue
2. Search the codebase for the relevant files
3. Write a failing test that reproduces the bug
4. Implement the fix, then run tests and lint until green
5. Commit with a descriptive message and open a PR

شغّله بـ /fix-issue 1234. استخدم disable-model-invocation: true لأي شيء له آثار جانبية تريد إطلاقه بشكل متعمّد بدلاً من أن يلجأ إليه Claude من تلقاء نفسه.

تُغيّر أنماط الإخراج كيف يتواصل Claude عبر الجلسة بأكملها — مقتضب لخبير، مُسهَب مع شروحات للتعليم، أو تنسيق مُهيكَل تستطيع أدواتك تحليله. اقرن أمراً مختصراً مخصّصاً (الـ ماذا) بنمط إخراج (الـ كيف) وتكون قد شكّلت طرفَي التفاعل معاً.

الحركة المتقدمة الأقل استخداماً من الوثائق الرسمية: دع Claude يُجري معك مقابلة قبل ميزة كبيرة، ثم ابدأ جلسة جديدة للبناء انطلاقاً من المواصفة المكتوبة.

المواصفة بالمقابلة، ثم البناء في سياق نظيف

I want to build [brief description]. Interview me in detail using the
AskUserQuestion tool — technical implementation, UI/UX, edge cases, tradeoffs.
Dig into the hard parts I might not have considered. When we've covered
everything, write a complete, self-contained spec to SPEC.md.

الحركة 4 — ابنِ مكدّس MCP

خوادم MCP عمليات قابلة للتنفيذ يستدعيها Claude عبر JSON-RPC لكي يفعل الأشياء فعلاً — يستعلم قاعدة بياناتك، يقرأ Sentry، يجلب تصميم Figma، يفتح مشكلة في Linear. "مكدّس" المستخدم المتقدم مجموعة صغيرة ومتعمّدة، لا كل ما يمكنك إيجاده:

أضف خوادم إلى مكدّسك

claude mcp add --transport stdio sentry -- npx -y @sentry/mcp-server
claude mcp add --transport http linear https://mcp.linear.app/sse

مبدآن يُبقيان مكدّس MCP سريعاً:

  • فضّل CLI حين يوجد. gh وaws وgcloud وsentry-cli هي أكثر الطرق كفاءةً في السياق للتحدّث إلى خدمة — فـ Claude يعرفها أصلاً، وهي لا تُحمّل مخطط أداة في كل دور. احتفظ بـ MCP للخدمات التي لا تملك CLI جيداً، أو حيث تريد وصولاً مُهيكلاً ومُحدَّد الأنواع.
  • أبقِ قائمة الخوادم رشيقة. تستهلك تعريفات أدوات كل خادم متّصل سياقاً مقدّماً. قلّم الخوادم التي لا تستخدمها فعلياً؛ فقوائم الأدوات المتضخّمة تزاحم تعليماتك الفعلية.

للسبب الأعمق، راجع هندسة السياق — فمنطق ميزانية الانتباه نفسه الذي يحكم CLAUDE.md يحكم قائمة أدواتك.

الحركة 5 — خطوط أنابيب بلا واجهة وAgent SDK

يُشغّل claude -p "prompt" Claude بشكل غير تفاعلي — بلا جلسة، بمخرَج قابل للتحليل — وهو الباب إلى الـ CI، وhooks ما قبل الإيداع، والمهام الدُّفعية. هذا هو سطح بلا واجهة / Agent SDK.

نمط التوزيع-عبر-الملفات الكلاسيكي من دليل أفضل الممارسات الرسمي:

هجرة دُفعية بلا واجهة

# 1. Have Claude generate the work list first, then loop:
for file in $(cat files.txt); do
claude -p "Migrate $file from React to Vue. Return OK or FAIL." \
  --allowedTools "Edit,Bash(git commit *)"
done

عَلَمان يقومان بالعمل الثقيل: --output-format json (أو stream-json --verbose) يجعل النتائج قابلة للقراءة آلياً، و--allowedTools يحدّد بدقّة ما يجوز لـ Claude لمسه حين لا يراقبه إنسان. مرّره إلى أي مكان:

Claude كمرحلة في خط أنابيب

cat error.log | claude -p "Cluster these errors by root cause, output JSON" \
--output-format json | jq '.[] | select(.severity=="high")'
Watch out
  • اختبر المطالبة دائماً على عنصرين أو ثلاثة قبل إطلاق الحلقة على 2,000. صقِّل، ثم وسّع.
  • التشغيلات دون إشراف تحتاج إلى تحقّق مُضمَّن — hook من نوع Stop أو خطوة اختبار داخل المطالبة — وإلا تكون قد أتمتت إنتاج مُخرَج معقول-لكن-خاطئ على نطاق واسع.

الحركة 6 — انضباط وضع التخطيط وهندسة السياق

أكثر رافعة جودة موثوقية على الإطلاق هي فصل البحث عن التنفيذ. الحلقة رباعية الأطوار من دليل أفضل الممارسات لدى Anthropic:

Guided walkthrough1 of 4
  1. ادخل وضع التخطيط. يقرأ Claude الملفات ويجيب عن الأسئلة لكنه لا يُجري أي تغييرات. وجّهه إلى الأدلّة الدقيقة: 'اقرأ /src/auth واشرح كيف تعمل الجلسات.'

راجع وضع التخطيط للانضباط، وتجاوزه حين يتّسع الفرق في جملة واحدة — فللتخطيط عبء إضافي. السبب في نجاح هذا هو اقتصاد السياق: يتدهور الأداء كلما امتلأت النافذة، فتعليمة بـ 50 رمزاً في سياق بـ 2,000 رمز تنزل أقوى بكثير من التعليمة نفسها مدفونة في 50,000 رمز. عادات عملية:

  • /clear بين المهام غير المترابطة؛ جلسة نظيفة بمطالبة أفضل تتفوّق على جلسة طويلة ملوّثة.
  • بعد تصحيحَين فاشلَين، توقّف عن التصحيح — /clear وأعد كتابة المطالبة بما تعلّمته.
  • فوّض البحث إلى الوكلاء الفرعيين كي تحدث قراءة الملفات في سياقهم هم، لا سياقك.

مسار "ارفع مستوى إعدادك"

إن لم تفعل شيئاً آخر، فافعل هذه بالترتيب:

Guided walkthrough1 of 6
  1. شغّل /init للبدء، ثم احذف كل سطر يفشل في الاختبار: 'هل سيتسبّب حذف هذا في خطأ من Claude؟' الملف المتضخّم يجعل Claude يتجاهل القواعد المهمّة.

إتقان CLAUDE.md

يُحمَّل CLAUDE.md عند بداية كل محادثة، فهو السياق الأعلى تكراراً الذي تتحكّم فيه — وبالتالي الأسهل إفساداً بالحشو الزائد.

ضع في CLAUDE.mdأبقِه خارجاً
أوامر Bash لا يستطيع Claude تخمينهاأي شيء يجده Claude بقراءة الكود
قواعد نمط الكود التي تختلف عن الافتراضاتالأعراف القياسية التي يعرفها Claude أصلاً
مُشغّل الاختبارات + كيفية تشغيل اختبار واحدوثائق الـ API الكاملة (ضع رابطاً بدلاً منها)
آداب المستودع (تسمية الفروع/الـ PR)معلومات تتغيّر باستمرار
المزالق غير البديهية وغرائب البيئةعبارات "اكتب كوداً نظيفاً" المبتذلة

عامله كأنه كود: راجعه حين يخطئ السلوك، قلّم بانتظام، واستخدم استيرادات @path/to/file بالإضافة إلى ملفات CLAUDE.md لكل دليل كي يحصل كل جزء من المستودع أحادي الريبو على ما هو ذو صلة فقط. انقل المعرفة ذات الصلة أحياناً إلى المهارات كي تُحمَّل عند الطلب بدلاً من إثقال كل دور.

اختبر نفسك

0/4
  1. تحتاج إلى تنسيق هجرة لـ 500 ملف مع تحقّق متقاطع خصومي. أي أداة تناسب أكثر؟
  2. ما الفرق الجوهري بين hook وتعليمة CLAUDE.md؟
  3. أي عَلَم يحدّد ما يجوز لـ Claude فعله أثناء تشغيلة دُفعية بلا إشراف بـ `claude -p`؟
  4. لماذا يُحسّن تقليم CLAUDE.md الالتزام به؟
استرجاع الحركات المتقدمة — اقلب كل بطاقة
اضغط Enter أو مفتاح المسافة لقلب البطاقة. استخدم مفتاحي السهمين الأيسر والأيمن للتنقل بين البطاقات.تم إظهار المصطلح.
1 / 5
Key takeaways
  • التدرّج هو المهارة: Claude واحد ← وكلاء فرعيون متوازيون ← سير عمل ديناميكي مدفوع بسكربت، يُختار حسب مَن يحتاج إلى الإمساك بالخطة.
  • الـ hooks هي الغراء الحتمي — تدقيق عند الحفظ، تقييد نهاية الدور، حظر الكتابات الممنوعة — لما يجب أن يحدث في كل مرة.
  • غلّف المطالبات المتكررة في أوامر مختصرة/مهارات، وشكّل التسليم بنمط إخراج، وأبقِ مكدّس MCP رشيقاً (فضّل أدوات CLI).
  • claude -p بلا واجهة مع --allowedTools يحوّل Claude إلى مرحلة CI/خط أنابيب؛ ضمّن دائماً التحقّق في التشغيلات دون إشراف.
  • انضباط وضع التخطيط بالإضافة إلى اقتصاد سياق صارم (/clear، بحث الوكلاء الفرعيين، CLAUDE.md مُقلَّم) هو أعلى رافعة موثوقية لديك.

المصادر وقراءات إضافية