الأوامر

إذا وجدت نفسك تكتب النوع نفسه من الموجّه مرارًا — «لخّص هذا المشروع»، «راجع تغييراتي»، «اشرح هذا الملف» — تتيح لك الأوامر المخصصة حفظ ذلك الموجّه وتشغيله بأمر واحد بشرطة مائلة.

اكتب / في حقل الإدخال وسترى قائمة بالأوامر المتاحة. الأوامر المدمجة مثل /new و/undo و/help موجودة دائمًا. تظهر الأوامر المخصصة التي تنشئها في القائمة نفسها.

طريقتان لتعريف أمر

ملفات Markdown

أنشئ ملف .md في ~/.config/opencode/commands/ (عام، متاح في كل مشروع) أو .opencode/commands/ (لكل مشروع). يصبح اسم الملف اسم الأمر.

~/.config/opencode/commands/summarize.md:

---
description: Summarize the current project
---
Give me a brief overview of this project. What is it? What are the main files and folders? What does it seem to be for?

الآن يمكنك تشغيل /summarize في أي جلسة OpenCode.

JSON في opencode.json

يمكنك أيضًا تعريف الأوامر مباشرة في ملف إعداداتك:

{
  "$schema": "https://opencode.ai/config.json",
  "command": {
    "summarize": {
      "description": "Summarize the current project",
      "template": "Give me a brief overview of this project. What is it? What are the main files and folders? What does it seem to be for?"
    }
  }
}

كلا النهجين يعطي النتيجة نفسها. ملفات Markdown أسهل للقراءة والتعديل؛ وJSON مريح إذا أردت كل شيء في ملف إعدادات واحد.

جرّبه: أنشئ أمر /summarize

اطلب من OpenCode إنشاء الملف ~/.config/opencode/commands/summarize.md بهذا المحتوى:

---
description: Summarize the current project
---
Give me a brief overview of this project. What is it? What are the main files and folders? What does it seem to be for?

ثم أعد تشغيل OpenCode. تُحمَّل الأوامر عند بدء التشغيل، لذلك لن تظهر ملفات الأوامر الجديدة حتى تعيد فتح التطبيق.

بعد العودة، اكتب /summarize في حقل الإدخال — يفترض أن تراه يظهر في قائمة الإكمال التلقائي. حدّده واضغط Return لتشغيله.

تمرير الوسائط

أضف عنصرًا نائبًا $ARGUMENTS إلى قالبك ويمكنك تمرير سياق إضافي عند استدعاء الأمر:

---
description: Explain a file
---
Explain what $ARGUMENTS does in plain language.

ثم شغّله كـ /explain src/index.ts فيُستبدل $ARGUMENTS بـ src/index.ts.

خيارات إضافية

تدعم الأوامر بضعة خيارات أخرى في الـ frontmatter: agent (تشغيل الأمر بوكيل محدد) وmodel (استخدام نموذج محدد لهذا الأمر). سنغطي الوكلاء في درس لاحق. للمرجع الكامل، راجع وثائق الأوامر.