البرمجة التعاونية مع Cursor: البرمجة الزوجية وسير عمل الفريق

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

لماذا استخدام Cursor للتعاون الجماعي

غالباً ما تتضمن البرمجة التعاونية التقليدية مشاركة الشاشة، أو تمرير التحكم ذهاباً وإياباً، أو العمل في محررات منفصلة والمزامنة عبر git. يغير Cursor هذا من خلال تقديم:

• سياق ذكاء اصطناعي مشترك: يمكن لأعضاء الفريق الرجوع إلى نفس فهم قاعدة الأكواد
• بيئات متسقة: تضمن القواعد والتكوينات المشتركة سلوكاً موحداً للذكاء الاصطناعي
• دمج Live Share: تحرير تعاوني في الوقت الفعلي ضمن Cursor
• مراجعات مبسطة: مراجعة أكواد بمساعدة الذكاء الاصطناعي مدمجة في سير العمل

إعداد Live Share في Cursor

يدعم Cursor امتداد Live Share في VS Code، مما يتيح التحرير التعاوني في الوقت الفعلي.

التثبيت

1. افتح لوحة الامتدادات (Cmd+Shift+X / Ctrl+Shift+X)
2. ابحث عن "Live Share"
3. ثبت الامتداد الرسمي من Microsoft
4. سجل الدخول بحساب Microsoft أو GitHub

بدء جلسة تعاون

# From the Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
# Type: "Live Share: Start Collaboration Session"

بمجرد البدء، يولد Cursor رابطاً قابلاً للمشاركة:

Action	Command
بدء الجلسة	Live Share: Start Collaboration Session
الانضمام إلى جلسة	Live Share: Join Collaboration Session
نسخ رابط الدعوة	انقر على أيقونة Live Share في شريط الحالة
إيقاف الجلسة	Live Share: Stop Collaboration Session

الأذونات والأمان

التحكم في ما يمكن للضيوف فعله:

// .vscode/settings.json
{
  "liveshare.allowGuestDebugControl": true,
  "liveshare.allowGuestTaskControl": false,
  "liveshare.guestApprovalRequired": true,
  "liveshare.shareTerminal": "readOnly"
}

warning

اشترط دائماً موافقة الضيف للمتعاونين الخارجيين. وصول المحطة الطرفية للقراءة فقط يمنع التنفيذ العرضي للأوامر.

سير عمل البرمجة الزوجية

نمط السائق-الملاح مع Cursor

ينمط البرمجة الزوجية الكلاسيكي بشكل جيد مع ميزات Cursor:

السائق (الكتابة):

• يستخدم Cmd+K للتحرير المضمن السريع
• يتنقل بـ Cmd+P والاختصارات
• ينفذ أوامر المحطة الطرفية

الملاح (المراقب):

• يستخدم دردشة الذكاء الاصطناعي (Cmd+L) للبحث عن الحلول
• يطلب من Cursor شرح أقسام الأكواد المعقدة
• يقترح إعادة البناء من خلال التعليقات أو الدردشة

التسليم:

• استخدم Live Share للتبديل بين من يقود دون حركة físية
• يرى كلا المشاركين نفس اقتراحات الذكاء الاصطناعي وسياق الدردشة

البرمجة الزوجية غير المتزامنة

عندما لا تتوافق المناطق الزمنية، استخدم ميزات Cursor المستمرة:

1. اترك السياق بالدردشة: يطرح مطوّر أسئلة على Cursor ويترك لوحة الدردشة مفتوحة
2. استخدم @mentions: أشر إلى ملفات ورموز محددة حتى يفهم الشخص التالي السياق
3. ملاحظات مشتركة: احتفظ بـ PAIRING_NOTES.md في المستودع يوثق القرارات

# Pairing Notes: Auth Refactor

## 2025-07-01 (Alice)
- Asked Cursor about JWT vs session auth
- Decision: JWT with refresh tokens
- @src/auth/jwt.ts contains the implementation

## 2025-07-02 (Bob)
- Reviewed Alice's chat history
- Used Composer to add middleware
- Added tests in @src/auth/jwt.test.ts

تكوينات الفريق المشتركة

قواCursor الفريق على مستوى المشروع

أنشئ ملف .cursorrules في جذر مستودعك لضمان حصول جميع أعضاء الفريق على سلوك ذكاء اصطناعي متسق:

# Team Coding Standards

## Tech Stack
- React 18 with TypeScript
- Tailwind CSS for styling
- Zustand for state management
- React Query for server state

## Code Style
- Use functional components with hooks
- Prefer early returns over nested conditionals
- Write tests for all utilities and hooks
- Use explicit types, avoid `any`

## File Organization
- Components: `src/components/{ComponentName}/index.tsx`
- Hooks: `src/hooks/use{HookName}.ts`
- Utils: `src/utils/{category}.ts`

تلميح

ارتكب .cursorrules إلى التحكم في الإصدار حتى يستفيد الفريق بأكمله من السياق المشترك.

المقتطفات والموجهات المشتركة

أنشئ دليل cursor-prompts/ في مستودعك للموجهات الذكاء الاصطناعي القابلة لإعادة الاستخدام:

# cursor-prompts/review-checklist.md

Review this code for:
1. Type safety issues
2. Missing error handling
3. Performance concerns
4. Accessibility problems
5. Test coverage gaps

يمكن لأعضاء الفريق نسخ ولصق هذه في الدردشة لمراجعات متسقة.

تناسق البيئة

استخدم دليل .cursor/ للإعدادات على مستوى الفريق:

.cursor/
  settings.json       # Shared editor settings
  extensions.json     # Recommended extensions
  keybindings.json    # Team-specific shortcuts

// .cursor/settings.json
{
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "cursor.defaultModel": "claude-sonnet-4",
  "cursor.codebaseIndex": true
}

سير عمل مراجعة الأكواد

المراجعة المسبقة مع Cursor

قبل تقديم PR، يجب على المؤلفين إجراء مراجعة ذاتية:

1. اشرح التغيير: اطلب من Cursor تلخيص ما يفعله PR

   Summarize the changes in @src/components/Auth.tsx and explain the design decisions

2. ابحث عن الحالات الحافة: اطلب من Cursor تحديد المشكلات المحتملة

   What edge cases are not handled in the new authentication flow?

3. تحقق من التناسق: تحقق من أن الكود الجديد يطابق الأنماط الموجودة

   Does this new component follow the same patterns as @src/components/UserProfile.tsx?

سير عمل المراجع

يستخدم المراجعون Cursor لتسريع تحليلهم:

Step	Action	Prompt Example
1	فهم السياق	"Summarize what this PR changes and why"
2	البحث عن الأخطاء	"Find potential bugs or null reference exceptions"
3	التحقق من الأنماط	"Does this follow our established error handling pattern?"
4	اقتراح الاختبارات	"What test cases are missing for this new feature?"

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

عند ترك تعليقات مراجعة، استخدم Cursor لاقتراح إصلاحات محددة:

1. حدد الكود المشكل
2. اضغط Cmd+K وصف الإصلاح
3. انسخ النسخة المحسّنة في تعليق المراجعة

// Reviewer comment:
// Consider handling the undefined case:
function getUserName(user?: User) {
  return user?.name ?? 'Anonymous';
}

إدماج الفريق الجديد مع Cursor

إعداد المطوّر الجديد

أنشئ دليل إدماج يستفيد من ذكاء Cursor الاصطناعي:

# New Developer Onboarding

## Day 1: Environment Setup
1. Install Cursor
2. Clone the repository
3. Run `npm install`
4. Copy `.env.example` to `.env`
5. Ask Cursor: "Explain the project structure based on @AGENTS.md"

## Day 2: First Contribution
1. Pick up a "good first issue"
2. Ask Cursor: "How do I add a new page in this project?"
3. Follow Cursor's guidance with team verification

## Week 1: Understanding the Codebase
1. Use `@file` mentions to explore key files
2. Ask Cursor to explain complex business logic
3. Review `cursor-prompts/` for standard team prompts

مشاركة المعرفة مع سجل الدردشة

يستمر سجل الدردشة في Cursor لكل مساحة عمل. يمكن للفرق استخدام هذا لنقل المعرفة:

• المطوّرون الكبار: اطرح أسئلة معمارية معقدة واحفظ الدردشة
• المطوّرون الجدد: راجع الدردشات المحفوظة لفهم قرارات التصميم
• قادة الفريق: صدّر الأسئلة والأجوبة المهمة إلى الوثائق

معلومات

يتم تخزين سجل الدردشة محلياً. للمعرفة الفريقية المستمرة، انسخ شروحات الذكاء الاصطناعي المهمة إلى ملفات markdown في المستودع.

التصحيح التعاوني

جلسات التصحيح المشتركة

عند التصحيح معاً:

1. شارك الخطأ: انسخ تتبع المكدس إلى دردشة Cursor
2. اطلب التحليل: "What's causing this error and how do I fix it?"
3. استكشف معاً: استخدم @file mentions لفحص الأكواد ذات الصلة
4. اختبر الإصلاحات: طبّق اقتراحات Cursor وتحقق معاً

# Example shared debugging workflow
# Developer 1 sees an error and shares in chat:
# "TypeError: Cannot read property 'id' of undefined"

# Both developers ask Cursor:
# "Find where user.id is accessed without null checks in @src/api/users.ts"

التعاون في المحطة الطرفية

مع Live Share، يمكن لأعضاء الفريق مشاركة وصول المحطة الطرفية:

// Allow guests to see terminal output
{
  "liveshare.shareTerminal": "readOnly"
}

مفيد لـ:

• إظهار أخطاء البناء
• توضيح سير عمل CLI
• تصحيح مشاكل النشر

أفضل الممارسات لاستخدام Cursor في الفريق

الواجبات

Practice	Benefit
ارتكب .cursorrules	سلوك ذكاء اصطناعي متسق عبر الفريق
استخدم الموجهات المشتركة	مراجعات وأكواد موحدة
وثّق قرارات الذكاء الاصطناعي	عندما يقترح Cursor نمطاً، وثّق السبب
شغّل مراجعة الذكاء الاصطناعي قبل المراجعة البشرية	يلتقط المشكلات الواضحة مبكراً
شارك الموجهات الناجحة	بناء مكتبة موجهات الفريق

الممنوعات

Practice	Problem
الاعتماد فقط على مراجعة الذكاء الاصطناعي	الحكم البشري لا يزال ضرورياً
مشاركة مفاتيح API في .cursorrules	مخاطر أمانية، استخدم متغيرات البيئة
تجاهل هلوسات الذكاء الاصطناعي	تحقق من جميع اقتراحات الذكاء الاصطناعي قبل الارتكاب
استخدام نماذج مختلفة دون مناقشة	أسلوب أكواد وجودة غير متسقة
نسيان حفظ الدردشات المهمة	فقدان المعرفة عند انتهاء الجلسات

إدارة Cursor في فرق المؤسسات

للمنظمات الأكبر:

1. قواعد مركزية: حافظ على قوالب .cursorrules على مستوى المنظمة
2. سياسات النماذج: قم بتوحيد نماذج الذكاء الاصطناعي التي يمكن للفرق استخدامها
3. وضع الخصوصية: فعّل وضع الخصوصية لقواعد الأكواد الحساسة
4. ممارسات التدقيق: راجع بانتظام الأكواد المولدة بالذكاء الاصطناعي للجودة

// Enterprise cursor configuration
{
  "cursor.privacyMode": true,
  "cursor.defaultModel": "claude-sonnet-4",
  "cursor.allowCustomModels": false,
  "cursor.codebaseIndex": true
}

ملخص

يحول Cursor التعاون الجماعي من خلال:

• تمكين البرمجة الزوجية في الوقت الفعلي من خلال Live Share
• توحيد سلوك الذكاء الاصطناعي مع .cursorrules مشترك
• تسريع مراجعة الأكواد بتحليل بمساعدة الذكاء الاصطناعي
• الحفاظ على معرفة الفريق من خلال الدردشة المستمرة والوثائق
• تقليل وقت الإدماج من خلال استكشاف قاعدة الأكواد بإرشاد الذكاء الاصطناعي

المفتاح للنجاح هو التعامل مع Cursor كأداة فريق، وليس مجرد أداة فردية. شارك التكوينات، وثّق القرارات، وابنِ سير عمل تعاونية تستفيد من مساعدة الذكاء الاصطناعي للفريق بأكمله.

---

Last updated: July 2025. Live Share features require the official VS Code extension.