● مجتمع
mattpocock
⚡ فوري
mattpocock/skills
بواسطة mattpocock · mattpocock/skills
مجلد .claude الشخصي لـ Matt Pocock — مهارات TypeScript والاختبار وسير العمل بمواقف صريحة مباشرةً من متخصص TS.
Matt Pocock (مُعلِّم TypeScript، مُنشئ Total TypeScript) نشر مجلد مهارات Claude Code الشخصي. يشمل أنماط TypeScript المتخصصة، فلسفة الاختبار، أنماط إعادة الهيكلة، وآراء سير العمل. ليست حزمة عامة — بل إعداد مهندس واحد الفعلي.
لماذا تستخدمه
الميزات الأساسية
- اصطلاحات TypeScript من خبير TS معترف به
- نهج اختبار صريح (تجاور الملفات، تكامل أولًا)
- أنماط إعادة هيكلة تُفضّل الحفاظ على سلامة الأنواع
- مهارات سير العمل — أسلوب الcommits، وصف PRs، إلخ.
- مرخَّص MIT
عرض مباشر
كيف يبدو في الممارسة
جاهز
حالات الاستخدام
استخدامات عملية: mattpocock/skills
متى تستخدمه: مشروعك مليء بـ any وأنواع مثيرة للشك وتريد تنظيفًا منهجيًا.
الخطوات
-
الفحص
Use mattpocock/ts-review. Scan /src and list every any, every unsafe cast, every type hole. Group by file.✓ تم النسخ
→ نتائج مُفصَّلة، لا ملخص
-
الإصلاح وفق المبادئ
Fix the top 20, narrowest fix per case. Respect Matt's "prefer inference" rule — don't explicit-annotate what TS can infer.✓ تم النسخ
→ diffs دنيا، سلامة أنواع مُكتسَبة
-
التحقق
Run tsc --noEmit. Any regressions?✓ تم النسخ
→ ترجمة نظيفة أو عناصر متبقية محددة النطاق
النتيجة: قاعدة كود أكثر سلامةً في الأنواع بشكل قابل للقياس وفق منهجية مُبرَّرة.
المزالق
- المهارة تطبق آراء Matt حيث يختلف فريقك (مثلًا interface مقابل type) — جاوز بـ «تخطَّ تحويل interface-vs-type، احتفظ بالأسلوب الحالي»
متى تستخدمه: لديك ميزة جديدة لبنائها وتريد تجربة الاختبار أولًا مع أدوات TypeScript الحديثة.
الخطوات
-
كتابة الاختبار
Use mattpocock/test-first. I want to add a parseInvoice function. Write the test (vitest, integration-over-unit bias) before any impl.✓ تم النسخ
→ اختبار فاشل مع fixtures واقعية
-
التنفيذ
Now the minimal implementation. Type-safe, no any.✓ تم النسخ
→ اختبار ناجح مع أنواع نظيفة
-
إعادة الهيكلة
Apply refactor patterns from the skill — extract helpers if they earn it, no premature abstraction.✓ تم النسخ
→ إعادة هيكلة فقط حيث تستوفي معايير المهارة
النتيجة: مجموعة اختبارات تختبر السلوك، وتنفيذ يُرضيها، وضبط نفس في إعادة الهيكلة.
المزالق
- الآراء تتعارض مع إعداد Jest الحالي للفريق — اطلب من المهارة التكيف — صريحة لكن قابلة لإعادة التوجيه
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
تطبيق على مستودع كامل
Run ts_review over the whole /src tree and report.✓ تم النسخ
mattpocock-skills-skill +
githubفتح PR لكل مراجعة
For the top 3 cleanups, create one PR each with a clear description.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- N/A
- الرموز لكل استدعاء
- كثيف القراءة — خصّص ميزانية لقراءات كبيرة على قواعد كود ضخمة
- التكلفة المالية
- مجاني
- نصيحة
- حدّد النطاق بالمجلد أولًا؛ لا تفحص كل شيء دفعةً واحدة
الأمان
الصلاحيات والأسرار ونطاق الأثر
الحد الأدنى من الصلاحيات: filesystem-read
تخزين بيانات الاعتماد: لا شيء
نقل البيانات الخارجي: لا شيء
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
المهارة تبدو صريحةً جدًا في آرائها
هذا هو الهدف — جاوز آراء محددة في prompt، أو انسخ المهارة وعدّلها
التوصيات تتعارض مع أسلوب الفريق
شارك المخرجات مع الفريق؛ استخدمها نقطة نقاش لا أمرًا واجب التنفيذ
لا تعرف مكتبتي المتخصصة
المهارات عامة لـ TypeScript — ألصق توثيق مكتبتك في بداية السياق
البدائل
mattpocock/skills مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| Your team's linter config | تحتاج إنفاذًا على مستوى CI، لا مراجعة تفاعلية | لا استدلال LLM، لا مساعدة في إعادة الهيكلة |
| Biome / ESLint with typescript-eslint | تريد قواعد حتمية وقابلة للتحديد | لا يُفسّر تفكيره كما تفعل مهارات Matt |