● مجتمع
marian2js
⚡ فوري
skill-doctor
بواسطة marian2js · marian2js/skill-doctor
اختبر مهارات Claude الخاصة بك قبل الشحن - المادة الأمامية، ومراجع الموارد، ووضوح الزناد، وتقييم النظافة، وسجل 0-100 مع درجة الخطورة.
Skill-doctor عبارة عن واجهة سطر أوامر (CLI) تقوم بمسح حزمة المهارات المحلية وتضع علامة على المشكلات التي تؤثر على التنشيط أو الموثوقية أو الجودة. فهو يتحقق من المادة الأمامية والبيانات التعريفية لـ YAML، ويتحقق من عدم انقطاع مراجع الموارد، ويقيم أوصاف المشغلات من أجل الوضوح، ويتحقق من صحة evals/evals.json. النتيجة هي درجة 0-100 مع نتائج مصنفة حسب الخطورة؛ يدعم أوضاع النص وJSON والنتيجة فقط - مثالية للالتزام المسبق أو التوجيه المسبق أو بوابة CI.
لماذا تستخدمه
الميزات الأساسية
- التحقق من صحة المادة الأمامية SKILL.md وبيانات تعريف YAML
- يكتشف الروابط المعطلة وموارد الحزمة المفقودة
- تؤدي النتائج إلى الوصف ووضوح التعليمات
- التحقق من صحة مخطط evals/evals.json
- 0-100 درجة مع نتائج قابلة للتنفيذ
- تنسيقات الإخراج: نص، JSON، النتيجة فقط
- نمط سير عمل GitHub Actions المدمج
عرض مباشر
كيف يبدو في الممارسة
skill-doctor-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: skill-doctor
متى تستخدمه: لقد انتهيت من إحدى المهارات وتريد الحصول على تصريح سلامة عقلية قبل أن يقوم أي شخص آخر بتثبيتها.
المتطلبات الأساسية
- العقدة 18+ — تثبيت nvm 18
الخطوات
-
تشغيل الطبيب
قم بتشغيل طبيب المهارة في جذر المهارة.✓ تم النسخ
→ النتيجة + قائمة النتائج حسب الخطورة
-
إصلاح العناصر عالية الخطورة
قم بإصلاح المشكلات عالية الخطورة أولاً؛ إعادة التشغيل حتى النتيجة ≥ 85.✓ تم النسخ
→ يتسلق النتيجة. يختفي النقاد
النتيجة: مهارة يتم تفعيلها عندما تتوقعها ولا تحتوي على مراجع مقطوعة.
المزالق
- مطاردة الكمال 100 — العناصر منخفضة الخطورة (نمط القمل) غالبًا ما تكون جيدة؛ التركيز على المحفزات والموارد
متى تستخدمه: أنت تقوم بشحن المهارات في كثير من الأحيان وتريد منع الانجراف.
المتطلبات الأساسية
- إجراءات GitHub (أو ما يعادلها) — الريبو مع .github/workflows/
الخطوات
-
أضف سير العمل
أضف وظيفة GH Actions التي تدير برنامج Skill-doctor وتفشل إذا كانت النتيجة أقل من 80.✓ تم النسخ
→ تمت إضافة ملف سير العمل؛ يعمل على العلاقات العامة
-
تعيين الصرامة لكل مسار
مهارات الإنتاج تفشل <90؛ تسمح المسودات <70.✓ تم النسخ
→ المصفوفة أو الحدود الشرطية في سير العمل
النتيجة: يتم القبض على العلاقات العامة التي تقلل من جودة المهارات قبل الدمج.
المزالق
- قفل الشريط عاليًا جدًا في وقت مبكر جدًا — ابدأ بالتسامح، ثم شدد على مدى 2-3 أشهر حتى يتم إصلاح النتائج
متى تستخدمه: لقد قمت بتثبيت مهارة ولكن كلود لم يطلقها أبدًا.
الخطوات
-
تحرير الوصف
أعد كتابة الوصف بحيث تظهر فيه الكلمات الأساسية المحددة لمهمة المستخدم.✓ تم النسخ
→ تنخفض شدة وضوح الزناد
النتيجة: تفعيل أكثر وضوحا؛ يختار كلود المهارة المناسبة للمهام.
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
لينت قبل النشر في السوق
قم بتشغيل Skill-doctor محليًا؛ ثم افتح العلاقات العامة لمهارات oaustegard/clude.✓ تم النسخ
سلسلة مهارات الطبيب مع أدوات تأليف المهارات الأخرى
استخدم Agent-skills-cli للسقالة؛ مهارة الطبيب للتحقق من صحة قبل الالتزام.✓ تم النسخ
اتبع دليل التأليف، ثم الوبر
اكتب وفقًا لدليل كلود للمهارات؛ تحقق مع طبيب المهارة.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- لا شيء - تحليل ثابت محلي
- الرموز لكل استدعاء
- لا شيء (CLI، وليس واجهة برمجة التطبيقات)
- التكلفة المالية
- حر
- نصيحة
- تشغيل فقط على الدلائل التي تغيرت؛ في CI، استخدم مرشحات المسار لتجنب مسح الريبو بالكامل في كل PR.
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: لا أوراق اعتماد
نقل البيانات الخارجي: لا شيء - التحليل المحلي فقط
- يقوم الطبيب الماهر بإبلاغ المشكلات الهيكلية؛ ولا يحكم على الأمن. درجة عالية ≠ مهارة آمنة - لا يزال يتعين عليك مراجعة ما تطلب المهارة من كلود القيام به.
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
يقول الطبيب أن SKILL.md غير موجود
قم بالتشغيل من جذر المهارة (الدليل الذي يحتوي على SKILL.md)، وليس من جذر الريبو.
تحقق: ls SKILL.md in CWD
فشل مخطط "evals/evals.json".
تأكد من أن كل تقييم يحتوي على الحقول المطلوبة؛ كعب قليل خير من مكسور.
تحقق: jq . evals/evals.json
لا تتحسن النتيجة بعد التعديلات
إعادة التشغيل؛ إذا استمرت النتيجة، فاقرأ مدى الخطورة والتفاصيل - في بعض الأحيان تؤدي الإصلاحات إلى ظهور مشكلات جديدة منخفضة الخطورة.
تحقق: Diff the JSON reports between runs
البدائل
skill-doctor مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| agent-skills-cli-skill | تريد أدوات CLI عامة لمهارات السقالات/الإدارة | مجموعة ميزات مختلفة؛ ليس لينتر |
| claude-skill | تريد أن يفهم دليل التأليف كيف تبدو كلمة "جيد". | المستندات، وليس linter |