إن كان فريقك يكتب الكود في GitHub ويتابع العمل في Linear، فقد تبقى المهمة مفتوحة بعد دمج الكود الذي ينجزها. هذه الحزمة اثنا عشر أمرًا (slash commands) لـ Claude Code تتولى هذا الربط: تنقل القضايا (issues) والمهام بين المنصتين، وتربط طلبات الدمج (pull requests) بمهامها، وتكشف تعارضات المزامنة.
الأوامر حسب اتجاه النقل
من GitHub إلى Linear
- sync-issues-to-linear: ينقل القضايا بعناوينها ونصوصها وتسمياتها وأول مكلَّف، ويجعل المفتوحة Backlog أو Todo والمغلقة Done.
- issue-to-linear-task: يحوّل قضية واحدة بتعليقاتها، ويستنتج الأولوية من تسميات مثل critical وblocker وsecurity.
- bulk-import-issues: استيراد جماعي على دفعات يكشف المكرر، ويحفظ ملف ربط لاستئناف استيراد متوقف أو إعادة الفاشل.
- task-from-pr: ينشئ مهمة من طلب دمج، ويقدّر حجمها بالنقاط من عدد الأسطر المعدّلة.
من Linear إلى GitHub
- sync-linear-to-issues: يصدّر مهام فريق أو مشروع إلى قضايا، ويحوّل الأولوية إلى تسميات مثل priority/high.
- linear-task-to-issue: ينقل مهمة واحدة بتعليقاتها ومرفقاتها إلى قضية جديدة.
في الاتجاهين والصيانة
- bidirectional-sync: مزامنة بسجل حالة لكل عنصر، وخمس استراتيجيات للتعارض منها NEWER_WINS وFIELD_LEVEL_MERGE، وعلامة [sync-bot] تمنع دوران التعديل بين المنصتين.
- sync-pr-to-task: يربط طلب الدمج بمهمته (المثال أدناه).
- sync-conflict-resolver: يكشف التعارضات ويحلّها ويحلل أنماطها، ومع خيار interactive يعرض كل تعارض لتختار حله بنفسك.
- cross-reference-manager: يفحص الروابط بين المنصتين ويصلح المكسور منها، ويصدّرها بصيغة JSON أو CSV أو Markdown.
- sync-status: تقرير عن العناصر المعلّقة والفاشلة وحالة webhooks وحصة الطلبات المتبقية.
- sync-automation-setup: يجهّز المزامنة الدائمة: webhooks للمنصتين، وسير عمل GitHub Actions كل خمس عشرة دقيقة، وجداول لحالة المزامنة وسجل التعارضات.
مثال: طلب دمج يحدّث مهمته
تكتب في Claude Code: /commands-integration-sync:sync-pr-to-task 123 --task=ABC-456. وإن حذفت الخيار task يبحث Claude في عنوان الطلب ونصه عن معرّفات مثل ABC-123 أو عبارات fixes وcloses، أو يستخرجها من اسم فرع مثل feature/ABC-123. ثم يضبط حالة المهمة: المسودة Backlog، وطلب التعديلات Todo، والموافقة In Review، والدمج Done، والإغلاق دون دمج Canceled. ويكتب في Linear تعليقًا بالأسطر المضافة والمحذوفة، ويعلّق على الطلب في GitHub ويضيف إليه التسمية linear:ABC-456.
التحميل والمتطلبات
- فكّ ضغط الملف، ثم شغّل من مجلد مشروعك
claude --plugin-dir PATH/TO/EXTRACTED/pluginبمسارك الفعلي (بين علامتي تنصيص إن احتوى مسافات)، فتظهر الأوامر في تلك الجلسة باسم الإضافة commands-integration-sync. - أداة GitHub CLI (gh) مثبتة ومسجّلة الدخول، وخادم MCP لـ Linear متصل بـ Claude Code، وتكلفة النموذج على حسابك. ولا تعمل الأوامر في claude.ai لأنه لا يصل إلى gh على جهازك.
قبل التشغيل
- الأوامر تعليمات يقرؤها Claude، وما فيها من JavaScript وYAML وSQL نماذج يسترشد بها، لا خدمة تعمل في الخلفية؛ فالمزامنة المستمرة تحتاج خادمًا تستضيفه أنت.
- سير عمل GitHub Actions في sync-automation-setup يثبّت حزمة npm @linear/sync-cli، ولم أجدها في سجل npm عند المراجعة؛ فهذه الخطوة تحتاج بديلًا.
- الخيارات في أمثلة الملفات نص يقرؤه النموذج لا برنامج يحللها، والأرقام في أقسام Output Format نماذج لشكل التقرير.
- بعض الأوامر تنشئ قضايا وتعليقات، والصيغة
issue-to-linear-task 123 --close-githubتغلق القضية الأصلية؛ فابدأ بخيار dry-run حيثما يتيحه الأمر، وعلى مستودع تجريبي. - الملفات بالإنجليزية دون تعديل، وأرفقتُ معها دليلًا عربيًا وفهرسًا. وصفتُ كل أمر من نص ملفه.
المصدر والترخيص
كتب هذه الأوامر مجتمع BuildWithClaude في مستودع davepoon/buildwithclaude (commit 2e757da) بترخيص MIT، ونصه في مجلد licenses.
