كتابة مهارة Claude Code تُطلَق فعلاً
معظم المهارات ملفات صحيحة بأوصاف لا تطابق اللغة الواقعية. حقول الترويسة التي تغيّر السلوك، والمهارات الثلاث التي ينبغي أن يحملها مستودع موقع.
إن كنت تلصق الفقرات الثلاث نفسها من التعليمات في كل جلسة جديدة، فقد كتبت مهارة بالفعل وتخزّنها بشكل سيّئ فقط. المهارة هي ذلك النصّ في ملف يستطيع الوكيل تحميله وحده في لحظة صلته، لا حين تتذكّر أن تمدّه به. والميكانيكا بسيطة بما يُتعلَّم في أصيل يوم، والجزء الذي يحدّد نجاحها ليس الميكانيكا.
موضع الملف يحدّد من يناله
المهارة مجلّد يحوي ملف markdown اسمه SKILL.md، وموضع المجلّد هو كامل قصّة التحكّم بالوصول. ضعه تحت مجلّد منزلك فيُحمَّل في كل مشاريع جهازك. ضعه في المستودع فيُحمَّل لكل من يعمل فيه بعد الإيداع. وتوثيق المهارات فيه الجدول الكامل، ومنه حالة التعشيش للمستودعات الأحاديّة وحالة الإضافة لتوزيعها على فريق.
في عمل العملاء موضع المستودع هو الصحيح غالباً، لأن مهارة تُرمّز كيف يُبنى هذا الموقع ينبغي أن تسافر مع الموقع. وموضع مجلّد المنزل لعاداتك أنت: كيف تحبّ كتابة الـcommits، وأيّ فحوص تريدها دائماً.
الوصف يُكتب للمُوزِّع
هنا تفشل معظم المهارات، وليس ذلك بيّناً من قراءة واحدة. فحقل الوصف ليس ملخّصاً لإنسان يتصفّح قائمة، بل هو النصّ الذي يقرؤه الوكيل ليقرّر هل تنطبق هذه المهارة على ما طلبته، ولا يُحمَّل شيء آخر من المهارة قبل ذلك القرار. والوصف الذي يقول ما هي المهارة لن يُطلَق. والوصف الذي يقول متى تُستخدم يُطلَق.
يتبع ذلك تفصيلان. قدّم حالة الاستخدام الأساسية أولاً، لأن نصّ الوصف المجموع يُقتطع في القائمة عند 1536 حرفاً لتقليل كلفة السياق. وأدرج العبارات التي تكتبها فعلاً لا الاسم الرسمي للمهمّة: إن كنت تقول افحص الزحف، فليكن في الوصف افحص الزحف.
حقول الترويسة التي تغيّر السلوك
| الحقل | ما يفعله | الخطأ |
|---|---|---|
| description | يحدّد متى تُطلَق المهارة | وصف المهارة بدل وصف المُطلِق |
| when_to_use | عبارات إطلاق إضافية تُضاف إلى الوصف | تكرار الوصف بدل إضافة صياغات |
| disable-model-invocation | يمنع الوكيل من تحميلها وحده | تركه مطفأً في أي شيء هدّام |
| allowed-tools | يوافق مسبقاً على أدوات لذلك الدور فقط | منح أكثر مما تحتاجه المهمّة |
| argument-hint | يبيّن الوسائط المتوقّعة في الإكمال | إهماله في مهارة تأخذ مُدخلاً |
واحد منها يستحقّ التأكيد. فكل ما ينشر أو يحذف أو ينشئ أو يرسل ينبغي أن يحمل disable-model-invocation، فلا يعمل إلّا حين تكتب اسمه. ونحن نُحكِم كل مهارة نثبّتها بهذه الطريقة كقاعدة دائمة، لأن ثمن انطلاق مهارة نشر باجتهادها الخاص غير متكافئ مع ثمن كتابة ستّة أحرف.
أبقِ المتن قصيراً، لأنه يبقى في السياق
بعد تحميل المهارة يبقى محتواها في السياق عبر الأدوار، فكل سطر كلفةٌ متكرّرة لبقيّة الجلسة. والتوثيق يقول: اذكر ما يُفعل بدل سرد الكيف أو اللِّمَ، وهذه هي الغريزة الصحيحة. فالمهارة التي تشرح استدلالها في أربعمئة كلمة تُحمّلك ثمن ذلك الاستدلال في كل طلب لاحق.
والحركة التي تجعل هذا محمولاً هي الملفات المساندة. أبقِ SKILL.md على قواعد القرار، وضع المادة المرجعية الطويلة في ملف منفصل بجانبه مذكور بالاسم. يقرؤه الوكيل حين يحتاجه لا قبله. وكل ما هو حاسم موضعه سكربت لا نثر: فالفحص الذي جوابه نجاح أو فشل ينبغي أن يكون أمراً لا فقرةً تطلب من الوكيل أن ينظر بتمعّن.
اختبرها بمحاولة إطلاقها
الاختبار الوحيد المهمّ هو هل تُحمَّل المهارة حين ينبغي. افتح جلسة جديدة، وصُغ الطلب كما تصوغه طبعاً، وانظر هل تدخل المهارة. ثم صُغه بثلاث طرق أخرى. فمعظم المهارات المعطوبة ملفات صحيحة بأوصاف لا تطابق اللغة الواقعية قطّ، ولن تكتشف ذلك بقراءة وصفك، لأنك تعرف معناه سلفاً.
ثلاث تستحقّ الكتابة في مستودع موقع
ابدأ بمهارة التحقّق: التسلسل الدقيق للأوامر الذي يُثبت أن تغييراً يعمل في هذا الموقع، فذلك التسلسل مختلف لكل مشروع ولا يتذكّره أحد. ثم مهارة المحتوى: قواعد نصّك، وتضمّ عندنا عدم استخدام الشرطة الطويلة أبداً وأيّ الصفحات تبقى بالإنجليزية فقط. ثم مهارة الإصدار، محصورة بالاستدعاء اليدوي، وفيها قائمة ما قبل النشر من مقال الإنتاج.
هذه هي المجموعة الكاملة لموقع تسويقي، وهي صغيرة عن قصد. والمقال المرافق عن المهارات الجديرة بالاقتناء يغطّي ما تُثبّته بدل أن تكتبه، ومقال CLAUDE.md يغطّي ما موضعه التعليمات. فالمهارة تجيب كيف نؤدّي هذه المهمّة بعينها؛ والتعليمات تجيب ما هو صحيح دائماً هنا. والخلط بينهما هو كيف يطول الملفّان كلاهما.
التسمية والطريقتان اللتان تُستدعى بهما مهارة
تصل المهارة بطريقتين، والتمييز بينهما يحدّد كيف تسمّيها. فإمّا أن يحمّلها الوكيل وحده مطابقاً طلبك بالوصف، وإمّا أن تكتب اسمها كأمر. والاسم افتراضه اسم المجلّد، ولأن النصّ نفسه يظهر في قائمة الأوامر، فمهارة اسمها إصدار تُقرأ صحيحةً عند الكتابة وسيّئةً عند المطابقة. ومرجع أوامر الشرطة المائلة يغطّي صيغة ملفّ الأوامر الأقدم، وهي لا تزال تعمل وتشترك في معظم الترويسة نفسها.
والقاعدة العملية أن تسمّي لحالة الكتابة وتكتب الوصف لحالة المطابقة، لأن الجمهورين مختلفان فعلاً. وفعلٌ واسم ينفعان لكلتيهما: افحص-الزحف، اكتب-مقالاً، شغّل-الإصدار. وتجنّب الأسماء التي تتضارب مع أمر تستخدمه، لأن الفصل بين مهارتين تشتركان في اسم قاعدةٌ تصير مضطرّاً لتذكّرها.
وبقيّة سطح الإعداد تغطّيه المقالات المرافقة: المهارات الجديرة بالتثبيت لا بالكتابة، وسيرفرات MCP التي تحلّ مشكلة الوصول التي لا تحلّها مهارة، والـhooks التي تُلزم بما تطلبه المهارة فقط.
