소스 정보
- 저장소
- salmandev/arabic-skills-library
- 최근 소스 활동
- 2026년 4월 27일 19:21
- 감지된 SKILL.md 언어
- 다국어 혼합
- 스타
- 0
- 포크
- 0
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
메뉴
기본적으로 소스를 먼저 확인하는 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에서 현재 제공할 수 있는 파일을 다운로드하세요.
SKILL.md 표시 중
SOC 직업 분류 기준
| 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;
✅ استخدم عربية فصحى واضحة ✅ اشرح "لماذا" وليس فقط "ماذا" ✅ استخدم مصطلحات تقنية إنجليزية مع شرح عربي ✅ حافظ على اتساق المصطلحات ✅ حدّث التعليقات عند تحديث الكود ✅ استخدم أمثلة عملية عند الحاجة
❌ لا تكرر ما يفعله الكود بوضوح ❌ لا تستخدم عامية في التعليقات الرسمية ❌ لا تترك تعليقات قديمة أو غير دقيقة ❌ لا تبالغ في عدد التعليقات ❌ لا تستخدم ترجمة آلية ركيكة