متتبع مشاريع Linear

## لمن هذا

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

## البداية السريعة في 3 خطوات

1. **إنشاء مشكلة** — اطلب: `"Use 0xsero-linear to create a bug ticket in project Mobile App: 'Login button unresponsive on iOS 17', priority High, assign to @alice"`. تستدعي المهارة Linear GraphQL API وتُرجع معرف المشكلة الجديد ورابطها.
2. **تحديث المعالم** — اطلب: `"Use bind-linear-milestones-write to add a milestone 'Beta Release v2.0' to project Mobile App, due 2026-03-31"`. تحصل على تأكيد بمعرف المعلم.
3. **أتمتة التحديثات الجماعية** — اطلب: `"Use sickn33-linear-automation to move all issues labeled 'blocked' in the current cycle to the next cycle"`. تعمل الأتمتة عبر مجموعة أدوات Composio Linear وتُبلغ عن عدد المشاكل التي تم نقلها.

## الخطوة → المهارة → الإدخال → الإخراج

| الخطوة | المهارة | ما تقدمه | ما تحصل عليه |
|------|-------|------------------|--------------|
| Create / update issues | 0xsero-linear | اسم المشروع + تفاصيل المشكلة | رابط المشكلة + المعرف |
| CLI issue management | 0xbigboss-linear | الفريق / المشروع + الإجراء | قائمة المشاكل أو تأكيد الإجراء |
| Read & write tickets | davila7-linear | معرف التذكرة أو استعلام البحث | تفاصيل التذكرة أو التذكرة المحدثة |
| Create milestones | bind-linear-milestones-write | المشروع + اسم المعلم + تاريخ الاستحقاق | معرف المعلم + التأكيد |
| Bulk automation | sickn33-linear-automation | معايير التصفية + الإجراء | عدد المشاكل المحدثة |

## الأعطال الشائعة والإصلاحات

- **0xsero-linear returns "project not found"** → أسماء المشاريع حساسة لحالة الأحرف في Linear. انسخ الاسم الدقيق من الشريط الجانبي لمساحة عمل Linear الخاصة بك.
- **bind-linear-milestones-write fails with "permission denied"** → المعالم تتطلب وصول محرر. تحقق من أن مفتاح Linear API الخاص بك يحتوي على أذونات الكتابة.
- **sickn33-linear-automation moves 0 issues** → تحقق من أن فلترك يطابق المشاكل الموجودة. جرب استعلامًا أبسط أولاً: `"list all blocked issues in current cycle"`.

## معايير النجاح

تعرف أنه نجح عندما:
- 0xsero-linear أو davila7-linear يُرجع رابط `linear.app` للمشكلة المنشأة/المحدثة
- bind-linear-milestones-write يؤكد المعلم بمعرف
- sickn33-linear-automation يُبلغ عن عدد المشاكل المعالجة (حتى لو 0 — هذا يعني أن الفلتر لم يطابق شيئًا، وليس فشلًا)