Install
npx skills add vercel-labs/slack-agent-skillلمن يناسب
هذه المهارة موجّهة لمن يريد بناء وكيل Slack ونشره على Vercel. تعمل مع eve (إطار عمل الوكلاء الدائم من Vercel) وVercel Connect (يستضيف بيانات اعتماد Slack). وثائق eve على https://eve.dev/docs وملاحظات Connect على https://vercel.com/kb/guide/vercel-connect ويشدد المستودع على أنك لست بحاجة إلى التعامل بنفسك مع bot token أو signing secret.
الاستخدام الأنسب: تخطط لاستخدام /slack-agent لإنشاء مشروع جديد أو ضبط مشروع قائم، وتختبر أولاً محلياً الأدوات والتعليمات والمحادثات في واجهة النص eve dev، وتؤجّل أحداث Slack إلى ما بعد النشر. لا تناسب من يريد الاحتفاظ بـ signing secret الخاص بـ Slack بنفسه، أو يتوقع النقر على كل الأحداث في واجهة Slack دون نشر.
لا تطبّق أمر التثبيت هذا في بيئة بلا دعم للمهارات (skill). ولا تعتبر نفق ngrok خطوة إلزامية: تنصّ الملاحظات على أن أحداث Slack تُمرَّر عبر Connect إلى المشروع المنشور، وngrok غير مطلوب.
أول محاولة في 3 دقائق
أمر التثبيت الرسمي هو: npx skills add vercel-labs/slack-agent-skill. عنوان المستودع هو https://github.com/vercel-labs/slack-agent-skill اتبع هذه الصفحة فقط. لا تكتب مثبّتات غير موثّقة.
الشروط المسبقة: المساعد الحالي يدعم المهارات، ولديك مجلد فارغ يمكن التخلص منه أو مشروع eve قائم. موضع التثبيت هو مجلد مهارات المساعد. بعد التثبيت تأكد من ظهور /slack-agent new و/slack-agent configure و/slack-agent deploy و/slack-agent test.
أول مهمة منخفضة المخاطر: لا تنشر أولاً. إن بدأت من الصفر فنفّذ أولاً /slack-agent new (يبني هيكلاً أولياً بـ eve)، لكن أكّد قبل كتابة الملفات أن المجلد للتمرين. إن كان لديك مشروع فاستخدم /slack-agent configure (يكتشف eve تلقائياً). إشارة النجاح: اكتمال الهيكل أو الضبط، وأنك لم تنفّذ بعد /slack-agent deploy.
التحقق المحلي يتم عبر واجهة TUI لـ eve dev: اختبر الأدوات والتعليمات والمحادثات. أحداث واجهة Slack تنتظر النشر ثم تصل إلى المشروع عبر Vercel Connect. ملاحظات متغيرات بيئة Slack تذكر فقط SLACK_CONNECTOR؛ لا تخترع عناصر نائبة لأسرار أخرى. /slack-agent test لإعداد الاختبارات؛ انتظر حتى تعمل المحادثات المحلية قبل التفكير فيه.
حالات الاستخدام
الحالة الأولى: هيكل من الصفر. /slack-agent new يبني مشروعاً جديداً بـ eve. يناسب عندما لا يكون لديك مستودع بعد وتريد رؤية بنية الوكيل محلياً أولاً. الملاحظات لا تسرد قائمة الملفات المُنشأة، لذلك يمكنك فقط التحقق من أن «الأمر نجح وظهر مشروع eve». أكّد المجلد قبل الكتابة. صفحة المرجع: https://github.com/vercel-labs/slack-agent-skill
الحالة الثانية: ضبط مشروع قائم وفصل التحقق المحلي عن الإنتاج. /slack-agent configure يكتشف eve تلقائياً. محلياً استخدم eve dev لاختبار الأدوات والتعليمات والمحادثات؛ تصل أحداث Slack عبر Connect بعد النشر ولا حاجة إلى ngrok. /slack-agent deploy ينشر إلى الإنتاج ويجب أن يأتي بعد نجاح TUI المحلي. يتولى Connect استضافة OAuth وتدوير الرموز والتحقق من webhook؛ متغير بيئة Slack المذكور الوحيد هو SLACK_CONNECTOR. لا تشرح الملاحظات خطوات ملء هذا المتغير ولا التراجع في الإنتاج؛ لا تنشر قبل اكتمال ضبط Connect.
حدود الاستخدام
حد التثبيت: الرسمي يذكر فقط npx skills add vercel-labs/slack-agent-skill. حد الأوامر: يمكن التحقق من /slack-agent new وconfigure وdeploy وtest. حد بيانات الاعتماد: لست بحاجة إلى معالجة bot token أو signing secret بنفسك؛ متغير Slack المذكور الوحيد هو SLACK_CONNECTOR. حد الاختبار: يختبر TUI المحلي الأدوات والتعليمات والمحادثات؛ تُتحقق أحداث Slack عبر Connect بعد النشر ولا حاجة إلى ngrok. حد الإطار: eve وVercel Connect هما الاعتماديتان الموثّقتان، والوثائق على https://eve.dev/docs و https://vercel.com/kb/guide/vercel-connect ولا ضمان بأن منصات استضافة أخرى تُستخدم كما هي.