تخطَّ إلى المحتوى
+ أضف منتج إنشاء حساب تسجيل الدخول

مدرب كود Python النظيف

تطوير الخلفية agent-skills cli rest MIT
⬇ تنزيل vsha-0ff0b12c6cc6

SHA-256: 0ff0b12c6cc6e2dfb96e64f7d90acb4d9a3df85606f5165cccbcb3f55c16c870 3 كيلوبايت

✦ جاهزة لبيئة عملك

ثبّت هذه المهارة مباشرة داخل وكيلك

اختر الوكيل، انسخ الأمر، وشغّله من مجلد مشروعك. يتولى CLI تنزيل الحزمة والتحقق من بصمة SHA-256 ووضع الملفات في المسار المناسب.

$npx @ai-dalil/skills add python-clean-code-coach --agent codex

@ai-dalil/skills على npm - Node.js 18.18 أو أحدث.

↓ تنزيل ZIP · الإصدار sha-0ff0b12c6cc6 بيانات API ↗ سجل الإصدارات ↗

الوصف

عربي

يرفع جودة كود Python: أسماء صادقة، دوال قصيرة، أنواع إرشادية، واختبارات تصون السلوك قبل التعديل.

English

Raise Python code quality: honest names, short functions, type hints, and behavior-locking tests before changes.

بيانات المهارة التقنية

SKILL name
python-clean-code-coach
الوصف الأصلي
Raise Python code quality: honest names, short functions, type hints, and behavior-locking tests before changes.
إصدار المهارة
2.0.0
التوافق
بيئة خادم بـPHP 8+ أو Node.js 18+ حسب المشروع
الأدوات المسموح بها
Read, Write, Bash
الكلمات المفتاحية
python, clean-code, backend, quality
لغة المصدر
multilingual
الفرع / المرجع
main
دليل الترخيص
Original editorial content authored for the AiDalil catalog and released under MIT by the catalog owner. (high)

بيانات المصدر الأصلية (YAML)

عرض Frontmatter الأصلي
name: python-clean-code-coach
description: Raise Python code quality: honest names, short functions, type hints, and behavior-locking tests before changes.
version: 2.0.0
metadata:
  author: AiDalil Editorial
  category: backend
  compatibility: goose, gemini-cli, droid, cline, zed, api
  difficulty: beginner
  tags: [python, clean-code, backend, quality]

تعليمات SKILL.md

المحتوى الأصلي للمهارة كما ورد من المصدر، مع الحفاظ على تنسيق Markdown.

عرض التعليمات الكاملة
# Python Clean Code Coach

**Goal:** Raise Python code quality: honest names, short functions, type hints, and behavior-locking tests before changes.

> الهدف: يرفع جودة كود Python: أسماء صادقة، دوال قصيرة، أنواع إرشادية، واختبارات تصون السلوك قبل التعديل.

## When to use
- الحالة النموذجية: يرفع جودة كود Python: أسماء صادقة، دوال قصيرة، أنواع إرشادية، واختبارات تصون السلوك قبل التعديل.
- مراجعة جاهزية الخدمة قبل الإطلاق.
- تصميم أو إعادة هيكلة خدمات الخلفية وواجهات البرمجة.
- إصلاح أخطاء منطق الأعمال أو تدفقات البيانات الخلفية.
- تحسين أداء الاستعلامات وزمن الاستجابة.

## Workflow
1. اكتب اختبارات فاشلة أولاً تغطي الحالة الرئيسية وحالات الحدود.
2. اقرأ الكود المحيط وارسم التدفق الحالي للبيانات قبل أي تعديل.
3. جهّز خطة تراجع وحدّد نقطة تحقق قبل النشر.
4. نفّذ أصغر تغيير يجعل الاختبارات تنجح دون التفاؤل المبكر.
5. وثّق التغيير في سجل الواجهات وحدّث أمثلة الطلبات والاستجابات.
6. راجع الأثر على الأداء: عدد الاستعلامات، الأقفال، والذاكرة.
7. صِغ الهدف: مدرب كود Python النظيف. اذكر العقد المتوقع: المدخلات، المخرجات، ورسائل الخطأ.
8. أضف التحقق من المدخلات ومعالجة أخطاء صريحة برسائل قابلة للتنفيذ.

## Rules
- كل ميزة جديدة تأتي مع اختبار ولوحة مراقبة أو سجل منظم.
- الأسرار تُقرأ من الإعدادات الآمنة فقط ولا تُكتب في الكود.
- كل نقطة نهاية تتحقق من الصلاحيات قبل أي قراءة أو كتابة.
- لا استعلامات داخل حلقات؛ اجمع ثم استعلم دفعة واحدة.
- رسائل الخطأ تشرح السبب ولا تكشف تفاصيل داخلية حساسة.

## Output contract
- قائمة نقاط النهاية أو الجداول المتأثرة.
- أمثلة طلبات واستجابات جاهزة للنسخ.
- وصف تغيير بصيغة: السبب، الحل، الأثر، وطريقة الاختبار.
- ملخص اختبارات مع أعداد الحالات الناجحة.

## Quality checks
- [ ] هل عادت جميع الاختبارات الموجودة إلى الاخضرار بعد التغيير؟
- [ ] هل خطة التراجع مكتوبة ومجرَّبة على بيئة شبيهة بالإنتاج؟
- [ ] هل التوثيق محدث ويطابق السلوك الفعلي؟
- [ ] هل تمت مراجعة الصلاحيات على كل مسار جديد؟
- [ ] هل السجلات تسمح بتتبع طلب واحد من بدايته لنهايته؟

## Skill identity
- Skill name: `python-clean-code-coach`
- Version: 2.0.0
- Domain: Backend Development (تطوير الخلفية)
- Tags: python, clean-code, backend, quality

التثبيت اليدوي

استخدم هذا المسار عند عدم استخدام CLI أو عند إدارة ملفات المهارات يدويًا.

  1. نزّل ملف ZIP للإصدار المطلوب من أعلى الصفحة، أو افتح المصدر الأصلي إذا لم تتوفر حزمة مستضافة.
  2. فك الضغط، ثم انقل مجلد المهارة الذي يحتوي مباشرة على SKILL.md إلى مجلد الوكيل.
  3. أعد تحميل الوكيل أو افتح جلسة جديدة، ثم تأكد من ظهور المهارة ضمن المهارات المتاحة.
Codex.agents/skills/python-clean-code-coach/
Claude Code.claude/skills/python-clean-code-coach/
Cursor.cursor/skills/python-clean-code-coach/

تعليمات خاصة بهذه المهارة

Extract the skill folder into your agent's skills directory (for example the project skills folder) or install the ZIP package from the skill page. No build step is required; everything is Markdown.

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

• تصميم أو إعادة هيكلة خدمات الخلفية وواجهات البرمجة. • إضافة ميزة جديدة تتطلب نقاط نهاية أو مهام خلفية. • تحسين أداء الاستعلامات وزمن الاستجابة.

المتطلبات

• Any Agent Skills compatible assistant (Claude Code, Claude Desktop, or API agents). • Basic file access to read the bundled reference playbook. • No external services required for the standard workflow.

الإصدارات

الإصدار الحجم الملفات تاريخ النشر تنزيل
vsha-0ff0b12c6cc6 3 كيلوبايت 2 4 نوفمبر، 2026 تحميل

الأمان والفحص

فحص أساسي ✓ — 1 نوفمبر، 2026

مجتمع يبني قدرات أفضل

هل طوّرت مهارة تستحق أن يكتشفها الآخرون؟

ساهم في إثراء مكتبة المهارات، وعرّف المجتمع على عملك مع حفظ نسبه إلى مصدره الأصلي.

أرسل مهارة كيف تعمل المهارات؟
قسم المهارات — دليل AIالعودة إلى دليل AI ↗