skill
الكتابة للوكلاء
كتابة وثائق للوكلاء. تستخدم عند إنشاء أو تعديل المهارات، أو تعديل ملفات AGENTS.md أو CLAUDE.md.
نبذة
مرجع لكتابة أي مستند يستهلكه الوكيل: مهارة، ملف `AGENTS.md` / `CLAUDE.md`، مستند يتم الوصول إليه بواسطة مؤشر. تختلف طريقة التعبئة؛ أما الكتابة فلا تختلف: نفس المحفزات تجعل كل واحد منها قابلا للتنبؤ، حيث يتبع الوكيل نفس _العملية_ في كل تشغيل بدلا من إنتاج نفس المخرجات.
عندما يكون المستند الذي تكتبه مهارة، اقرأ [`SKILL-MECHANICS.md`](SKILL-MECHANICS.md) للمعلومات الأولية، واختيار الاستدعاء، ومهارات الموجه.
## مؤشرات السياق
**مؤشر السياق** هو مرجع موجود في سياق الوكيل يسمي مادة خارج السياق ويشفر الشرط للوصول إليها. وصف المهارة هو أحدها؛ سطر في `AGENTS.md` يسمي مستندا هو نفس الكائن. تحدد _صياغة_ المؤشر، وليس هدفه، متى يصل الوكيل إلى المادة، ومدى موثوقية ذلك. الهدف الذي يجب الوصول إليه والذي يقف وراء مؤشر ضعيف الصياغة هو خطأ في التباين: قم بصقل الصياغة أولا، وقم بتضمين المادة فقط إذا فشل الصقل.
يقوم المؤشر بوظيفتين: تحديد ماهية المادة، وسرد **الفروع** التي يجب أن تؤدي إلى الوصول إليها (الفرع هو حالة مميزة يتعامل معها المستند، لذا تتخذ التشغيلات المختلفة مسارات مختلفة خلاله). كل كلمة من مؤشر يتم تحميله دائما تكلف في كل دورة، لذا فإنها تستحق تقليما أكثر صرامة من النص الأساسي:
- **ضع الكلمة الرئيسية في المقدمة**: المؤشر هو المكان الذي يقوم فيه بعمله التحفيزي. - **محفز واحد لكل فرع.** المرادفات التي تعيد تسمية فرع واحد هي فرع واحد مكتوب مرتين؛ ادمجها واحتفظ فقط بالفروع المتميزة حقا. - **قص الهوية التي يحملها النص الأساسي بالفعل.**
## الحملان
كل مستند ومؤشر تضيفه يستهلك إحدى ميزانيتين:
- **حمل السياق** هو تكلفة المواد المحملة دائما على نافذة الوكيل: سطر `AGENTS.md`، وصف مهارة، أي شيء موجود في السياق في كل دورة، يستهلك الرموز والانتباه سواء تم تفعيله أم لا. - **الحمل المعرفي** هو التكلفة على الإنسان: ما هي المستندات الموجودة ومتى يجب الوصول إلى كل منها. الإنسان هو الفهرس. ليست تكلفة يجب تقليلها: إنها ثمن الوكالة البشرية؛ أنفقها حيث يكون الحكم البشري مهما، وأزلها حيث لا يكون كذلك.
المواد التي يتم الوصول إليها فقط من خلال مؤشر تفلت من حمل السياق على حساب سطر المؤشر الخاص بها؛ المواد التي لا تحتوي على مؤشر على الإطلاق تعتمد بالكامل على الحمل المعرفي.
## التسلسل الهرمي للمعلومات
يتكون المستند من نوعين من المحتوى: **الخطوات** (الإجراءات المرتبة التي يقوم بها الوكيل) و**المرجع** (التعريفات والقواعد والحقائق التي يتم الرجوع إليها عند الطلب). يختلط الاثنان بحرية: جميع الخطوات (وصفة)، جميع المراجع (قواعد مراجعة، هذه المهارة)، أو كلاهما. القرار الأساسي هو أين تقع كل قطعة في **التسلسل الهرمي للمعلومات**، وهو سلم مصنف حسب مدى فورية حاجة الوكيل للمادة:
1. **الخطوة داخل الملف** هي المستوى الأساسي: ما يفعله الوكيل، بالترتيب. 2. **المرجع داخل الملف** يتم الرجوع إليه عند الطلب. غالبا ما يكون مجموعة متساوية شرعية (كل قاعدة من قواعد المراجعة على درجة واحدة)، وهو ترتيب جيد، وليس مؤشرا على مشكلة. 3. **المرجع المكشوف** يتم دفعه إلى ملف منفصل، يتم الوصول إليه بواسطة مؤشر سياق، ويتم تحميله فقط عندما يتم تفعيل المؤشر. يمتد عبر ملف شقيق في نفس المجلد من خلال مرجع خارجي بالكامل يمكن أن يوجد في أي مكان ويمكن لأي مستند أن يشير إليه.
إذا دفعت القليل جدا إلى الأسفل، يتضخم الجزء العلوي؛ وإذا دفعت الكثير جدا، فإنك تخفي المواد التي يحتاجها الوكيل بالفعل. هذا التوتر هو القرار بأكمله.
**الإفصاح التدريجي** هو الانتقال إلى الأسفل في السلم (خارج الملف الرئيسي وخلف مؤشر) بحيث يظل الجزء العلوي واضحا. ليس تحسينا للرموز في المقام الأول: إنه كيفية حماية التسلسل الهرمي. التفرع هو أوضح اختبار للإفصاح: قم بتضمين ما يحتاجه كل فرع، وادفع ما يصل إليه بعض الفروع فقط خلف مؤشر. عندما يحتوي المستند على خطوات، فإن المرجع داخل الملف الذي يجب الكشف عنه يدفنها ويحول الانتباه إليها إلى رمية عملة: محفز للتباين، وليس مجرد محفز للوضوح.
**الموقع المشترك** هو الرفيق داخل الملف: حيث يقرر السلم _إلى أي مدى_ تقع قطعة ما، يقرر الموقع المشترك _ماذا يقع بجانبها_ بمجرد وصولها إلى هناك. احتفظ بتعريف المفهوم وقواعده وتحذيراته تحت عنوان واحد بدلا من تشتيتها، بحيث يؤدي قراءة جزء واحد إلى جلب أجزائه المجاورة معه. الاختبار: يجب أن يقرأ المستند كوثائق مكتوبة للوكيل. المواد المجمعة تقرأ بهذه الطريقة؛ المواد المشتتة لا تقرأ كذلك. (يختلف عن التكرار: الذي يكرر معنى واحدا في مكانين؛ التشتيت يجزئ معنى واحدا عبر العديد.)
**الانتشار** هو وضع الفشل هنا: مستند طويل جدا ببساطة، حتى عندما يكون كل سطر حيا وفريدا. يتضاءل الانتباه عبر الفائض، وكل سطر إضافي هو سطر آخر يجب الحفاظ على أهميته. العلاج هو السلم: اكشف المرجع خلف المؤشرات، وقسم حسب الفرع أو التسلسل بحيث يحمل كل مسار ما يحتاجه فقط.
## الخطوات ومعايير الإنجاز
تنتهي كل خطوة ب **معيار إنجاز**، وهو الشرط الذي يخبر الوكيل بأن العمل قد اكتمل. خاصيتان تجعلانه محفزا:
- **الوضوح**: هل يمكن للوكيل التمييز بين المنجز وغير المنجز؟ الحد الغامض ("تم الوصول إلى الفهم") يدعو إلى **الإنجاز المبكر**.
التثبيت
شغل هذا الأمر
npx skills add mattpocock/skillsيعمل مع
خطوات التثبيت
ثبت باستخدام `npx skills add mattpocock/skills`، أو استنسخ المستودع وانسخ مجلد `skills/productivity/writing-for-agents` إلى دليل مهارات Claude الخاص بك.
أسئلة شائعة
ما هي مهارة الكتابة للوكلاء؟
كتابة وثائق للوكلاء. تستخدم عند إنشاء أو تعديل المهارات، أو تعديل ملفات AGENTS.md أو CLAUDE.md.
كيف أثبت الكتابة للوكلاء؟
شغل هذا الأمر في الطرفية:
npx skills add mattpocock/skillsمع أي أدوات ذكاء اصطناعي تعمل الكتابة للوكلاء؟
تعمل مع claude_app، claude_code، claude_api، cursor، codex، windsurf، cline، zed.
من طور الكتابة للوكلاء؟
طورها mattpocock.
هل الكتابة للوكلاء مجانية؟
نعم، يمكنك استخدامها مجانا.
npx skills add mattpocock/skills
npx skills add mattpocock/skills
npx skills add heygen-com/hyperframes
npx skills add mattpocock/skills
npx skills add microsoft/azure-skills
npx skills add mattpocock/skills
افحص قبل التثبيت
شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.
مختبر وكلاء الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
فحص أمني تلقائي للموقع
الأمان
اختبار جودة المحتوى العربي بالذكاء الاصطناعي
جودة المحتوى
كاشف منصة الموقع
الترحيل
محلل سرعة الصفحة
الأداء
تدقيق الظهور في محركات الذكاء الاصطناعي
الظهور في الذكاء الاصطناعي
مولد ملف llms.txt
الظهور في الذكاء الاصطناعي
منشئ البيانات المنظمة
الظهور في الذكاء الاصطناعي
مقياس سهولة القراءة بالعربية
جودة المحتوى
حاسبة تكاليف الذكاء الاصطناعي
اختبار الذكاء الاصطناعي
محلل العناوين العربية
جودة المحتوى