OpenCode: OpenCode AGENTS.md Configuration

آخر تحديث: 2026-08-31

--- title: قواعد OpenCode (AGENTS.md) description: تعلّم كتابة ملفات AGENTS.md لتحديد قيود سلوك AI في مشروعك order: 12 lang: ar

AGENTS.md هو ملف قواعد OpenCode على مستوى المشروع.

1. ما ستتعلمه

• دور AGENTS.md وتموضعه
• إنشاء الملف
• كتابة القواعد
• أفضل الممارسات

2. ما هو AGENTS.md

ملف Markdown في جذر المشروع. AI يقرأه ويتبع قواعده تلقائياً.

3. إنشاء AGENTS.md

TUI: /init أو يدوياً.

4. كتابة القواعد

# Project Rules

## Coding Standards
- Use TypeScript strict mode
- Follow ESLint configuration
- Maximum function length: 50 lines

## Testing Requirements
- All new functions must have unit tests
- Test coverage no less than 80%

## Commit Standards
- Use Conventional Commits format
- Each commit does one thing only

فئات القواعد

• معايير الترميز
• قيود البنية
• متطلبات الاختبار
• معايير الالتزام
• قواعد الأمان
• منطق الأعمال

5. أفضل الممارسات

• القواعد يجب أن تكون محددة
• القواعد يجب أن تكون قابلة للتنفيذ
• رتّب القواعد حسب الأولوية
• شاركها مع الفريق عبر Git

6. AGENTS.md مقابل opencode.json

كلاهما مُكمّل: AGENTS.md يخبر AI "ماذا يفعل"، opencode.json يتحكم "ماذا يمكنه فعله".

❓ الأسئلة الشائعة

📖 الخلاصة

• AGENTS.md ملف قواعد المشروع لـ AI
• أنشئ بـ /init أو يدوياً
• القواعد: محددة، قابلة للتنفيذ، مرتبة
• مُكمّل لـ opencode.json

📝 التمارين

1. أساسي: أنشئ AGENTS.md بـ 5 معايير ترميز.

2. متوسط: عرّف قواعد تدفق تطوير كاملة.

3. متقدم: قارن مخرجات OpenCode مع وبدون AGENTS.md.

فريق Web-Tutorial التقني

منصة دروس برمجية يديرها عدة مطورين. كل درس يتم كتابته ومراجعته بواسطة مطورين متخصصين في المجال. نعمل على ضمان دقة وموثوقية المحتوى — إذا لاحظت أي مشكلة، فيرجى إخبارنا.

من نحن