كيف تحوّل مهمة متكرّرة إلى مهارة قابلة لإعادة الاستخدام لوكيل البرمجة بالذكاء الاصطناعي الخاص بك

إذا كنت تواصل لصق قائمة التحقق نفسها في وكيل البرمجة بالذكاء الاصطناعي الخاص بك — "اكتب التزامًا تقليديًا، ثم شغّل الاختبارات، ثم حدّث سجل التغييرات" — فأنت تؤدّي عملًا يمكن للوكيل أن يتذكّره نيابةً عنك. تتيح لك معظم الوكلاء الحديثين تغليف إجراء متكرّر في ملف صغير قابل لإعادة الاستخدام. في Claude Code تُسمّى هذه مهارات؛ والملف نفسه يشغّل أيضًا أوامر الشرطة المائلة مثل /deploy. يرشدك هذا الدليل خلال بناء واحدة من الصفر، ثم يشرح المبادئ التي تنطبق على أدوات أخرى.

ما هي المهارة

المهارة عبارة عن مجلد بداخله ملف SKILL.md واحد. يتكوّن هذا الملف من جزأين: واجهة YAML الأمامية التي تخبر الوكيل متى يستخدم المهارة، ومتن بصيغة markdown يتضمّن التعليمات التي يتّبعها عندما تعمل المهارة. والميزة الأساسية مقارنةً بحشر كل شيء في ملف CLAUDE.md (أو AGENTS.md) هي الكشف التدريجي: فالمتن لا يُحمّل إلا عند استدعاء المهارة فعليًا، لذا فإن المواد المرجعية الطويلة لا تكلّف شيئًا تقريبًا حتى تحتاج إليها.

تستدعي المهارة بطريقتين: مباشرةً، بكتابة /skill-name، أو تلقائيًا — يقرأ الوكيل طلبك، ويطابقه مع description الخاص بالمهارة، ويحمّلها إذا كانت ذات صلة.

أين تُوضع المهارات

المكان الذي تضع فيه المجلد يحدّد من يمكنه استخدامه. في Claude Code، وفقًا للوثائق الرسمية:

• ~/.claude/skills/<name>/SKILL.md — شخصية، متاحة عبر جميع مشاريعك.
• .claude/skills/<name>/SKILL.md — مشروع، تُلتزم في المستودع بحيث يحصل كل فرد في الفريق على الأمر نفسه.

يصبح اسم المجلد هو الأمر. فمجلد يُسمّى summarize-changes يمنحك /summarize-changes.

مثال ملموس

لنبنِ مهارة تلخّص تغييراتك غير الملتزمة وتنبّه إلى أي شيء محفوف بالمخاطر قبل أن تلتزم. أنشئ الدليل:

mkdir -p ~/.claude/skills/summarize-changes

ثم احفظ هذا في ~/.claude/skills/summarize-changes/SKILL.md:

---
description: Summarizes uncommitted changes and flags anything risky. Use when the user asks what changed, wants a commit message, or asks to review their diff.
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in two or three bullet points, then list any
risks you notice such as missing error handling, hardcoded values, or tests
that need updating. If the diff is empty, say there are no uncommitted changes.

أمران يجعلان هذا يعمل. أولًا، description مكتوب من أجل الوكيل، لا من أجلك — فهو يسمّي المحفّزات ("ما الذي تغيّر"، و"يريد رسالة التزام"، و"مراجعة الفرق الخاص به") حتى يعرف الوكيل متى يلجأ إليه. ثانيًا، سطر !`git diff HEAD` هو حقن سياق ديناميكي: يشغّل Claude Code ذلك الأمر ويلصق مخرجاته في الموجّه قبل أن يقرأ الوكيل المهارة. تصل التعليمات وقد أُدرج فيها الفرق الفعلي الخاص بك بالفعل، فتكون الإجابة مبنية على شجرة عملك الحقيقية بدلًا من التخمين.

أجرِ تعديلًا صغيرًا على أي ملف، وشغّل وكيلك، وجرّبها بكلتا الطريقتين — اسأل "ما الذي غيّرته؟" لتشغيلها تلقائيًا، أو اكتب /summarize-changes لتشغيلها مباشرةً.

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

يمكن للمهارات أن تأخذ مدخلات. يُستبدل العنصر النائب $ARGUMENTS في المتن بأي شيء تكتبه بعد الأمر، وتلتقط المتغيّرات المُفهرسة ($0 و$1) كلمات محدّدة. فالمهارة التي تُستدعى على هيئة /fix-issue 4821 يمكنها الإشارة إلى رقم المشكلة مباشرةً، فيتعامل ملف واحد مع كل مشكلة بدلًا من ملف لكل تذكرة.

خمسة مبادئ لمهارات تصمد

تنطبق هذه سواء كنت تكتب مهارة Claude Code، أو أمر Cursor، أو — اعتبارًا من ميزة Record & Replay من OpenAI في يونيو 2026 — تحرّر أتمتة سجّلها الوكيل نيابةً عنك:

1. اكتب الوصف من أجل النموذج. قدّم عبارات محفّزة ملموسة في المقدّمة. الوصف الغامض يعني أن الوكيل لن يحمّل المهارة تلقائيًا أبدًا، وستعود إلى كتابة / وتذكّر الأسماء.
2. اجعل كل مهارة لمهمة واحدة. المهارة التي تنشر و تشغّل عمليات الترحيل و تنشر على Slack يصعب الوثوق بها ويصعب تصحيح أخطائها أكثر. المهارات الصغيرة ذات الغرض الواحد تتركّب على نحو أفضل.
3. احقن سياقًا حيًّا بدلًا من وصفه. سحب فرق حقيقي، أو نتيجة اختبار، أو قائمة ملفات يتفوّق على إخبار الوكيل بـ"تحقّق من الحالة الراهنة" — فهو يزيل خطوة يمكن أن يخمّن فيها الوكيل خطأً.
4. قيّد أي شيء له آثار جانبية. بالنسبة للمهارات التي تنشر أو تُرحّل أو تحذف، اشترط الاستدعاء الصريح بدلًا من السماح للوكيل بإطلاقها تلقائيًا. فأنت تريد إنسانًا ضمن الحلقة قبل الإجراءات التي لا يمكن التراجع عنها.
5. التزم بمهارات الفريق في المستودع. وضع مهارات المشروع في .claude/skills/ وإدراجها في الإصدار يعني أن كل مطوّر — وكل تشغيل للوكيل في CI — يتّبع الإجراء نفسه. فتتوقّف اصطلاحاتك عن العيش في رأس شخص واحد.

متى تلجأ إلى مهارة

القاعدة العامة: في اللحظة التي تلصق فيها التعليمات متعدّدة الخطوات نفسها للمرة الثالثة، أو يتحوّل قسم من ملف CLAUDE.md الخاص بك من حقيقة إلى إجراء، انقله إلى مهارة. تحصل على أمر قابل لإعادة الاستخدام، ويبقى ملف سياقك رشيقًا، ولا تُحمّل التعليمات إلا عند الحاجة إليها فعلًا — وهو ما يُبقي كلًّا منك ومن الوكيل مركّزَين على المهمة التي بين يديك.