● مجتمع
wrsmith108
⚡ فوري
linear-claude-skill
بواسطة wrsmith108 · wrsmith108/linear-claude-skill
مهارة Claude تعلّم الوكيل إدارة المشاكل والمشاريع والدورات عبر Linear MCP و SDK.
استنسخ هذه المهارة في ~/.claude/skills/ ليتعلم Claude نموذج بيانات Linear عملياً: الفرق والدورات وحالات المشاكل واستعلامات GraphQL والأتمتة الشائعة. تغلف الواجهة Linear MCP (أو استدعاءات SDK المباشرة) بأنماط معروّفة بحيث يقوم الوكيل بالفرز والتحويلات وإعداد التقارير دون إعادة اختراع الواجهة البرمجية في كل مرة.
لماذا تستخدمه
الميزات الأساسية
- تشفّر نموذج بيانات Linear: الفرق → المشاريع → الدورات → المشاكل → المشاكل الفرعية
- مقتطفات استعلام GraphQL جاهزة للاستخدام لأكثر التقارير شيوعاً
- اتفاقيات الأولوية والحالة والعلامات التي يطبقها الوكيل بشكل متسق
- يعمل جنباً إلى جنب مع Linear MCP الرسمي للكتابة
- مهارة Markdown فقط — بدون تبعيات وقت التشغيل
عرض مباشر
كيف يبدو في الممارسة
linear-claude-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: linear-claude-skill
متى تستخدمه: عصر يوم الجمعة، تحتاج إلى معرفة ما تم شحنه في هذه الدورة وما تأخر وما يجب تحويله.
الخطوات
-
اطلب من Claude سحب الدورة الحالية
اعرض كل مشكلة في الدورة الحالية للفريق ENG — مجمعة حسب الحالة مع المسؤول.✓ تم النسخ
→ جدول: Backlog / In Progress / In Review / Done مع معرّفات المشاكل
-
تشخيص الأمور المتأخرة
أي المشاكل لا تزال In Progress أو In Review مع تبقي يومين؟ من يملكها؟✓ تم النسخ
→ سطر واحد لكل مشكلة مع تنبيه المخاطر
-
تحويل المشاكل واكتب الملخص
حوّل المشاكل غير المكتملة إلى الدورة التالية وأنشئ مسودة ملخص Slack لما تم شحنه فعلاً.✓ تم النسخ
→ تأكيد التحويل + ملخص جاهز للنسخ
النتيجة: إغلاق دورة نظيف في 10 دقائق بدلاً من ساعة.
المزالق
- Claude يحول مشاكل كنت تنوي إلغاءها — أخبره 'اقائم أولاً، وأكد، ثم غيّر' — احتفظ بنقطة تحقق بشرية قبل الكتابة
متى تستخدمه: صباح الاثنين، مشروع Bugs يحتوي على 40 عنصر غير مصنف وتحتاج إلى تقليص القائمة.
الخطوات
-
اسرد الأخطاء غير المصنفة
ابحث عن جميع المشاكل في مشروع 'Bugs' بدون أولوية وبدون مسؤول، تم إنشاؤها في آخر 14 يوماً.✓ تم النسخ
→ جدول مرتب مع العناوين
-
اقترح الأولوية والمالك
لكل منها، اقترح الأولوية (Urgent/High/Medium/Low) والفريق الأرجح بناءً على مسارات الملفات أو العلامات المذكورة.✓ تم النسخ
→ اقتراحات معللة، وليس Medium موحد
-
طبّق القرارات
طبّق تلك الأولويات وأسند للفرق المقترحة. أكّد قبل كل كتابة.✓ تم النسخ
→ تأكيد لكل مشكلة
النتيجة: صندوق أخطاء مصنف بالكامل مع معاليل قابلة للتتبع لكل مشكلة.
المزالق
- إسناد جماعي لشخص واحد يصادف أنه ظهر في آخر commits — قصر الإسنادات على مستوى الفريق وليس الفرد — أرخص في الإصلاح لاحقاً
متى تستخدمه: قبل اجتماع مراجعة الحالة أو تحديث غير متزامن للمصلحين.
الخطوات
-
اجمع حالة المشروع
اختصر مشروع 'Mobile v2.0': عدد المشاكل حسب الحالة و% مكتمل وما تغير منذ الاثنين الماضي.✓ تم النسخ
→ لقطة رقمية + دلتا
-
استدعِ المخاطر
اسرد أعلى 3 مخاطر — مشاكل محجوبة أو متأخرة أو بدون مالك.✓ تم النسخ
→ مخاطر مرتبة مع الأسباب
-
صيّغ التحديث
اكتب تحديث حالة بـ 5 نقاط: التقدم والشحنة هذا الأسبوع والأسبوع القادم والمخاطر والطلبات.✓ تم النسخ
→ فقرة أو نقاط جاهزة للنسخ
النتيجة: تحديث موجز للمصلحين لم تضطر إلى كتابته بنفسك.
المزالق
- التحديثات تصبح موحدة 'on track' — أجبر Claude على اختيار مخاطر فعلية من مشاكل قديمة؛ لا تدعه يقرب للأخضر
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
عكس نشاط المشاكل من GitHub إلى Linear للتتبع
لكل مشكلة مُغلقة في octocat/api هذا الأسبوع، ضع علامة على مشكلة Linear المطابقة كـ Done واترك تعليقاً يربط بـ PR.✓ تم النسخ
ملء أخطاء Linear تلقائياً من تنبيهات Sentry بالأولوية الصحيحة
لكل مشكلة Sentry معلمة 'unresolved' مع >100 حدث اليوم، أنشئ خطأ Linear في فريق BACKEND بأولوية High.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- Linear API: 1500 طلب / ساعة على المفاتيح الشخصية
- الرموز لكل استدعاء
- 200–2000 رمز لكل خطوة تقرير
- التكلفة المالية
- مجاني — خطط Linear المجانية والمعيارية تدعم وصول API
- نصيحة
- ادمج حقول GraphQL في استعلام واحد — يوفر حد السعر والميزانية الرمزية
الأمان
الصلاحيات والأسرار ونطاق الأثر
الحد الأدنى من الصلاحيات: read
تخزين بيانات الاعتماد: مفتاح Linear API في متغير بيئة (LINEAR_API_KEY). لا تلصق أبداً في الـ prompt.
نقل البيانات الخارجي: api.linear.app فقط
لا تمنح أبدًا: admin (org-wide write)
- قد تحتوي المشاكل والمشاريع والدورات على معلومات خريطة طريق سرية — فكّر مرتين قبل اللصق في أدوات خارجية.
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
401 من Linear API
أعد إنشاء مفتاح API في linear.app/settings/api؛ تأكد من تصدير LINEAR_API_KEY في shell الذي يعمل Claude Code فيه.
تحقق: echo $LINEAR_API_KEY | head -c 6
حد السعر المضروب أثناء تقرير كبير
اطلب من Claude التحديث مع حقول أقل؛ أو قسّم التقرير حسب الفريق.
البدائل
linear-claude-skill مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| Linear MCP (الرسمية) | تريد سطح أداة JSON-RPC بدلاً من مهارة prompt | MCP يعطي أدوات حقيقية؛ المهارة تعطي نصائح أفضل ونثراً مفصلاً |
| مهارة Jira | فريقك يستخدم Jira بدلاً من Linear | نموذج بيانات مختلف تماماً |