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

اكتب أول مهارة لك من البداية إلى النهاية

متوسط

لنبنِ مهارة عاملة من الصفر ونُثبت أنها تنشط. سنصنع مهارة صغيرة لـ "إدخال سجل التغييرات" — عامة وقابلة لإعادة الاستخدام.

الخطوة 1 — إنشاء المجلد​

mkdir -p .claude/skills/changelog-entry

(استخدم ~/.claude/skills/… لمهارة شخصية عبر جميع المشاريع.)

الخطوة 2 — كتابة SKILL.md​

.claude/skills/changelog-entry/SKILL.md:

---
name: changelog-entry
description: Use when the user wants to turn recent git commits into a Keep a Changelog entry.
---

# Changelog Entry

When asked for a changelog entry:
1. Run `git log --oneline -20` to see recent commits.
2. Group them into Added / Changed / Fixed / Removed (Keep a Changelog style).
3. Write concise, user-facing bullets (not raw commit messages).
4. Output only the formatted entry.

حقل description هو المُحفّز — اكتبه بصيغة "Use when…" حتى يُحمّله Claude في الوقت المناسب.

الخطوة 3 — (اختياري) إضافة سكربت مساعد​

يمكن للمهارات أن تتضمّن سكربتات. أضف scripts/recent.sh وأشِر إليه من SKILL.md إن أردت جمع بيانات حتمياً:

#!/usr/bin/env bash
git log --oneline -20

الخطوة 4 — أثبت أنها تنشط​

ابدأ جلسة وقل: "صُغ إدخال سجل تغييرات للعمل الأخير." يُفترض أن يتعرّف Claude على النية، ويُحمّل المهارة، ويتّبع خطواتها. إن لم تنشط، فالأرجح أن description ليس محدّداً بما يكفي بشأن متى تُستخدم — اضبطه بدقة.

الخطوة 5 — شاركها​

اجمعها (مع غيرها) في مكوّن إضافي ليُثبّتها فريقك بخطوة واحدة — أو ساهم بها في حِزَم المهارات الخاصة بـ AILmanac.

المزالق​

  • وصف غامض ← لا ينشط أبداً (أو ينشط دائماً). كن محدّداً.
  • الكثير في مهارة واحدة ← أبقِها مهمة واحدة واضحة.
  • أسرار في مهارة مشتركة ← لا تفعل أبداً؛ راجع مراجعة شيفرة الطرف الثالث.

التالي​