/ الدليل / الملعب / linear-claude-skill
● مجتمع wrsmith108 ⚡ فوري

linear-claude-skill

بواسطة wrsmith108 · wrsmith108/linear-claude-skill

مهارة Claude تعلّم الوكيل إدارة المشاكل والمشاريع والدورات عبر Linear MCP و SDK.

استنسخ هذه المهارة في ~/.claude/skills/ ليتعلم Claude نموذج بيانات Linear عملياً: الفرق والدورات وحالات المشاكل واستعلامات GraphQL والأتمتة الشائعة. تغلف الواجهة Linear MCP (أو استدعاءات SDK المباشرة) بأنماط معروّفة بحيث يقوم الوكيل بالفرز والتحويلات وإعداد التقارير دون إعادة اختراع الواجهة البرمجية في كل مرة.

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

linear-claude-skill.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add linear-claude-skill -- git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear-claude-skill

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

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

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

كيفية إجراء مراجعة دورة Linear أسبوعية مع Claude

👤 مديرو الهندسة والقادة التقنيون في فريق Linear ⏱ ~15 min beginner

متى تستخدمه: عصر يوم الجمعة، تحتاج إلى معرفة ما تم شحنه في هذه الدورة وما تأخر وما يجب تحويله.

المتطلبات الأساسية
  • مفتاح Linear API أو Linear MCP مثبتاً — linear.app/settings/api — أنشئ مفتاح API شخصياً
  • المهارة مستنسخة — git clone https://github.com/wrsmith108/linear-claude-skill ~/.claude/skills/linear-claude-skill
الخطوات
  1. اطلب من Claude سحب الدورة الحالية
    اعرض كل مشكلة في الدورة الحالية للفريق ENG — مجمعة حسب الحالة مع المسؤول.✓ تم النسخ
    → جدول: Backlog / In Progress / In Review / Done مع معرّفات المشاكل
  2. تشخيص الأمور المتأخرة
    أي المشاكل لا تزال In Progress أو In Review مع تبقي يومين؟ من يملكها؟✓ تم النسخ
    → سطر واحد لكل مشكلة مع تنبيه المخاطر
  3. تحويل المشاكل واكتب الملخص
    حوّل المشاكل غير المكتملة إلى الدورة التالية وأنشئ مسودة ملخص Slack لما تم شحنه فعلاً.✓ تم النسخ
    → تأكيد التحويل + ملخص جاهز للنسخ

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

المزالق
  • Claude يحول مشاكل كنت تنوي إلغاءها — أخبره 'اقائم أولاً، وأكد، ثم غيّر' — احتفظ بنقطة تحقق بشرية قبل الكتابة
اجمعها مع: github · slack

فرز صندوق الأخطاء مع معاليل الأولويات

👤 مهندسو الخدمة الجاهزة، القادة التقنيون ⏱ ~25 min intermediate

متى تستخدمه: صباح الاثنين، مشروع Bugs يحتوي على 40 عنصر غير مصنف وتحتاج إلى تقليص القائمة.

الخطوات
  1. اسرد الأخطاء غير المصنفة
    ابحث عن جميع المشاكل في مشروع 'Bugs' بدون أولوية وبدون مسؤول، تم إنشاؤها في آخر 14 يوماً.✓ تم النسخ
    → جدول مرتب مع العناوين
  2. اقترح الأولوية والمالك
    لكل منها، اقترح الأولوية (Urgent/High/Medium/Low) والفريق الأرجح بناءً على مسارات الملفات أو العلامات المذكورة.✓ تم النسخ
    → اقتراحات معللة، وليس Medium موحد
  3. طبّق القرارات
    طبّق تلك الأولويات وأسند للفرق المقترحة. أكّد قبل كل كتابة.✓ تم النسخ
    → تأكيد لكل مشكلة

النتيجة: صندوق أخطاء مصنف بالكامل مع معاليل قابلة للتتبع لكل مشكلة.

المزالق
  • إسناد جماعي لشخص واحد يصادف أنه ظهر في آخر commits — قصر الإسنادات على مستوى الفريق وليس الفرد — أرخص في الإصلاح لاحقاً
اجمعها مع: github

توليد تحديث حالة المشروع من Linear

👤 مديرو المنتجات والمديرون التقنيون الذين يدسرون مشاريع متعددة الدورات ⏱ ~15 min beginner

متى تستخدمه: قبل اجتماع مراجعة الحالة أو تحديث غير متزامن للمصلحين.

الخطوات
  1. اجمع حالة المشروع
    اختصر مشروع 'Mobile v2.0': عدد المشاكل حسب الحالة و% مكتمل وما تغير منذ الاثنين الماضي.✓ تم النسخ
    → لقطة رقمية + دلتا
  2. استدعِ المخاطر
    اسرد أعلى 3 مخاطر — مشاكل محجوبة أو متأخرة أو بدون مالك.✓ تم النسخ
    → مخاطر مرتبة مع الأسباب
  3. صيّغ التحديث
    اكتب تحديث حالة بـ 5 نقاط: التقدم والشحنة هذا الأسبوع والأسبوع القادم والمخاطر والطلبات.✓ تم النسخ
    → فقرة أو نقاط جاهزة للنسخ

النتيجة: تحديث موجز للمصلحين لم تضطر إلى كتابته بنفسك.

المزالق
  • التحديثات تصبح موحدة 'on track' — أجبر Claude على اختيار مخاطر فعلية من مشاكل قديمة؛ لا تدعه يقرب للأخضر
اجمعها مع: github

التركيبات

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

linear-claude-skill + github

عكس نشاط المشاكل من GitHub إلى Linear للتتبع

لكل مشكلة مُغلقة في octocat/api هذا الأسبوع، ضع علامة على مشكلة Linear المطابقة كـ Done واترك تعليقاً يربط بـ PR.✓ تم النسخ
linear-claude-skill + sentry

ملء أخطاء Linear تلقائياً من تنبيهات Sentry بالأولوية الصحيحة

لكل مشكلة Sentry معلمة 'unresolved' مع >100 حدث اليوم، أنشئ خطأ Linear في فريق BACKEND بأولوية High.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
cycle-reporting team, cycle selector تحتاج لقطة من دورة ما N Linear API calls (read-only)
issue-triage filter (project, state, labels) تنظيف الأخطاء أو الرتل أسبوعياً Read-only until user confirms writes
issue-creation title, description, team, priority, labels ملء مشاكل منظمة من ملاحظات الاجتماع أو أحداث Sentry/GitHub 1 write per issue
project-status project id قبل التحديثات للمصلحين Read-only

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

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

حصة API
Linear API: 1500 طلب / ساعة على المفاتيح الشخصية
الرموز لكل استدعاء
200–2000 رمز لكل خطوة تقرير
التكلفة المالية
مجاني — خطط Linear المجانية والمعيارية تدعم وصول API
نصيحة
ادمج حقول GraphQL في استعلام واحد — يوفر حد السعر والميزانية الرمزية

الأمان

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

الحد الأدنى من الصلاحيات: read
تخزين بيانات الاعتماد: مفتاح Linear API في متغير بيئة (LINEAR_API_KEY). لا تلصق أبداً في الـ prompt.
نقل البيانات الخارجي: api.linear.app فقط
لا تمنح أبدًا: admin (org-wide write)

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

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

المهارة لا تتفعل

تأكد من وجود SKILL.md في ~/.claude/skills/linear-claude-skill/SKILL.md وأعد تشغيل Claude Code.

تحقق: ls ~/.claude/skills/linear-claude-skill/
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 بدلاً من مهارة promptMCP يعطي أدوات حقيقية؛ المهارة تعطي نصائح أفضل ونثراً مفصلاً
مهارة Jiraفريقك يستخدم Jira بدلاً من Linearنموذج بيانات مختلف تماماً

المزيد

الموارد

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

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

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