سير العمل والأتمتة

Claude Code بيتحوّل من مساعد تفاعلي لعضو فعلي في الفريق لما توصّله ببنية الأتمتة بتاعتك. الموديول ده بيغطي تكامل CI/CD، المهام المجدولة، تكامل GitHub Actions، وأنماط بناء سير عمل أتمتة موثوقة.

تكامل CI/CD مع التشغيل البرمجي

الـ flag claude -p هو أساس تكامل CI/CD. بيشغّل Claude بدون تفاعل، بيبعت prompt، وبيرجّع النتيجة على stdout. ادمجه مع --output-format json عشان output منظّم قابل للتحليل، و--permission-mode bypassPermissions للتشغيل الآلي الكامل (بدون أي طلبات موافقة)، و--max-turns عشان تحدد وقت التنفيذ.

نمط شائع هو تشغيل Claude كجزء من عملية مراجعة الـ PR. ضبطه كخطوة في GitHub Actions:

- name: Claude Code Review
  run: |
    DIFF=$(git diff origin/main...HEAD)
    REVIEW=$(echo "$DIFF" | claude -p "Review these changes. Output JSON with fields: summary, critical_issues, suggestions" \
      --output-format json \
      --permission-mode bypassPermissions)
    echo "$REVIEW" | jq '.critical_issues[]' >> $GITHUB_STEP_SUMMARY

الـ flag --from-pr بيبدأ جلسة من pull request موجود. بيجيب الـ diff والوصف وتعليقات المراجعة عشان Claude يقدر يبدأ في إصلاح أو توسيع ملاحظات الـ PR فورًا. من v2.1.119، --from-pr بيقبل روابط من GitHub و GitHub Enterprise و GitLab merge requests و Bitbucket pull requests:

claude --from-pr https://github.com/org/repo/pull/123
claude --from-pr https://gitlab.com/org/repo/-/merge_requests/456
claude --from-pr https://bitbucket.org/org/repo/pull-requests/789

للأتمتة اللي بتستخدمها مرة واحدة، Claude يقدر يولّد tests لكود جديد، يحدّث الـ documentation لما الـ APIs تتغيّر، يشغّل linters ويصلّح المشاكل تلقائيًا، أو يفحص ثغرات أمنية. استخدم --no-session-persistence عشان ما يحفظش جلسة، واستخدم --bare لما تحتاج أنظف output ممكن في الـ scripts.

استخدم prUrlTemplate (جديد في v2.1.119) عشان توجّه الـ footer PR badge لرابط مراجعة كود مخصص بدل رابط github.com الافتراضي — مفيد لـ enterprise deployments اللي عندها GitHub داخلي أو أدوات مراجعة مخصصة:

{
  "prUrlTemplate": "https://review.example.internal/pr/{number}"
}

أمر /install-github-app بيعمل setup للتكامل الرسمي مع GitHub، واللي بيخلّي Claude يرد على منشنات @claude في تعليقات الـ PR والـ issues.

الإشعارات الفورية على الموبايل (Mobile Push Notifications)

لما الـ Remote Control مفعّل، Claude يقدر يبعت إشعارات فورية على موبايلك. Claude بيقرر إمتى يبعت — عادةً لما مهمة طويلة تخلص أو لما يحتاج قرار منك عشان يكمّل. كمان ممكن تطلب واحد في الـ prompt: notify me when the tests finish. الإعداد محتاج تطبيق Claude على الموبايل (iOS أو Android)، مسجّل بنفس الحساب، وPush when Claude decides مفعّل في /config. غير زر التفعيل والإيقاف، مفيش ضبط لكل حدث على حدة. محتاج Claude Code v2.1.110+.

لمراقبة الـ PRs التلقائية، /autofix-pr بيعمل جلسة Claude Code على الويب بتراقب PR الـ branch الحالي. لما CI يفشل أو reviewer يعلّق، Claude بيحقق ويدفع fix. حدد النطاق بـ prompt: /autofix-pr only fix lint and type errors. محتاج Claude GitHub App يكون متثبّت على الريبو، access لـ Claude Code على الويب، ومش متاح للمؤسسات الليفعّلوا Zero Data Retention.

/ultrareview (جديد في v2.1.86، تم إبرازه في v2.1.112) بيعمل مراجعة شاملة للكود في cloud باستخدام analysis وcritique من multi-agent متوازية. محتاج تسجيل دخول بـ Claude.ai — لو مسجّل بـ API key بس، شغّل /login الأول. بيشتغل على بنية Claude Code على الويب. استدعيه من غير arguments عشان تراجع الـ branch الحالي، أو /ultrareview <PR#> عشان تجيب وتراجع PR محدد من GitHub. Pro/Max بياخدوا ٣ runs مجانية لمرة واحدة (مخصصة مرة واحدة لكل حساب، مبتتجددش)، وبعدين كل مراجعة بتكلف تقريبًا $٥–$٢٠ كـ extra usage. Team/Enterprise مفيش ليهم runs مجانية وبيتحسبوا كـ extra usage. الـ extra usage لازم يكون مفعّل على الحساب — لو معطّل، Claude Code هيمنع التشغيل وريمكنك لرابط إعدادات الـ billing. استخدم /tasks عشان تتابع المراجعات اللي شغّالة واللي خلصت، تفتح تفاصيل مراجعة، أو توقف مراجعة في الطريق (التوقيف بحفظ الجلسة السحابية؛ النتائج الجزئية مبتتنزلش). راجع الوثائق الرسمية عشان تتأكد من توافر /ultrareview على منصتك. الـ dynamic workflows متاحة على كل الخطط المدفوعة على Amazon Bedrock و Google Cloud Vertex AI و Microsoft Foundry (Claude Code v2.1.154+).

/ultrareview           # راجع الـ branch الحالي
/ultrareview 456       # راجع PR #456 من GitHub

المهام المجدولة والـ Routines والأتمتة في الخلفية

Claude Code بيدعم طبقات جدولة متعددة. /loop بيعمل فحوصات متكررة داخل الجلسة طول ما Claude Code شغّال. الـ Routines هي مهام مجدولة في الـ cloud بتفضل شغّالة مستقلة عن الـ terminal المحلي — كل run بيعمل clone جديد للريبو، يشتغل لوحده، ويقدر يعمل push لـ branches أو يفتح PRs.

# فحص حالة البناء كل 5 دقائق (داخل الجلسة)
/loop 5m check if the build succeeded and summarize any failures

# إنشاء routine سحابي من الـ CLI
/schedule "run a full security audit at 2am"
/schedule daily PR review at 9am

الـ Routines

الـ routine هو إعداد Claude Code محفوظ — prompt وريبو واحد أو أكتر ومجموعة connectors — بيتحزم مرة واحدة ويشتغل تلقائيًا على بنية Anthropic التحتية المُدارة. أنشئهم وأدِرهم من الويب على claude.ai/code/routines، أو من الـ Desktop app، أو عبر /schedule في الـ CLI. استخدم /schedule list لعرض كل الـ routines، و/schedule update لتعديل واحد، و/schedule run لتشغيل واحد فورًا.

كل routine ممكن يكون عنده أكتر من trigger مع بعض:

• مجدول — تكرار دوري (كل ساعة، يومي، أيام العمل، أسبوعي) أو تشغيل لمرة واحدة في وقت محدد. التشغيل لمرة واحدة مش بيتحسب من الحد اليومي. cron expressions مخصصة متاحة عبر /schedule update (أقل فاصل: ساعة).
• API — endpoint HTTP مخصص لكل routine. ابعت POST بـ bearer token عشان تشغّل run، مع إمكانية تمرير سياق في حقل text. وصّله بأنظمة التنبيه أو pipelines النشر أو الأدوات الداخلية.
• GitHub — بيتفاعل مع أحداث الريبو زي pull requests أو releases. الفلاتر بتخلّيك تضيّق حسب المؤلف والعنوان والـ labels والـ base/head branch وحالة الـ draft وغيرها. محتاج Claude GitHub App متثبّت على الريبو.

الـ routines بتشتغل كجلسات Claude Code سحابية كاملة من غير أي permission prompts. بتقدر تستخدم الـ MCP connectors المتوصلة بتاعتك (مضافة افتراضيًا — شيل اللي مش محتاجها) وبتتحدد بالريبوهات اللي اخترتها وصلاحيات الشبكة في البيئة السحابية والـ connectors. افتراضيًا، Claude بيقدر يعمل push بس لـ branches بتبدأ بـ claude/؛ فعّل Allow unrestricted branch pushes لكل ريبو لو محتاج.

الـ routines متاحة على خطط Pro وMax وTeam وEnterprise. مسؤولي Team وEnterprise يقدروا يعطّلوا الـ routines عبر toggle الـ Routines على claude.ai/admin-settings/claude-code. الـ API وGitHub triggers بيتضبطوا من واجهة الويب بس؛ /schedule في الـ CLI بيعمل routines مجدولة.

الأتمتة في الخلفية

الـ subagents في الخلفية بـ background: true في الـ frontmatter بتاعهم بيشتغلوا من غير ما يعطّلوا المحادثة الرئيسية. ده بيخلّيك تبدأ تحليل طويل، تكمّل شغل تاني، وتتبلّغ لما يخلص. لو محتاج أتمتة حوالين شغل المتابعة، استخدم أحداث الـ hook الموثّقة: TaskCompleted لتغييرات حالة المهمة وTeammateIdle لما عضو في فريق الـ agents على وشك يبقى idle.

{
  "hooks": {
    "TaskCompleted": [
      {
        "hooks": [
          {
            "type": "command",
            "command": "curl -X POST $SLACK_WEBHOOK -d '{\"text\": \"Task completed: $TASK_NAME\"}'"
          }
        ]
      }
    ]
  }
}

للأبحاث الطويلة اللي بتمتد على جلسات متعددة، الـ agents القابلة للاستئناف وسير عمل الذاكرة العادي أأمن. خلّي الـ agent يكتب نتائجه في الذاكرة أو ملفات المشروع، وبعدين استأنف الـ agent أو الجلسة بعدين لما تحتاج.

الـ Dynamic Workflows

بعد patterns الجلسات المفردة، Claude Code بيدعم dynamic workflows — ميزة في الـ research preview اتضافت في v2.1.154 بتخلّيك تنسّق من dozens لـ hundreds من subagents من script بلغة JavaScript بيكتبه Claude. على عكس /loop أو /batch اللي بيشتغلوا جوه محادثة واحدة، الـ workflow بينقل الخطة لـ script: الـ script هو اللي ماسك الـ loop والـ branching والنتائج الوسيطة، فـ context بتاع Claude يفضل فيه الإجابة النهائية بس.

عشان تشغّل workflow، حُط كلمة ultracode في أي مكان في الـ prompt بتاعك (الكلمة اللي بتفعّله اتسمّت من workflow لـ ultracode في v2.1.160؛ لو طلبت workflow بصياغتك الطبيعية لسه شغّال)، أو فعّل /effort ultracode عشان Claude يخطّط واحد لكل مهمة أساسية. Claude بيكتب orchestration script متفصّل على هدفك، وبعدين runtime بينفّذه في الخلفية والجلسة بتاعتك فاضلة شغّالة. الـ dynamic workflows بتنفع للـ audits على مستوى الـ codebase كله، والـ migrations الكبيرة، والبحث المُتحقّق منه، وأي مهمة محتاجة agents أكتر مما تقدر جلسة واحدة تنسّقه.

الـ workflow المدمج /deep-research <question> بيعمل أتمتة للبحث من مصادر متعددة: بينشر web searches على زوايا مختلفة، يجيب المصادر ويتحقق منها مع بعض، يعمل vote على كل claim، ويرجّع تقرير بـ citations مع شطب الـ claims اللي ما عدّتش التحقّق. محتاج الـ WebSearch tool يكون متاح:

/deep-research What changed in the Node.js permission model between v20 and v22?

شغّل /workflows عشان تشوف الـ workflows الشغّالة والمكتملة وتفتح progress view بيعرض لكل phase عدد الـ agents وإجمالي الـ tokens والوقت المنقضي. لما run يعمل اللي إنت عايزه، اختاره في الـ /workflows view واضغط s عشان تحفظ الـ script بتاعه كـ command — وبعدين بيشتغل كـ /<name> في الجلسات الجاية، جنب الـ workflows المدمجة. إعادة الاستخدام بتفيد في الشغل المتكرر زي مراجعة كود أسبوعية أو checklist إصدار.

للحصول على أقصى عمق استدلال، /effort ultracode بيجمع بين effort نوع xhigh وorchestration workflow تلقائي — Claude بيحدد إمتى المهمة محتاجة workflow وبينسّق الـ agents من غير ما حد يطلب منه. بيفضل شغّال للجلسة الحالية؛ ارجع لـ /effort high للشغل الروتيني.

الـ dynamic workflows محتاجة Claude Code v2.1.154+ ومتاحة على كل الخطط المدفوعة (Pro، Max، Team، Enterprise). على Pro، فعّلها من صف Dynamic workflows في /config. عشان تعطّلها، اقفل Dynamic workflows من /config، أو اضبط "disableWorkflows": true في الإعدادات، أو اضبط CLAUDE_CODE_DISABLE_WORKFLOWS=1.

أنماط سير العمل متعدد الخطوات

أكتر سير عمل موثوق بيدمج skills و hooks و subagents في pipeline كل خطوة فيها عندها inputs واضحة، outputs، ومعالجة أخطاء.

نمط “طوّر وتحقق” (develop and verify) بيربط prompt hook من نوع Stop بيفحص معايير الإكمال مع skill التنفيذ. لما Claude يوقف، الـ hook بيقيّم لو كل المتطلبات اتحققت. لو لأ، بيقول لـ Claude إيه الناقص و Claude بيكمّل:

{
  "hooks": {
    "Stop": [
      {
        "hooks": [
          {
            "type": "prompt",
            "prompt": "Check: 1) Were all files in the spec modified? 2) Do tests pass? 3) Is the implementation complete per the requirements? If anything is incomplete, explain what remains.",
            "timeout": 30
          }
        ]
      }
    ]
  }
}

نمط “المراجعة المتوازية” (parallel review) بيستخدم Agent Teams (تجريبي، مقفول افتراضيًا — محتاج CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1) عشان متخصصين مختلفين يراجعوا في نفس الوقت. agent بيفحص الأمان، واحد تاني بيفحص الأداء، وواحد تالت بيفحص تغطية الـ tests. قائد الفريق بيجمّع نتائجهم في تقرير واحد. الـ Agent Teams عندها قيود معروفة حول استئناف الجلسات وتنسيق المهام وسلوك الإيقاف.

للمهام اللي بتعدّل ملفات كتيرة عبر الكود، /batch <instruction> بيخطط الشغل، بيقسّمه على agents في الخلفية في git worktrees منعزلة، ومصمّم للـ refactors الكبيرة أو التغييرات المتكررة. حسب سير العمل، ممكن كمان يشغّل خطوات تحقق ويساعد يفتح PRs للنتائج.

الـ git worktrees (isolation: worktree على الـ subagents) مفيدة كمان للشغل التجريبي. الـ agent بيعمل التغييرات في branch منعزل، بيرجّع مسار الـ worktree لما يخلص، وأنت بتراجع أو تلغي من غير ما تأثر على الـ working tree بتاعك.