/ الدليل / الملعب / jira-skill
← كل الخوادم ↗ GitHub
● مجتمع 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-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "jira-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/jira-skill",
        "~/.claude/skills/jira-skill"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "jira-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/jira-skill",
        "~/.claude/skills/jira-skill"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "jira-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/jira-skill",
        "~/.claude/skills/jira-skill"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "jira-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/jira-skill",
        "~/.claude/skills/jira-skill"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "jira-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/netresearch/jira-skill",
        "~/.claude/skills/jira-skill"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "jira-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/netresearch/jira-skill",
          "~/.claude/skills/jira-skill"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add jira-skill -- git clone https://github.com/netresearch/jira-skill ~/.claude/skills/jira-skill

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: jira-skill

فرز المهام المتأخرة في الحلقة وحل القضايا المعطلة

👤 أساتذة Scrum وقادة الفريق التقني ⏱ ~20 min beginner

متى تستخدمه: في منتصف الحلقة عندما تنخفض السرعة وتشك في وجود عوائق.

المتطلبات الأساسية
  • بيانات اعتماد Jira مكونة — قم بتشغيل jira-setup.py وقدم URL + البريد الإلكتروني + API token (Cloud) أو PAT (Server/DC)
  • المهارة مثبتة — git clone https://github.com/netresearch/jira-skill ~/.claude/skills/jira-skill
الخطوات
  1. قائمة القضايا حسب الحالة
    استخدم jira-skill. اسرد القضايا في الحلقة 'Sprint 42' مجمعة حسب الحالة. علم أي شيء لم يتم تحديثه في 3 أيام.✓ تم النسخ
    → جدول مجمع مع علامات التقادم
  2. الانقر على العوائق
    بالنسبة للقضايا المعطلة، اسحب آخر تعليق والقضايا المرتبطة — من ينتظر ماذا؟✓ تم النسخ
    → ملخص الاعتماديات
  3. اتصل بأصحاب المشروع
    صيغ تعليقًا على كل قضية معطلة تنبه الطرف المسؤول.✓ تم النسخ
    → مسودات لكل قضية

النتيجة: قائمة واضحة بإجراءات فك الحجب لتنفيذها في الاجتماع اليومي.

المزالق
  • الإفراط في التنبيهات — التعليقات تكلف الانتباه — دع Claude يصيغ؛ انشر يدويًا فقط الأهم منها
اجمعها مع: github

إنشاء ملاحظات الإصدار من القضايا المغلقة

👤 مديرو الإصدارات ⏱ ~15 min beginner

متى تستخدمه: عند قطع إصدار وتحتاج إلى ملاحظات موجهة للمستخدم من قائمة القضايا.

الخطوات
  1. JQL للإصدار
    JQL: fixVersion = 1.42 AND status = Done. اسحب الملخصات والأنواع.✓ تم النسخ
    → قائمة قضايا مرتبة
  2. صيغ الملاحظات
    جمّع حسب النوع (Feature / Bug / Improvement) واكتب ملاحظات إصدار موجهة للمستخدم — بدون مصطلحات داخلية.✓ تم النسخ
    → ملاحظات Markdown جاهزة للنشر

النتيجة: ملاحظات الإصدار في دقائق بدلاً من ساعات.

اجمعها مع: github

انتقال مجموعي للقضايا عبر workflow

👤 مسؤولو المشروع ⏱ ~10 min intermediate

متى تستخدمه: نقل مجموعة من القضايا بين الحالات (مثل deploy-complete).

الخطوات
  1. تشغيل تجريبي أولاً
    ابحث عن جميع قضايا 'In Staging' مع fixVersion = 1.42. لا تنتقل بعد — اسرد فقط.✓ تم النسخ
    → قائمة للتأكيد
  2. الانتقال
    انقل هذه إلى 'Done' مع تعليق 'تم النشر في الإنتاج في 1.42'.✓ تم النسخ
    → نتيجة الانتقال لكل قضية

النتيجة: حالة workflow نظيفة، لا شيء متبقي في 'In Staging'.

المزالق
  • حقول مفقودة على الانتقال — تسلط المهارة الضوء على الحقل المطلوب؛ وفره في prompt

تلخيص السجل الزمني للفريق للشهر

👤 مديرو الهندسة ومديرو المنتجات الذين يتتبعون السعة ⏱ ~20 min intermediate

متى تستخدمه: مراجعة السعة في نهاية الشهر.

الخطوات
  1. استعلام السجلات الزمنية
    اسحب جميع السجلات الزمنية لأعضاء الفريق في مشروع ACME لآخر شهر.✓ تم النسخ
    → إجمالي الساعات لكل شخص وكل قضية
  2. ملخص
    اجمع إلى epic والنسبة من الإجمالي.✓ تم النسخ
    → تفصيل المستوى الأعلى

النتيجة: صورة السعة مستندة إلى العمل المسجل الفعلي.

المزالق
  • السجلات الزمنية لم تملأ — بيانات سيئة — وضع علامة على الأشخاص الذين لا يملكون سجلات؛ لا تستخلص نتائج من البيانات المفقودة

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

jira-skill + github

ربط PRs بقضايا Jira أو إنشاء قضايا Jira من أخطاء GitHub

لكل مشكلة GitHub مصنفة كـ 'bug' تم فتحها هذا الأسبوع، أنشئ تذكرة Jira في مشروع ACME.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
get_issue issue key في أي وقت 1 API call
search_jql JQL string الاكتشاف 1 API call
create_issue project, type, summary, description تقديم قضية جديدة 1 API call (write)
transition_issue key, transition id/name تحركات workflow 1 API call (write)
add_comment key, body (jira-syntax ok) التنبيهات والملاحظات 1 API call (write)
link_issues key, inward, link type الاعتماديات 1 API call
add_worklog key, time, comment تتبع الوقت 1 API call
sprint_manage board, sprint, action عمليات Scrum 1 API call

التكلفة والحدود

تكلفة التشغيل

حصة API
Jira Cloud: 10 طلب/ثانية لكل مستخدم عادة؛ Server/DC قابل للتكوين على المستوى الخادم
الرموز لكل استدعاء
منخفض — معظمها استجابات API
التكلفة المالية
مهارة مجانية؛ ترخيص Jira منفصل
نصيحة
استخدم مرشحات JQL على جانب الخادم بدلاً من سحب الكل والتصفية على جانب العميل

الأمان

الصلاحيات والأسرار ونطاق الأثر

الحد الأدنى من الصلاحيات: قراءة المشروع؛ الكتابة فقط حيث لزم الأمر (transition/comment)
تخزين بيانات الاعتماد: JIRA_URL + JIRA_USER + JIRA_TOKEN في البيئة؛ لا تتحقق من git
نقل البيانات الخارجي: فقط إلى مضيف Jira الخاص بك
لا تمنح أبدًا: Admin على المثيل

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

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

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills