OpenSpec

مجموعات العمل (beta) ​

افتح المخزن والمستودعات التي تستخدمه في نافذة محرر واحدة، حتى يرى وكيلك كليهما.

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

مجموعات العمل هي الأداة التي يوفرها OpenSpec لهذا الغرض. مجموعة العمل هي قائمة محفوظة ومسماة من المجلدات التي تفتحها معاً. تفترض هذه الصفحة أن المخزن مُعد بالفعل ومسجل على جهازك. صفحة المخازن (beta) تغطي ذلك.

كيف يعمل ​

  • ما هو: قائمة مسماة من المجلدات، محفوظة على جهازك فقط. لا يُكتب أي شيء في المجلدات العضو، ولا يُنفّذ أي commit.
  • ماذا يفعل الفتح: يُنشئ OpenSpec ملف .code-workspace من القائمة ويُشغل محررك عليه. كل مجلد عضو يظهر في نافذة واحدة.
  • ما تحصل عليه: بحث محررك، وأي وكيل تشغله داخل تلك النافذة، يمكنه قراءة كل مجلد عضو. يمكن للوكيل البحث بـ grep في مواصفات المخزن وشيفرة المستودع في جلسة واحدة.
  • ما لا يغيره: مجلد openspec/ الذي يستخدمه الأمر. هذا لا يزال يتبع أين تُنشأ المخرجات.

إعداده ​

  1. احفظ مجموعة العمل (مرة واحدة لكل جهاز). اذكر المستودع والمخزن كأعضاء، والأداة لفتحهما بها:

    bash
    # احفظ قائمة مسماة من المجلدات التي تفتحها معاً
openspec workset create platform \
  --member ~/src/web-app \
  --member ~/openspec/team-plans \
  --tool code
    yaml
    Saved workset 'platform' (2 members) to your machine.
Open it any time with: openspec workset open platform

  2. افتحه كلما بدأت العمل:

    bash
    # افتح كل عضو في نافذة VS Code واحدة
openspec workset open platform

openspec workset list يعرض ما حفظته، و openspec workset remove <name> يحذف مجموعة العمل دون المساس بالمجلدات العضو:

yaml
platform  (opens in VS Code)
  web-app     /Users/you/src/web-app
  team-plans  /Users/you/openspec/team-plans

استخدامه: تغيير واحد، مجلدان ​

لنفترض أن تغيير add-login موجود في مخزن team-plans، وأن الشيفرة الخاصة به موجودة في web-app. افتح مجموعة العمل platform واطلب من وكيلك تنفيذ التغيير. في تلك الجلسة الواحدة يمكنه:

  • قراءة team-plans/openspec/changes/add-login/ والمواصفات المجاورة له
  • تعديل الشيفرة في web-app/
  • تشغيل أوامر openspec من داخل web-app

بدون مجموعة العمل، لا يرى الوكيل إلا المجلد الذي بدأ فيه.

أدوات مدمجة ​

  • VS Code (--tool code) و Cursor (--tool cursor): مدمجان. كل منهما يفتح نافذة واحدة بجميع المجلدات العضو.
  • Claude Code و Codex في الطرفية: معطّلان مؤقتاً كفاتحين لمجموعات العمل بينما تتم إعادة صياغة هذه الآلية. --tool claude أو --tool codex يتوقف بخطأ يوضح ذلك ويرشدك إلى VS Code أو Cursor.
  • محررات أخرى: أضفها تحت مفتاح openers في إعدادات CLI (config.json).