● مجتمع
netresearch
⚡ فوري
jira-skill
بواسطة netresearch · netresearch/jira-skill
مهارتان (jira-communication و jira-syntax) تغلفان واجهات برمجة تطبيقات Jira Server و DC و Cloud عبر shell — القضايا و JQL و الحلقات الزمنية والسجلات الزمنية والمرفقات، بدون الحاجة إلى Docker.
مجموعة مهارات Claude Code لـ Jira بدون اعتماد على الحاويات. jira-communication تغطي عمليات API (الحصول على / التحديث / البحث بـ JQL / الانتقال / التعليق / الربط / السجل الزمني / المرفق / إدارة اللوحة والحلقات). jira-syntax تساعد في ترميز Jira wiki. تعمل مع Server و DC و Cloud عبر بيانات اعتماد قائمة على البيئة، تتضمن jira-setup.py تفاعلي للتكوين.
لماذا تستخدمه
الميزات الأساسية
- تعمل مع Jira Server و DC و Cloud
- بدون Docker — shell و Python نقيان
- دورة حياة كاملة للقضايا: الإنشاء والانتقال والتعليق والربط والسجل الزمني والمرفق
- مساعدات البحث عن JQL
- إدارة الحلقات واللوحات
- محرر بيانات اعتماد
jira-setup.py التفاعلي - مساعد jira-syntax لترميز wiki
عرض مباشر
كيف يبدو في الممارسة
حالات الاستخدام
استخدامات عملية: jira-skill
متى تستخدمه: في منتصف الحلقة عندما تنخفض السرعة وتشك في وجود عوائق.
الخطوات
-
قائمة القضايا حسب الحالة
استخدم jira-skill. اسرد القضايا في الحلقة 'Sprint 42' مجمعة حسب الحالة. علم أي شيء لم يتم تحديثه في 3 أيام.✓ تم النسخ
→ جدول مجمع مع علامات التقادم
-
الانقر على العوائق
بالنسبة للقضايا المعطلة، اسحب آخر تعليق والقضايا المرتبطة — من ينتظر ماذا؟✓ تم النسخ
→ ملخص الاعتماديات
-
اتصل بأصحاب المشروع
صيغ تعليقًا على كل قضية معطلة تنبه الطرف المسؤول.✓ تم النسخ
→ مسودات لكل قضية
النتيجة: قائمة واضحة بإجراءات فك الحجب لتنفيذها في الاجتماع اليومي.
المزالق
- الإفراط في التنبيهات — التعليقات تكلف الانتباه — دع Claude يصيغ؛ انشر يدويًا فقط الأهم منها
متى تستخدمه: عند قطع إصدار وتحتاج إلى ملاحظات موجهة للمستخدم من قائمة القضايا.
الخطوات
-
JQL للإصدار
JQL: fixVersion = 1.42 AND status = Done. اسحب الملخصات والأنواع.✓ تم النسخ
→ قائمة قضايا مرتبة
-
صيغ الملاحظات
جمّع حسب النوع (Feature / Bug / Improvement) واكتب ملاحظات إصدار موجهة للمستخدم — بدون مصطلحات داخلية.✓ تم النسخ
→ ملاحظات Markdown جاهزة للنشر
النتيجة: ملاحظات الإصدار في دقائق بدلاً من ساعات.
متى تستخدمه: نقل مجموعة من القضايا بين الحالات (مثل deploy-complete).
الخطوات
-
تشغيل تجريبي أولاً
ابحث عن جميع قضايا 'In Staging' مع fixVersion = 1.42. لا تنتقل بعد — اسرد فقط.✓ تم النسخ
→ قائمة للتأكيد
-
الانتقال
انقل هذه إلى 'Done' مع تعليق 'تم النشر في الإنتاج في 1.42'.✓ تم النسخ
→ نتيجة الانتقال لكل قضية
النتيجة: حالة workflow نظيفة، لا شيء متبقي في 'In Staging'.
المزالق
- حقول مفقودة على الانتقال — تسلط المهارة الضوء على الحقل المطلوب؛ وفره في prompt
متى تستخدمه: مراجعة السعة في نهاية الشهر.
الخطوات
-
استعلام السجلات الزمنية
اسحب جميع السجلات الزمنية لأعضاء الفريق في مشروع ACME لآخر شهر.✓ تم النسخ
→ إجمالي الساعات لكل شخص وكل قضية
-
ملخص
اجمع إلى epic والنسبة من الإجمالي.✓ تم النسخ
→ تفصيل المستوى الأعلى
النتيجة: صورة السعة مستندة إلى العمل المسجل الفعلي.
المزالق
- السجلات الزمنية لم تملأ — بيانات سيئة — وضع علامة على الأشخاص الذين لا يملكون سجلات؛ لا تستخلص نتائج من البيانات المفقودة
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
ربط PRs بقضايا Jira أو إنشاء قضايا Jira من أخطاء GitHub
لكل مشكلة GitHub مصنفة كـ 'bug' تم فتحها هذا الأسبوع، أنشئ تذكرة Jira في مشروع ACME.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- Jira Cloud: 10 طلب/ثانية لكل مستخدم عادة؛ Server/DC قابل للتكوين على المستوى الخادم
- الرموز لكل استدعاء
- منخفض — معظمها استجابات API
- التكلفة المالية
- مهارة مجانية؛ ترخيص Jira منفصل
- نصيحة
- استخدم مرشحات JQL على جانب الخادم بدلاً من سحب الكل والتصفية على جانب العميل
الأمان
الصلاحيات والأسرار ونطاق الأثر
الحد الأدنى من الصلاحيات: قراءة المشروع؛ الكتابة فقط حيث لزم الأمر (transition/comment)
تخزين بيانات الاعتماد: JIRA_URL + JIRA_USER + JIRA_TOKEN في البيئة؛ لا تتحقق من git
نقل البيانات الخارجي: فقط إلى مضيف Jira الخاص بك
لا تمنح أبدًا: Admin على المثيل
- يجب أن تكون رموز API لـ Cloud ذات نطاق مستخدم؛ بالنسبة لـ Server/DC استخدم رموز الوصول الشخصي وليس كلمات المرور.
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
401 Unauthorized
الرمز مفقود أو ملغى؛ أعد تشغيل jira-setup.py
تحقق: curl -u $JIRA_USER:$JIRA_TOKEN $JIRA_URL/rest/api/2/myself
400 on transition
الانتقال يتطلب حقلاً لم تقدمه — افحص الانتقالات باستخدام get_transitions
Search returns 0 but issues exist
JQL أو أذونات المشروع الخاصة بك؛ تحقق من أن المستخدم يمكنه رؤية المشروع
البدائل
jira-skill مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
| Atlassian's official MCP | إذا فضلت التكامل من الطرف الأول | تحكم أقل على وصول shell |