技能 python-best-practices
🐍

python-best-practices

安全

تطبيق أنماط Python المعتمدة على الأنواع

也可从以下获取: 0xBigBoss

كتابة Python بدون تعريفات الأنواع تؤدي إلى أخطاء في وقت التشغيل وكود صعب الصيانة. توفر هذه المهارة أنماطًا مُختبَرة للاستخدام العملي لتطوير البرامج باستخدام dataclasses وال unions المميزة و Protocols وميزات Python الحديثة الأخرى لجعل الحالات غير القانونية غير قابلة للتمثيل.

支持: Claude Codex Code(CC)
⚠️ 68 差
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“python-best-practices”。 إنشاء frozen dataclass لمنتج مع name و price مطلوبين، description اختياري

预期结果:

  • استخدم @dataclass(frozen=True) لعدم التغيير
  • حدد الحقول المطلوبة بدون قيم افتراضية أولاً
  • أضف الحقول الاختيارية مع قيم افتراضية بعد الحقول المطلوبة
  • علامة frozen=True تمنع التغيير العرضي
  • مثال الإخراج يُظهر الترتيب الصحيح للحقول وتلميحات الأنواع

安全审计

安全
v2 • 1/10/2026

Pure documentation skill containing only markdown guidance. No executable code, no file system access, no network calls, and no external command execution. This skill only provides informational content when loaded by an AI agent.

1
已扫描文件
271
分析行数
0
发现项
2
审计总数
未发现安全问题
审计者: claude 查看审计历史 →

质量评分

38
架构
100
可维护性
83
内容
22
社区
100
安全
78
规范符合性

你能构建什么

تصميم نماذج بيانات آمنة من حيث الأنواع

تعلم استخدام dataclasses و NewType و unions المميزة لترميز قيود المجال على مستوى الأنواع.

مراجعة أنماط أنواع Python

تطبيق أنماط كتابة متسقة عبر قاعدة الكود باستخدام Protocols و TypedDict و unions المتطابقة بالكامل.

توليد Python أصيلة

إنتاج كود Python يتبع أنماط التطوير المعتمدة على الأنواع الحديثة عند العمل مع Claude أو Codex أو Claude Code.

试试这些提示

إنشاء نموذج بيانات 
إنشاء frozen dataclass مع تلميحات أنواع مناسبة لملف شخصي للمستخدم يتضمن حقولًا مطلوبة وصورة رمزية اختيارية. استخدم أنماط python-best-practices.
معالجة آلة الحالة 
نمذجة آلة حالة الطلب مع حالات الخمول والتحميل والنجاح والفشل باستخدام unions المطابقة ونمط المطابقة. طبق أنماط python-best-practices.
إضافة أمان الأنواع 
إنشاء أغلفة NewType لـ UserId و OrderId لمنع الخلط بينهما. أظهر كيفية التحقق من المدخلات وإنشاء الأنواع المغلقة.
تعريف الواجهة 
تعريف Protocol لكائن شبيه بملف مع طريقة read، ثم إظهار استخدامه كتلميح نوع للدوال التي تقبل أي كائن متوافق مع القراءة.

最佳实践

  • حدد الأنواع قبل التنفيذ؛ دع مدقق الأنواع يُرشدك للاكتمال
  • استخدم frozen dataclasses والأنماط غير القابلة للتغيير لمنع تغيير الحالة العرضي
  • تحقق من البيانات على حدود النظام مع فحوصات وقت التشغيل جنبًا إلى جنب مع تلميحات الأنواع

避免

  • استخدام وسائط افتراضية قابلة للتغيير في توقيعات الدوال
  • تجاهل تلميحات الأنواع لأنواع الإرجاع 'الواضحة'
  • التقاط الاستثناءات بدون إعادة طرحها أو إضافة سياق

常见问题

ما إصدارات Python التي تدعم هذه الأنماط؟
نمط المطابقة يتطلب Python 3.10+. تعمل ميزات dataclasses والكتابة على 3.7+. استخدم pyright أو mypy للمشاريع الأقدم.
كيف يقارن هذا بـ Pydantic؟
توفر dataclasses أنواع وقت الترجمة. يضيف Pydantic تحقق وقت التشغيل. استخدم كلاهما معًا للحصول على أقصى أمان.
هل يمكنني استخدام هذا مع FastAPI أو Django؟
نعم. تكمل هذه الأنماط أطر الويب. حدد النماذج باستخدام dataclasses، واستخدمها في معالجات المسارات.
هل تصل هذه المهارة إلى كودي؟
لا. هذه مهارة معرفية فقط. توفر إرشادات لكن لا تستطيع قراءة أو كتابة أو تنفيذ كودك.
أي مدقق أنواع يجب أن أستخدمه؟
يوفر pyright أفضل استدلال وتكامل مع VS Code. يمتلك mypy المزيد من الإضافات. ty هو الأسرع لقواعد الكود الكبيرة.
متى يجب أن أستخدم TypedDict مقابل dataclass؟
استخدم dataclasses للكائنات الداخلية Python. استخدم TypedDict عند مطابقة هياكل JSON أو dict الخارجية.

开发者详情

作者

0xBigBoss

许可证

MIT

仓库

https://github.com/0xBigBoss/claude-code/tree/main/.claude/skills/python-best-practices

引用

main

文件结构

📄 SKILL.md