إضافة أداة
هذه بنية تحتية مشتركة للحركة، وتتحسّن في كل مرة يضيف فيها أحدهم الأداة التي كان يتمنّى لو وجدها. والأفضل من ذلك كلّه أن البوابة آلية، لا اجتماعية — لا شِلَل، ولا حُرّاس بوابات: تدخل الأداة إذا اجتازت محرّك الإنفاذ ووُصِفت بدقّة. سؤال “هل هذا الاعتماد نظيف؟” يجيب عليه الـ CI سلفًا، فتنحصر مهمّة الإنسان في “هل يناسب هذا، وهل وُصِف بأمانة.” مساهمتك تساعد الشخص المنظِّم التالي الذي يحتاجها.
إضافة أداة
Section titled “إضافة أداة”المسار الأقل احتكاكًا. افتح issue باسم New tool واملأ اسم الاعتماد، والنظام البيئي، ورابط المصدر الأولي، والرخصة المُعلَنة. القالب منظَّم بحيث يستطيع القائم على الصيانة (أو skill وكيل) تحويله إلى مدخل موثَّق.
لغير المطوّرين، يأتي الموقع مزوّدًا بنظام إدارة محتوى قائم على Git
(Sveltia) على /admin/. سجّل الدخول عبر GitHub، واملأ الحقول، وسيفتح
لك طلب سحب — طلب السحب نفسه الذي يفتحه المطوّر، فيُشغَّل الـ CI نفسه.
ولّد مدخلًا بأدوات الفهرس وافتح طلب سحب:
# add your tool to data/seed-catalog.json, then:npm run data:fetch # fetches license @ commit, maintenance, metadatanpm run enforce # must passnpm run check # astro schema validationما الذي يفحصه الـ CI قبل الدمج
Section titled “ما الذي يفحصه الـ CI قبل الدمج”-
astro check— يطابق frontmatter مدخلك المخطّط (يجب أن يثبّت المدخل الموثَّق كوميت رخصة؛ ويجب أن يذكر المدخل المحظور السبب). -
طبقة الإنفاذ 1 — الأداة ليست مملوكة لمنظمة مستبعَدة.
-
عقد الوصفة (إذا أضفت وصفة) — يستهدف مدخلًا من نوع
provider_agnosticويستبعد فعليًا مزوّدي نماذج اللغة الكبيرة. -
فحص الروابط الميتة — تُحَلّ روابط مصدرك الأولي ورخصتك.
ابنِ بالـ skills والنموذج الأصلي
Section titled “ابنِ بالـ skills والنموذج الأصلي”يأتي المستودع أيضًا مزوّدًا بأصول قابلة لإعادة الاستخدام للبناء مع وكيل:
اطّلع على البدء السريع لاستخدامها مع Goose أو Claude Code، وإرشادات المساهمة للتدفّق الكامل.
الصيانة والحوكمة
Section titled “الصيانة والحوكمة”كيف يبقى الفهرس محدّثًا، واتفاقيات مستوى خدمة المراجعة، وكيف صُمّم ليتجاوز عمر القائم على صيانته الأول — كلّها موثّقة في حول المشروع والصيانة.