المهارات slack-bot-builder
📦

slack-bot-builder

آمن

بناء تطبيقات Slack باستخدام إطار عمل Bolt

يتطلب بناء تكاملات Slack التعامل مع المصادقة والأحداث وأنماط واجهة المستخدم المعقدة. توفر هذه المهارة قوالب جاهزة لإطار عمل Bolt للغة Python و JavaScript و Java التي تتعامل مع الأمان وتدفقات OAuth ومكونات Block Kit التفاعلية.

يدعم: Claude Codex Code(CC)
📊 70 كافٍ
1

تنزيل ZIP المهارة

2

رفع في Claude

اذهب إلى Settings → Capabilities → Skills → Upload skill

3

فعّل وابدأ الاستخدام

اختبرها

استخدام "slack-bot-builder". يرسل المستخدم رسالة 'hello bot' في قناة يوجد بها البوت

النتيجة المتوقعة:

يرد البوت بتحية مخصصة: 'Hey there @username!' معترفاً بالمستخدم من خلال معالج Slack الخاص به

استخدام "slack-bot-builder". تنبيه حادث مُفعّل مع تفاصيل انقطاع قاعدة بيانات حرج

النتيجة المتوقعة:

تعرض رسالة Slack رأس دائرة حمراء، وحقول حادث تظهر العنوان والشدة، ووصف مقتطع إلى 2000 حرف، وأزرار إجراءات للاعتراف والتصعيد والحل

استخدام "slack-bot-builder". يكتب المستخدم الأمر /ticket ويرسل نموذجًا بعنوان 'Login Issue' ووصف 'Users cannot access portal' وأولوية 'High'

النتيجة المتوقعة:

تُنشر رسالة تأكيد في القناة: 'Ticket created: Login Issue (High Priority)' مع معرف تذكرة فريد للتتبع

التدقيق الأمني

آمن
v1 • 2/25/2026

All static analysis findings are false positives. The SKILL.md file is documentation containing educational code examples for the Slack Bolt framework. Environment variable usage follows security best practices for credential handling. No executable code with security risks was detected.

1
الملفات التي تم فحصها
269
الأسطر التي تم تحليلها
0
النتائج
1
إجمالي عمليات التدقيق
لا توجد مشكلات أمنية
تم تدقيقه بواسطة: claude

درجة الجودة

38
الهندسة المعمارية
100
قابلية الصيانة
87
المحتوى
22
المجتمع
100
الأمان
91
الامتثال للمواصفات

ماذا يمكنك بناءه

تنبيهات حوادث DevOps

إنشاء بوتات Slack تنشر تنبيهات حوادث منسقة مع مؤشرات الشدة وأزرار إجراءات للاعتراف بالحادث أو تصعياده أو حله مباشرة من Slack.

بوت إشعارات الفريق

بناء بوتات ترسل إشعارات آلية لأنابيب CI/CD ومراجعات الكود أو حالة النشر مع عناصر تفاعلية لاستجابات الفريق السريعة.

نظام تذاكر الدعم

تنفيذ أوامر شرائط ونوافذ منبثقة لإنشاء تذاكر الدعم وتتبعها وتحديثها مع حقول مخصصة وسير عمل التعيين داخل Slack.

جرّب هذه الموجهات

معالج الرسائل الأساسي
أنشئ تطبيق Bolt بلغة Python يستجيب للرسائل التي تحتوي على كلمات رئيسية محددة. قم بإعداد التطبيق باستخدام متغيرات البيئة للرموز المميزة، وأضف مستمع رسائل لكلمة 'hello'، وتضمين أمر شرائط يعترف بالطلب ويرسل رسالة متابعة.
مكون زر تفاعلي
ابنِ رسالة Block Kit مع أزرار إجراءات لإشعار حادث. ضمّن رأسًا مع مؤشر الشدة، وحقولًا لتفاصيل الحادث، وأزرارًا لإجراءات الاعتراف والتصعيد والحل. تعامل مع أحداث نقر الزر مع استدعاءات مناسبة.
جمع نموذج نافذة منبثقة
أنشئ أمر شرائط يفتح نافذة منبثقة مع كتل إدخال لعنوان التذكرة والوصف واختيار الأولوية. تعامل مع إرسال العرض لاستخراج بيانات النموذج وإنشاء رسالة تأكيد تذكرة بالقيم المقدمة.
تطبيق OAuth متعدد مساحات العمل
أعد تطبيق Bolt مع تكوين OAuth 2.0 لنشر متعدد مساحات العمل. نفّذ مخزن تثبيت مدعوم بقاعدة بيانات لاستمرار الرموز المميزة، وقم بتكوين النطاقات المطلوبة بالحد الأدنى، وأضف مسارات إعادة توجيه OAuth للتعامل مع تدفق التثبيت.

أفضل الممارسات

  • اطلب الحد الأدنى من نطاقات OAuth المطلوبة لتقليل احتكاك المستخدم أثناء التثبيت والحد من التعرض الأمني المحتمل
  • اعترف بجميع التفاعلات خلال 3 ثوانٍ باستخدام ack() ثم عالج المنطق بشكل غير متزامن لتجنب أخطاء المهلة
  • خزّن الرموز المميزة والأسرار في متغيرات البيئة أو أقبية آمنة، ولا تقم أبدًا بتضمينها أو تسجيل قيم الاعتماديات في الكود

تجنب

  • تضمين رموز Slack أو أسرار التوقيع مباشرة في كود المصدر بدلاً من استخدام متغيرات البيئة
  • طلب نطاقات OAuth مفرطة 'تحسبًا لأي حالة' مما يزيد المخاطر الأمنية ويقلل من معدل تحويل التثبيت
  • معالجة الأحداث بشكل تزامني بدون إقرار مما يتسبب في إعادة Slack للمحاولة وتكرار الأحداث

الأسئلة المتكررة

كيف أنشئ تطبيق Slack جديد لاستخدامه مع هذه المهارة؟
قم بزيارة https://api.slack.com/apps وانقر على 'Create New App'. اختر 'From scratch' أو 'From an app manifest'. بعد الإنشاء، انتقل إلى 'OAuth & Permissions' لتكوين النطاقات وتثبيت التطبيق في مساحة عملك.
أين أجد سر التوقيع الخاص بـ Slack؟
اذهب إلى إعدادات التطبيق في api.slack.com/apps، وحدد 'Basic Information' من الشريط الجانبي الأيسر، واعثر على 'App Credentials'. انسخ قيمة 'Signing Secret' وخزّنها في متغير البيئة SLACK_SIGNING_SECRET الخاص بك.
ما الفرق بين رموز البوت ورموز المستخدم؟
تمثل الرموز المميزة للبوت (xoxb-) تطبيقك ولديها النطاقات التي قمت بتكوينها. تمثل رموز المستخدم (xoxp-) المستخدمين الفرديين الذين يثبتون تطبيقك وترث أذوناتهم. يُوصى برموز البوت لمعظم سيناريوهات الأتمتة.
هل أحتاج لاستضافة خادم عام لاستقبال أحداث Slack؟
لا. استخدم وضع Socket للتطوير والاختبار، الذي يستقبل الأحداث عبر WebSocket بدون نقاط نهاية عامة. للإنتاج، نقاط نهاية HTTP أكثر موثوقية لكنها تتطلب خادمًا متاحًا للعلن مع HTTPS.
كيف أختبر تخطيطات Block Kit قبل تنفيذها؟
استخدم Block Kit Builder في app.slack.com/block-kit-builder لتصميم ومعاينة تخطيطات رسائلك بصريًا. قم بتصدير بنية JSON ودمجها في كود تطبيق Bolt الخاص بك.
ماذا يحدث إذا تجاوز تطبيقي حدود معدل Slack API؟
يعيد Slack HTTP 429 مع رأس Retry-After يشير إلى الثواني المطلوب الانتظار. نفّذ منطق إعادة محاولة backs-off أسي في تطبيقك وفكّر في تجميع العمليات أو التخزين المؤقت لتقليل استدعاءات API.

تفاصيل المطور

المؤلف

sickn33

الترخيص

MIT

مرجع

main

بنية الملفات

📄 SKILL.md