سير العمل والأتمتة في Claude Code

سير عمل Claude Code — أتمتة سير عمل Claude Code ترفع من إنتاجيتك على نطاق واسع. تعلّم التكامل مع CI/CD، وإدارة الجلسات، والمعالجة على دفعات مع Claude Code.

سير عمل Claude Code: ماذا ستتعلم

في هذا الدليل إلى سير عمل Claude Code، ستعمل على خطوات عملية وتطبيقية مع أمثلة حقيقية. يُشرح سير عمل Claude Code من الأساس حتى تتمكن من تطبيقه فورًا في مشاريعك الخاصة.

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

مثال تطبيقي: بناء أول سير عمل مؤتمت

لتحويل Claude Code من أداة تفاعلية إلى عضو في خط الأنابيب، ابنِ سير عمل بسيطًا للتشغيل غير التفاعلي خطوة بخطوة.

ابدأ بأمر واحد بوضع الطباعة: claude -p "راجع التغييرات غير المدمجة وأصلح أي أخطاء lint واضحة" --output-format json. شغّله محليًا أولًا وافحص بنية مخرجات JSON — الحقول التي تهمك عادة هي حالة النجاح والملخص وأي أخطاء.

انقل هذا الأمر إلى خط أنابيب CI بسيط: أضف خطوة تشغيل بعد كل طلب سحب (pull request) تستدعي Claude Code بوضع الطباعة، وتتحقق من رمز الخروج قبل السماح بالدمج. تحقّق أيضًا من رمز الخروج الذي يعيده claude auth status في بيئة CI — فتسجيل الدخول الفاشل الصامت يجعل الخطوة بأكملها بلا قيمة.

بعد أن يعمل الأمر الفردي بثبات، وسّعه إلى معالجة على دفعات: بدل تشغيل أمر واحد على كل الملفات معًا، فرّع جلسة مستقلة لكل ملف أو مجموعة ملفات متقاربة، حتى لا يتسرب سياق ملف إلى آخر ويبقى كل تغيير قابلًا للمراجعة بمعزل.

للمهام الطويلة أو المتكررة، جرّب المهام المجدولة أو الروتينات بدل تشغيل الأمر يدويًا في كل مرة — اضبط جدولًا زمنيًا واضحًا، وتأكد من أن كل تشغيل مسجَّل بما يكفي لتتبع ما تغيّر ومتى.

أخيرًا، أضف طبقة ثقة: لا تدمج أي تغيير آلي دون أن يمر عبر الاختبارات ومراجعة تلقائية إضافية — اجعل Claude نفسه، أو وكيلًا فرعيًا مخصصًا، يتحقق من نتيجة عمله قبل أن يصل التغيير إلى الفرع الرئيسي.

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

يُعد الخيار claude -p أساس التكامل مع CI/CD. فهو يشغّل Claude بشكل غير تفاعلي، ويرسل موجّهًا (prompt)، ويعيد النتيجة إلى stdout. ادمجه مع --output-format json للتحليل المنظَّم، ومع --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

يقوم الخيار --from-pr بتهيئة جلسة انطلاقًا من طلب دمج موجود. فهو يجلب الفرق (diff) والوصف وتعليقات المراجعة حتى يتمكن Claude من الانتقال مباشرة إلى إصلاح ملاحظات الـ PR أو توسيعها. اعتبارًا من الإصدار v2.1.119، يقبل --from-pr روابط من GitHub وGitHub Enterprise، وطلبات الدمج في GitLab، وطلبات السحب في Bitbucket:

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 توليد اختبارات للكود الجديد، وتحديث التوثيق عند تغير واجهات الـ API، وتشغيل أدوات الفحص (linters) وإصلاح المشكلات تلقائيًا، أو التحقق من الثغرات الأمنية. استخدم --no-session-persistence لتجنب حفظ جلسة، وفكّر في استخدام --bare عندما تريد أنظف مخرجات برمجية.

استخدم prUrlTemplate (جديد في v2.1.119) لتوجيه شارة الـ PR في التذييل إلى رابط مراجعة كود مخصص بدلًا من رابط github.com الافتراضي — وهو مفيد للنشر في المؤسسات التي تستخدم نسخ GitHub داخلية أو أدوات مراجعة مخصصة:

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

يقوم الأمر /install-github-app بإعداد التكامل الرسمي مع GitHub، والذي يسمح لـ Claude بالاستجابة لإشارات @claude في تعليقات طلبات الدمج والمسائل (issues).

إشعارات الدفع على الهاتف

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

للمراقبة المستقلة لطلبات الدمج، يطلق /autofix-pr جلسة Claude Code على الويب تراقب الـ PR الخاص بفرعك الحالي. عند فشل الـ CI أو ترك مراجِع تعليقًا، يحقق Claude في الأمر ويدفع إصلاحًا. مرّر موجّهًا لتضييق النطاق: /autofix-pr only fix lint and type errors. يتطلب ذلك تثبيت تطبيق Claude GitHub على المستودع، والوصول إلى Claude Code على الويب، وهو غير متاح للمؤسسات التي فعّلت سياسة عدم الاحتفاظ بالبيانات (Zero Data Retention).

يشغّل الأمر /ultrareview (جديد في v2.1.86، أُبرز في v2.1.112) مراجعة كود شاملة عبر السحابة باستخدام تحليل ونقد متعدد الوكلاء على التوازي. يتطلب مصادقة حساب Claude.ai — إذا كنت مسجّل الدخول بمفتاح API فقط، فشغّل /login أولًا. يعمل على بنية Claude Code على الويب. استدعِه بلا وسائط لمراجعة فرعك الحالي، أو /ultrareview <PR#> لجلب ومراجعة طلب دمج محدد على GitHub.

يحصل مشتركو Pro/Max على 3 عمليات تشغيل مجانية لمرة واحدة (حصة لمرة واحدة لكل حساب، لا تتجدد)، ثم تكلّف كل مراجعة بعد ذلك ما يقارب 5–20 دولارًا كاستخدام إضافي. لا يحصل مشتركو Team/Enterprise على عمليات تشغيل مجانية وتُحتسب كاستخدام إضافي. يجب تفعيل الاستخدام الإضافي على الحساب — وإذا كان معطّلًا، يحجب Claude Code الإطلاق ويوجّهك إلى إعدادات الفوترة. استخدم /tasks لتتبّع المراجعات الجارية والمكتملة، وفتح عروض التفاصيل، أو إيقاف مراجعة قيد التنفيذ (الإيقاف يؤرشف الجلسة السحابية؛ ولا تُعاد النتائج الجزئية).

/ultrareview           # review current branch
/ultrareview 456       # review GitHub PR #456

المهام المجدولة والروتينات والأتمتة في الخلفية

يدعم Claude Code طبقات جدولة متعددة. ينشئ /loop فحوصات متكررة محصورة بنطاق الجلسة أثناء تشغيل Claude Code. أما الروتينات (Routines) فهي مهام مجدولة مدعومة سحابيًا تستمر بشكل مستقل عن طرفيتك المحلية — حيث يستنسخ كل تشغيل مستودعك من جديد، وينفّذ بشكل مستقل، ويمكنه دفع فروع أو فتح طلبات دمج.

# Check build status every 5 minutes (session-scoped)
/loop 5m check if the build succeeded and summarize any failures

# Create a cloud routine from the CLI
/schedule "run a full security audit at 2am"
/schedule daily PR review at 9am

الروتينات

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

يمكن لكل روتين أن يجمع بين عدة مشغّلات (triggers):

• مجدول — وتيرة متكررة (كل ساعة، يوميًا، أيام العمل، أسبوعيًا) أو تشغيل لمرة واحدة في وقت محدد. لا تُحتسب عمليات التشغيل لمرة واحدة ضمن الحد اليومي للروتينات. وتتوفر تعبيرات cron مخصصة عبر /schedule update (الحد الأدنى للفاصل الزمني: ساعة واحدة).
• API — نقطة نهاية HTTP خاصة بكل روتين. أرسل طلب POST مع رمز bearer لتشغيل التنفيذ، مع إمكانية تمرير سياق في حقل text. اربطها بأنظمة التنبيه، أو خطوط النشر، أو الأدوات الداخلية.
• GitHub — يتفاعل مع أحداث المستودع مثل طلبات الدمج أو الإصدارات. تتيح المرشّحات التضييق حسب المؤلف، والعنوان، والوسوم (labels)، وفرع الأساس/الرأس، وحالة المسودة، وغير ذلك. يتطلب تثبيت تطبيق Claude GitHub على المستودع.

تعمل الروتينات كجلسات Claude Code سحابية كاملة بلا مطالبات أذونات. ويمكنها استخدام موصّلات MCP المتصلة لديك (مضمَّنة افتراضيًا — أزِل أي موصّل غير مطلوب)، وتكون محصورة بالمستودعات التي تختارها، والوصول الشبكي لبيئة السحابة، والموصّلات التي تضمّنها. وافتراضيًا، لا يستطيع Claude الدفع إلا إلى الفروع المسبوقة بـ claude/؛ فعّل خيار Allow unrestricted branch pushes لكل مستودع عند الحاجة.

تتوفر الروتينات في خطط Pro وMax وTeam وEnterprise. ويمكن لمشرفي Team وEnterprise تعطيل الروتينات عبر مفتاح Routines على claude.ai/admin-settings/claude-code. تُضبط مشغّلات API وGitHub من واجهة الويب فقط؛ بينما ينشئ /schedule في واجهة سطر الأوامر روتينات مجدولة.

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

تعمل الوكلاء الفرعيون (subagents) في الخلفية المضبوطون بـ background: true في بياناتهم الأمامية (frontmatter) دون حجب المحادثة الرئيسية. يتيح ذلك سير عمل تطلق فيه تحليلًا طويلًا، وتتابع أعمالًا أخرى، وتُخطَر عند اكتماله. وإذا احتجت إلى أتمتة حول الأعمال اللاحقة، فاستخدم أحداث الخطافات (hooks) الموثّقة رسميًا للمهام والفِرق في سياقاتها المقصودة: TaskCompleted لتغيّرات حالة المهمة وTeammateIdle لزملاء فرق الوكلاء الذين على وشك الدخول في وضع الخمول.

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

أما للبحث طويل الأمد الذي يمتد عبر عدة جلسات، فتُعد الوكلاء القابلون للاستئناف (resumable agents) وسير عمل الذاكرة المعتاد نموذجًا ذهنيًا أكثر أمانًا: دع الوكيل يكتب نتائجه في الذاكرة أو في وثائق المشروع، ثم استأنف الوكيل أو الجلسة لاحقًا عند الحاجة.

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

إلى جانب أنماط الجلسة الواحدة، يدعم Claude Code سير العمل الديناميكي — وهي ميزة بمعاينة بحثية (research-preview) أُدخلت في v2.1.154 تتيح لك تنسيق عشرات إلى مئات الوكلاء الفرعيين من سكربت JavaScript يكتبه Claude. وخلافًا لـ /loop أو /batch اللذين يعملان ضمن محادثة واحدة، ينقل سير العمل الخطة إلى سكربت: يحمل السكربت الحلقة والتفرّع والنتائج الوسيطة، بحيث يحتفظ سياق Claude بالإجابة النهائية فقط.

لتشغيل سير عمل، ضمّن الكلمة ultracode في أي موضع من موجّهك (أُعيدت تسمية الكلمة المفتاحية المشغّلة من workflow إلى ultracode في v2.1.160؛ ولا يزال طلبها بكلماتك الخاصة يعمل)، أو فعّل /effort ultracode للسماح لـ Claude بالتخطيط لواحد عند كل مهمة جوهرية. يكتب Claude سكربت تنسيق مفصّلًا على هدفك، ثم تنفّذه بيئة تشغيل في الخلفية بينما تبقى جلستك متجاوبة. يناسب سير العمل الديناميكي عمليات التدقيق على مستوى قاعدة الكود بالكامل، والترحيلات الكبيرة، والأبحاث المتقاطعة التحقق، وأي مهمة تحتاج إلى وكلاء أكثر مما تستطيع محادثة واحدة تنسيقه.

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

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

شغّل /workflows لسرد سير العمل الجاري والمكتمل وفتح عرض تقدّم يُظهر عدد الوكلاء في كل مرحلة، وإجمالي الرموز (tokens)، والوقت المنقضي. وعندما يحقق تشغيلٌ ما أردته، حدّده في عرض /workflows واضغط s لحفظ سكربته كأمر — فيعمل عندئذٍ بصيغة /<name> في الجلسات المستقبلية، إلى جانب سير العمل المضمَّن. ويؤتي إعادة الاستخدام ثمارها للأعمال المتكررة كتدقيق كود أسبوعي أو قائمة تحقق للإصدار.

لأقصى عمق في الاستدلال، يجمع /effort ultracode بين جهد xhigh وتنسيق سير العمل الآلي — حيث يقرر Claude متى تستحق المهمة سير عمل وينسّق الوكلاء دون أن يُطلب منه ذلك. يستمر طوال الجلسة الحالية؛ وارجع إلى /effort high للأعمال الاعتيادية.

يتطلب سير العمل الديناميكي 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) في خط معالجة تكون فيه لكل خطوة مدخلات ومخرجات ومعالجة أخطاء واضحة.

يقرن نمط «التطوير والتحقق» خطاف موجّه عند Stop يفحص معايير الاكتمال مقابل مهارة تنفيذ. فعندما يتوقف Claude، يقيّم الخطاف ما إذا كانت جميع المتطلبات قد استُوفيت. وإن لم تكن، يخبر 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
          }
        ]
      }
    ]
  }
}

يستخدم نمط «المراجعة على التوازي» فرق الوكلاء (Agent Teams) (تجريبي، معطّل افتراضيًا — يتطلب CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1) ليراجع عدة مختصين في وقت واحد. يفحص أحد الوكلاء الأمان، ويفحص آخر الأداء، ويفحص ثالث تغطية الاختبارات. ويصوغ قائد الفريق نتائجهم في تقرير واحد. ولفرق الوكلاء قيود معروفة تتعلق باستئناف الجلسة، وتنسيق المهام، وسلوك الإيقاف.

للمهام التي تعدّل ملفات كثيرة عبر قاعدة الكود، يخطّط /batch <instruction> للعمل، ويوزّعه على وكلاء في الخلفية ضمن أشجار عمل git معزولة (worktrees)، وهو مصمّم لإعادة الهيكلة واسعة النطاق أو التغييرات المتكررة. وحسب سير العمل، يمكنه أيضًا تشغيل خطوات تحقق والمساعدة في فتح طلبات دمج للنتائج.

كما تُعد أشجار عمل git (isolation: worktree على الوكلاء الفرعيين) مفيدة للعمل التجريبي. يجري الوكيل التغييرات في فرع معزول، ويعيد مسار شجرة العمل عند الانتهاء، فتراجعها أو تتخلص منها دون التأثير على شجرة عملك.

أمثلة على سير العمل من واقع العمل

إليك أنماط CI/CD وأتمتة جاهزة للإنتاج لـ Claude Code:

المثال 1: التكامل مع خط معالجة CI/CD

تشغيل Claude Code بشكل غير تفاعلي في خط معالجة CI مع مخرجات JSON منظَّمة:

#!/bin/bash
# Run Claude in print mode with JSON output and turn limit
claude -p --output-format json --max-turns 3 "review code for security issues"

# Pipe a file into Claude for analysis
cat error.log | claude -p --output-format json "explain this error"

# Process multiple files in batch
for file in src/*.ts; do
  claude -p "summarize: $(cat $file)" --output-format json > "${file%.ts}.summary.json"
done

# Verify authentication before pipeline runs
claude auth status || exit 1

المثال 2: تفريع الجلسات ومقارنتها

استخدام تفريع الجلسات (session forking) لتجربة مقاربات مختلفة دون فقدان الأصل:

# Resume an existing session and fork it to try a new approach
claude --resume my-feature --fork-session "approach-v2"

# The original session is preserved
# The forked branch gets its own independent conversation history

المثال 3: سير عمل GitHub Actions

دمج Claude Code في خط معالجة CI/CD عبر GitHub Actions:

# .github/workflows/claude-review.yml
name: Claude Code Review
on: [pull_request]

jobs:
  review:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Run Claude review
        run: |
          claude auth status
          claude -p --output-format json --max-turns 3             "Review this PR for security and quality issues."
        env:
          ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}

نصائح احترافية

• استخدم وضع الطباعة للأتمتة. يعمل claude -p "query" بشكل غير تفاعلي ويخرج فورًا—وهو مثالي لخطوط معالجة CI، ومهام cron، والسكربتات. اقرنه بـ --output-format json للحصول على مخرجات قابلة للتحليل آليًا.
• حافظ على نظافة الجلسات في CI. أضِف --no-session-persistence في عمليات التشغيل الآلية لمنع تراكم بيانات الجلسة على المنفّذات المؤقتة (ephemeral runners) وإهدار مساحة القرص.
• اربط الخطافات لأتمتة ما قبل/بعد العمليات. استخدم خطافي PreToolUse وPostToolUse لتشغيل أدوات الفحص أو التنسيق أو الفحوصات الأمنية تلقائيًا حول تعديلات الملفات دون تدخل يدوي.
• افصل الجلسات للمهام المنفصلة. لا تخلط أعمالًا غير مترابطة في جلسة واحدة. استخدم --resume <session-id> أو جلسات مسمّاة (-n "auth-refactor") لإبقاء السياقات مركّزة ومنع تلوّث نافذة السياق.
• خزّن بيانات الاعتماد في الأسرار، لا في الكود أبدًا. في GitHub Actions، أشِر إلى ${{ secrets.ANTHROPIC_API_KEY }} كمتغير بيئة. لا تضمّن المفاتيح بشكل صلب في ملفات سير العمل أو تودعها في git أبدًا.

تحدٍّ تطبيقي

ابنِ خط معالجة CI/CD متكاملًا يشغّل Claude Code في وضع الطباعة لمراجعة كل طلب دمج تلقائيًا.

المهمة

أنشئ سير عمل GitHub Actions يُشغَّل عند طلبات الدمج، ويستخدم وضع Claude Code العديم الرأس (-p) لمراجعة الفرق (diff)، وينشر النتائج كتعليق على الـ PR، ويمنع الدمج عند وجود مشكلات حرجة.

الخطوات

1. في مستودعك، أنشئ .github/workflows/claude-review.yml.
2. اضبطه ليُشغَّل عند أحداث pull_request لنوعي النشاط opened وsynchronize.
3. أضِف خطوة تسحب الكود وتُعِدّ Node.js.
4. شغّل claude -p "Review this PR diff for security issues, bugs, and style. Output a markdown summary." --output-format text مع ANTHROPIC_API_KEY من أسرار المستودع.
5. التقط المخرجات وانشرها كتعليق باستخدام إجراء actions/github-script أو gh pr comment.
6. (اختياري) أضِف مهمة ثانية تُفشِل الفحص إذا احتوت مخرجات المراجعة على "CRITICAL".

النتيجة المتوقعة

ملف سير عمل يعمل ويراجع كل PR تلقائيًا، وينشر تعليق مراجعة منظَّمًا خلال ثوانٍ، ويمنع اختياريًا الدمج عند اكتشاف مشكلات حرجة.

تلميح

يعمل وضع الطباعة (claude -p) بشكل غير تفاعلي ويخرج بعد إنتاج المخرجات—وهو مثالي لـ CI. استخدم --output-format json إذا احتجت إلى تحليل الاستجابة برمجيًا. خزّن مفتاح الـ API في GitHub Secrets (لا تضمّنه بشكل صلب أبدًا)، واستخدم --no-session-persistence لتجنب ملء القرص ببيانات الجلسة على المنفّذ.

اختبار المعرفة

اختبر فهمك لسير عمل Claude Code وأتمتته:

السؤال 1: ما هو أساس التكامل مع CI/CD في Claude Code؟

أ) الخيار --ci
ب) وضع الطباعة (claude -p) الذي يعمل بشكل غير تفاعلي ويُخرج إلى stdout
ج) تطبيق سوق GitHub Actions
د) الأمر claude pipeline

الإجابة الصحيحة: ب — يشغّل وضع الطباعة (-p) Claude بشكل غير تفاعلي، ويقبل موجّهًا، ويعيد النتيجة إلى stdout.

السؤال 2: كيف تضمن مخرجات JSON صحيحة المخطط (schema-valid) من Claude في خط معالجة CI؟

أ) استخدم --output-format json فقط
ب) استخدم --output-format json --json-schema مع تعريف JSON Schema
ج) استخدم الخيار --strict-json
د) مخرجات JSON صحيحة المخطط دائمًا

الإجابة الصحيحة: ب — تضمن إضافة --json-schema مطابقة المخرجات للمخطط من أجل تحليل موثوق.

السؤال 3: ما النمط الموصى به للمعالجة على دفعات لعدة ملفات مع Claude Code؟

أ) claude --batch *.md
ب) استخدام حلقة for في الـ shell مع وضع الطباعة لكل ملف على حدة
ج) claude -p --files *.md "summarize all"
د) المعالجة على دفعات غير مدعومة

الإجابة الصحيحة: ب — استخدم حلقات for في الـ shell مع وضع الطباعة لمعالجة الملفات واحدًا تلو الآخر بشكل مستقل.

السؤال 4: أي رمز خروج (exit code) من claude auth status يدل على تسجيل دخول ناجح؟

أ) 1
ب) 0
ج) 200
د) لا يعيد رمز خروج

الإجابة الصحيحة: ب — رمز الخروج 0 يعني مسجّل الدخول، و1 يعني غير مسجّل. وهذا يجعله قابلًا للبرمجة لفحوصات مصادقة CI/CD.

السؤال 5: كيف تفرّع جلسة موجودة لتجربة مقاربة مختلفة دون فقدان الأصل؟

أ) استخدام الأمر /fork
ب) استخدام --resume session-name --fork-session "branch name"
ج) استخدام --clone session-name
د) استخدام /branch session-name

الإجابة الصحيحة: ب — ينشئ --resume مع --fork-session فرعًا مستقلًا يحفظ المحادثة الأصلية.

موارد إضافية

سير العمل في Claude Code: أخطاء شائعة يجب تجنّبها

معظم أعطال سير العمل المؤتمت لا تظهر أثناء الاختبار المحلي، بل بعد أن يعمل السير في CI لفترة دون رقابة.

• الاعتماد على وضع الطباعة (print mode) دون التحقق من مخطط JSON، فيفشل خط أنابيب CI بصمت عند تغيّر الحقول.
• تشغيل معالجة على دفعات بجلسة واحدة مشتركة بدل تفريع جلسات مستقلة، فيتسرب سياق من ملف إلى آخر.
• تجاهل رمز الخروج من claude auth status في سكربتات CI، فتستمر الأتمتة رغم فشل تسجيل الدخول.
• جدولة مهام خلفية أو روتينات دون حراسة زمنية (timeout)، فتتراكم عمليات معلّقة تستهلك الموارد.

سير عمل Claude Code يمنحك سير عمل متينًا وقابلًا للتكرار. احفظ دليل سير عمل Claude Code هذا في مفضلتك وعُد إلى الخطوات كلما احتجت إليها.

سير عمل Claude Code: أفضل الممارسات

• اربط المساعد بـ CI/CD عبر وضع الطباعة لعمليات تشغيل قابلة للتكرار وعديمة الرأس.
• استخدم إدارة الجلسات لاستئناف الأعمال طويلة التنفيذ دون فقدان السياق.
• اجمع التغييرات المتشابهة على دفعات حتى تبقى المراجعة قابلة للإدارة.
• أضِف خطوات تحقق ليُختبر كل تغيير آلي قبل دمجه.
• سجّل عمليات تشغيل سير العمل حتى يسهل تشخيص الأعطال.

سير عمل Claude Code: الأسئلة الشائعة

هل يمكن تشغيل Claude Code في CI؟

نعم. يجعل وضع الطباعة سير عمل Claude Code قابلًا للتكرار وعديم الرأس لـ CI/CD.

كيف أستأنف المهام الطويلة؟

استخدم إدارة الجلسات لمواصلة العمل دون فقدان السياق.

كيف ينبغي أن أجمع التغييرات على دفعات؟

اجمع التعديلات المتشابهة حتى تبقى المراجعة قابلة للإدارة وآمنة.

كيف أثق في التغييرات الآلية؟

أضِف التحقق والاختبارات حتى تُفحص التغييرات قبل دمجها.

هل يمكن تفريع جلسة قائمة لتجربة نهج مختلف؟

نعم — يمكنك تفريع الجلسة للتجربة دون فقدان الأصل، ثم المقارنة بين النتيجتين قبل اختيار إحداهما.