إنتقل إلى المحتوى الرئيسي

أوامر شرطة مائلة مخصصة

متوسط

يجمع أمر الشرطة المائلة المخصص موجِّهًا تعيد كتابته باستمرار في /word واحدة. عرّفه مرة واحدة؛ وأعد استخدامه إلى الأبد (وشاركه مع فريقك).

What you'll learn
  • اشرح ما هو أمر الشرطة المائلة المخصص ولماذا يتفوق على إعادة كتابة الموجِّه
  • أنشئ أمرًا بوضع ملف Markdown في الدليل الصحيح
  • ميّز بين أوامر المشروع وأوامرك الشخصية من خلال موقعها
  • استخدم اللبنات الأساسية: $ARGUMENTS، ومخرجات bash المضمَّنة، ومراجع الملفات، والواجهة الأمامية (frontmatter)
  • اختر بين أمر شرطة مائلة، ومهارة، ووكيل فرعي لمهمة معينة

كيف تعمل​

الأمر هو مجرد ملف Markdown. ضعه في دليل الأوامر الخاص بك ويصبح اسم الملف هو الأمر. ومتن الملف هو الموجِّه الذي يشغّله Claude عند استدعائك له.

موقع الملف هو الذي يحدد نطاقه:

Guided walkthrough1 of 3
  1. احفظه ضمن .claude/commands/changelog.md ← ‏/changelog. يعيش في المستودع، فيحصل عليه الفريق بأكمله.
Pro tip
  • اسم الملف — وليس الواجهة الأمامية (frontmatter) — هو ما يصبح اسم الأمر. فملف changelog.md هو دائمًا ‏/changelog.

مثال بسيط​

إليك ملف أمر كامل. تحمل الواجهة الأمامية (frontmatter) قيمة description؛ وكل ما يليها هو الموجِّه.

commit.md — صياغة Conventional Commit

---
description: Draft a Conventional Commit message from the staged diff
---

Look at the staged changes with `git diff --cached` and write a single
Conventional Commit message (feat/fix/docs/refactor/chore). Output only the
message, no preamble.

احفظ ذلك باسم commit.md وسينفّذه /commit في كل مرة. (سمِّه باسم الملف نفسه — فالمتن نفسه إذا حُفِظ باسم changelog.md سيكون /changelog.)

اللبنات الأساسية المفيدة​

أربعة مكوّنات تحوّل موجِّهًا ثابتًا إلى أمر مرن:

اللبنة الأساسيةماذا تفعل
$ARGUMENTSتحقن ما كتبه المستخدم بعد الأمر. /review src/auth.ts ← يصل المسار إلى موجِّهك.
تشغيل bash وتضمين المخرجاتيمكن أن تتضمن الأوامر مخرجات الصدفة (shell) (مثل الفرق الحالي diff) كي يتصرف Claude بناءً على الحالة الحيّة.
مراجع الملفاتأشِر إلى الملفات لتضمين محتوياتها.
الواجهة الأمامية (frontmatter)description (تظهر في القائمة) وخيارات أخرى.

راجع الوثائق الرسمية للاطلاع على الصيغة الدقيقة للوسائط (arguments) وbash ومراجع الملفات.

أوامر تستحق السرقة​

توجد مجموعة بداية في مكتبة أوامر الشرطة المائلة: رسالة الإيداع (commit)، ووصف طلب السحب (PR)، ومراجعة الكود، وسجل التغييرات (changelog)، وبناء هيكل مكوّن (scaffold-a-component).

الأمر مقابل المهارة مقابل الوكيل الفرعي​

ثلاث طرق لتغليف العمل — والفرق هو من الذي يطلقه ومدى انعزال تشغيله:

  • أمر الشرطة المائلة — أنت تطلق سير عمل معروفًا عند الطلب.
  • المهارة — يحمّل Claude الخبرة تلقائيًا عندما تكون ذات صلة.
  • الوكيل الفرعي — تفويض جزء من العمل إلى وكيل معزول.
اضغط Enter أو مفتاح المسافة لقلب البطاقة. استخدم مفتاحي السهمين الأيسر والأيمن للتنقل بين البطاقات.تم إظهار المصطلح.
1 / 6

اختبر نفسك

0/4
  1. أين تحفظ أمر شرطة مائلة كي يحصل عليه فريقك بأكمله في المستودع؟
  2. ما الذي يحدد اسم أمر الشرطة المائلة؟
  3. ماذا يفعل $ARGUMENTS في أمر ما؟
  4. أي خيار تغليف يحمّله Claude تلقائيًا عندما يكون ذا صلة، بدلًا من أن تطلقه أنت؟

التالي​