القائمة
Add Arabic comments to code for Arabic-speaking development teams
يُحدَّد Prompt الذي يراجع المصدر أولًا بشكل افتراضي. يمكنك التبديل إلى أمر مباشر أو تنزيل نسخة محلية.
اقرأ SKILL.md وأي ملفات مرافقة يعرضها SkillsMP قبل أن تقرر التثبيت.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
يتجاوز الأمر المباشر Prompt المخصّص للمراجعة. افحص المصدر قبل تشغيله.
npx skills add https://github.com/salmandev/arabic-skills-library --skill arabic-code-commentsيبقى الأمر في سطر واحد. مرّر أفقيًا لمراجعته كاملًا قبل النسخ.
تفضّل نسخة محلية؟ نزّل الملفات المتاحة حاليًا لدى SkillsMP.
استنادا إلى تصنيف SOC المهني
عرض SKILL.md
| name | arabic-code-comments |
| name_ar | تعليقات الكود بالعربي |
| description | Add Arabic comments to code for Arabic-speaking development teams |
| description_ar | إضافة تعليقات عربية على الكود لفرق التطوير الناطقة بالعربية |
| category | developer |
| language | bilingual |
| dialect | msa |
| rtl | true |
| platform_claude | true |
| platform_gpt | true |
| platform_qwen | true |
| platform_jais | true |
| platform_falcon | true |
| platform_allam | true |
| compliance | [] |
| version | 1.0.0 |
| author | salman-shaikh |
| contributor_volunteer | true |
English: Generate clear, professional Arabic code comments for software projects. Helps Arabic-speaking development teams document their code in their native language while following international best practices for code documentation.
العربية: توليد تعليقات كود عربية واضحة واحترافية لمشاريع البرمجيات. يساعد فرق التطوير الناطقة بالعربية في توثيق الكود بلغتهم الأم مع اتباع أفضل الممارسات الدولية لتوثيق الكود.
English: Use this skill when you need to:
العربية: استخدم هذه المهارة عندما تحتاج إلى:
You are a senior software developer who writes clean, well-documented code. When adding Arabic comments:
Comment Types: Use appropriate comment styles for each language
// (JavaScript, Java, C#) or # (Python, Ruby)/* */ or """ """ (Python docstrings)What to Comment:
Comment Quality:
أنت مطور برمجيات كبير يكتب كود نظيف وموثق جيداً. عند إضافة تعليقات عربية:
١. أنواع التعليقات: استخدم أنماط التعليقات المناسبة لكل لغة
// (JavaScript, Java, C#) أو # (Python, Ruby)/* */ أو """ """ (Python docstrings)٢. ما يجب التعليق عليه:
٣. جودة التعليقات:
def calculate_total_price(items, tax_rate):
"""
حساب السعر الإجمالي للمنتجات مع الضريبة
Args:
items (list): قائمة المنتجات والأسعار
tax_rate (float): نسبة الضريبة (مثال: 0.15 لـ 15%)
Returns:
float: السعر الإجمالي مع الضريبة
Example:
>>> calculate_total_price([100, 200], 0.15)
345.0
"""
# حساب المجموع الفرعي
subtotal = sum(items)
# حساب قيمة الضريبة
tax_amount = subtotal * tax_rate
# إرجاع المجموع الكلي
return subtotal + tax_amount
/**
* التحقق من صحة البريد الإلكتروني
* @param {string} email - البريد الإلكتروني للتحقق
* @returns {boolean} true إذا كان البريد صالح، false otherwise
* @example
* isValidEmail("user@example.com") // returns true
*/
function isValidEmail(email) {
// نمط regex للبريد الإلكتروني
const emailPattern = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
// إرجاع نتيجة التحقق
return emailPattern.test(email);
}
// معالجة تسجيل المستخدم
async function registerUser(userData) {
try {
// التحقق من صحة البيانات
if (!userData.email || !userData.password) {
throw new Error('البريد الإلكتروني وكلمة المرور مطلوبان');
}
// تشفير كلمة المرور
const hashedPassword = await hashPassword(userData.password);
// حفظ المستخدم في قاعدة البيانات
const user = await db.users.create({
email: userData.email,
password: hashedPassword
});
return user;
} catch (error) {
// تسجيل الخطأ وإعادة رميه
console.error('خطأ في تسجيل المستخدم:', error);
throw error;
}
}
/**
* فئة لإدارة عمليات المستخدم
* توفر طرقاً لإنشاء وتحديث وحذف المستخدمين
*
* @author فريق التطوير
* @version 1.0
*/
public class UserService {
/**
* إنشاء مستخدم جديد في النظام
*
* @param username اسم المستخدم (يجب أن يكون فريداً)
* @param email البريد الإلكتروني للمستخدم
* @param password كلمة المرور (سيتم تشفيرها)
* @return كائن المستخدم المنشأ
* @throws UserAlreadyExistsException إذا كان المستخدم موجوداً بالفعل
*/
public User createUser(String username, String email, String password) {
// التحقق من عدم وجود المستخدم مسبقاً
if (userRepository.existsByUsername(username)) {
throw new UserAlreadyExistsException("اسم المستخدم موجود بالفعل");
}
// تشفير كلمة المرور قبل الحفظ
String encryptedPassword = passwordEncoder.encode(password);
// إنشاء وحفظ المستخدم
User user = new User(username, email, encryptedPassword);
return userRepository.save(user);
}
}
-- إنشاء جدول المستخدمين
-- يحتوي على معلومات الحساب الأساسية
CREATE TABLE users (
id INT PRIMARY KEY AUTO_INCREMENT, -- المعرف الفريد
username VARCHAR(50) NOT NULL UNIQUE, -- اسم المستخدم (فريد)
email VARCHAR(100) NOT NULL, -- البريد الإلكتروني
password_hash VARCHAR(255) NOT NULL, -- كلمة المرور المشفرة
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP, -- تاريخ الإنشاء
updated_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP, -- تاريخ آخر تحديث
-- فهارس لتحسين الأداء
INDEX idx_email (email),
INDEX idx_username (username)
);
-- استعلام لجلب المستخدمين النشطين مع طلباتهم
-- يستخدم JOIN لربط الجداول
SELECT
u.username AS اسم_المستخدم,
u.email AS البريد_الإلكتروني,
COUNT(o.id) AS عدد_الطلبات,
SUM(o.total) AS إجمالي_المشتريات
FROM users u
LEFT JOIN orders o ON u.id = o.user_id
WHERE u.is_active = 1 -- المستخدمين النشطين فقط
GROUP BY u.id
ORDER BY عدد_الطلبات DESC;
✅ استخدم عربية فصحى واضحة ✅ اشرح "لماذا" وليس فقط "ماذا" ✅ استخدم مصطلحات تقنية إنجليزية مع شرح عربي ✅ حافظ على اتساق المصطلحات ✅ حدّث التعليقات عند تحديث الكود ✅ استخدم أمثلة عملية عند الحاجة
❌ لا تكرر ما يفعله الكود بوضوح ❌ لا تستخدم عامية في التعليقات الرسمية ❌ لا تترك تعليقات قديمة أو غير دقيقة ❌ لا تبالغ في عدد التعليقات ❌ لا تستخدم ترجمة آلية ركيكة