Clerk Skills: وجّه الإدماج والفحوص عبر /clerk

لمن يناسب

استخدم هذه المجموعة عندما تريد أن يعالج Agent برمجي مصادقة Clerk بسلاسة أكبر — خاصة لإضافة Clerk إلى مشروع جديد أو أي إطار، أو لفحص المستخدمين والمنظمات والتطبيقات ومفاتيح البيئة والنشر. المهارات تتبع تنسيق Agent Skills وتستهدف مطورين يحتاجون Clerk في المستودع ويريدون أن يختار الـ Agent المهارة الصحيحة قبل أن يلمس شيئاً. النص الرسمي يعلّم /clerk كموجّه ويقول ابدأ دائماً من هنا؛ لا تسمِّ مهارة فرعية من البداية. قبل البدء يجب أن تستطيع فتح Clerk Dashboard والحصول على مفاتيح قابلة للكتابة في ملف بيئة؛ وإلا يتوقف الإدماج والفحص عند نقص المفاتيح.

أكمل المحاولة الأولى في 3 دقائق

التزم فقط بأمر التثبيت من المستودع الرسمي:

npx skills add clerk/skills

بعد التثبيت جهّز المفاتيح أولاً؛ لا تملأ بعناصر نائبة. افتح Clerk Dashboard وانسخ المفتاح القابل للنشر والمفتاح السري واكتبهما في .env للمشروع. يجب أن يكون اسما المفتاحين NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY وCLERK_SECRET_KEY. قبل الكتابة اجعل الـ Agent يعيد هذين الاسمين وملف الهدف فقط؛ اسمح بتغيير الملف بعد تأكيدك.

للمهمة الأولى اختر فحصاً قابلاً للعكس لا تغييراً للإطار. في عميل حمّل المهارات مسبقاً اكتب /clerk وقل إنك تريد فحص نشر أو مطابقة مفاتيح البيئة، ودع الموجّه يأخذك إلى clerk-cli. قبل أي أمر اطلب من الـ Agent أن يقول إن الاستدعاء فحص CLI ولن ينشئ مستخدمين أو يغيّر منظمات. شغّل فقط بعد التأكيد.

إشارة النجاح: ينتقل الـ Agent من /clerk إلى clerk-cli ويعيد نتائج مفاتيح البيئة أو فحص النشر، لا أخطاء مهارة أو مفتاح ناقص. إن كنت تستخدم Codex فللنص الرسمي أمر إضافة سوق منفصل؛ بعد الإضافة أعد التشغيل وافتح /plugins واختر Clerk Skills وثبّت clerk-skills وفعّله ثم افتح خيطاً جديداً. هذا تسلسل خاص بـ Codex؛ لا تعتبره التثبيت الافتراضي.

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

الحالة الأولى: إدماج مشروع جديد أو أي إطار. مهارة clerk-setup الرسمية تضيف Clerk إلى أي إطار، للمشاريع الجديدة وتهيئة الإطار. المسار: أولاً /clerk، اذكر الإطار الحالي و«إضافة إدماج Clerk فقط»، ودع الموجّه يهبط على clerk-setup. هذا النوع يغيّر ملفات المشروع؛ يجب أن يسرد الـ Agent الملفات التي سيغيّرها وتؤكّد قبل الكتابة. الصفحة لا تعطي قائمة أطر ملموسة ولا رقعاً خطوة بخطوة؛ تفاصيل الإطار تتبع ملاحظات المهارة بعد التثبيت.

الحالة الثانية: فحوص تشغيل للقراءة فقط عبر CLI. يغطي clerk-cli المستخدمين والمنظمات والتطبيقات ومفاتيح البيئة وفحوص النشر. بعد كتابة المفاتيح في .env استخدمه لمعرفة إن كان تطبيق قائم قابلاً للنشر، وإن كانت المفاتيح مكتملة، أو لعرض المستخدمين والمنظمات للقراءة فقط. مرة أخرى /clerk أولاً ثم clerk-cli. الصفحة لا تسرد أوامر CLI فرعية ملموسة؛ لا تخترع أسماء أوامر. ما يمكن تأكيده هو فئات الفحص أعلاه؛ صيغة الخرج تتبع التشغيل الفعلي.

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

بدون مفاتيح Dashboard لا تبدأ الإدماج. ملف البيئة يستخدم فقط اسمي المفتاحين اللذين كتبهما النص الرسمي؛ لا تستبدلهما بمتغيرات غير موثّقة. التثبيت الافتراضي هو npx skills add clerk/skills؛ تثبيت السوق ينطبق على Codex فقط ويجب تفعيل clerk-skills بالترتيب الرسمي. ابدأ دائماً من /clerk؛ الصفحة لا تصف مداخل أخرى كطريقة لتجاوز الموجّه. النص الرسمي لا يسرد قائمة عملاء كاملة؛ لا تستنتج دعماً حصرياً من مثال Codex ولا تغطية لغات من أمثلة الصفحة. لا تُكمل أدلة مهارات أو أوامر سوق أو عيّنات مفاتيح غير مكتوبة. صفحة المستودع:

https://github.com/clerk/skills

Dashboard:

https://dashboard.clerk.com/