skill

الكتابة للوكلاء

كتابة وثائق للوكلاء. تستخدم عند إنشاء أو تعديل المهارات، أو تعديل ملفات AGENTS.md أو CLAUDE.md.

mattpocock330,460+ تثبيتموثوق

نبذة

مرجع لكتابة أي مستند يستهلكه الوكيل: مهارة، ملف `AGENTS.md` / `CLAUDE.md`، مستند يتم الوصول إليه بواسطة مؤشر. تختلف طريقة التعبئة؛ أما الكتابة فلا تختلف: نفس المحفزات تجعل كل واحد منها قابلا للتنبؤ، حيث يتبع الوكيل نفس _العملية_ في كل تشغيل بدلا من إنتاج نفس المخرجات.

عندما يكون المستند الذي تكتبه مهارة، اقرأ [`SKILL-MECHANICS.md`](SKILL-MECHANICS.md) للمعلومات الأولية، واختيار الاستدعاء، ومهارات الموجه.

## مؤشرات السياق

**مؤشر السياق** هو مرجع موجود في سياق الوكيل يسمي مادة خارج السياق ويشفر الشرط للوصول إليها. وصف المهارة هو أحدها؛ سطر في `AGENTS.md` يسمي مستندا هو نفس الكائن. تحدد _صياغة_ المؤشر، وليس هدفه، متى يصل الوكيل إلى المادة، ومدى موثوقية ذلك. الهدف الذي يجب الوصول إليه والذي يقف وراء مؤشر ضعيف الصياغة هو خطأ في التباين: قم بصقل الصياغة أولا، وقم بتضمين المادة فقط إذا فشل الصقل.

يقوم المؤشر بوظيفتين: تحديد ماهية المادة، وسرد **الفروع** التي يجب أن تؤدي إلى الوصول إليها (الفرع هو حالة مميزة يتعامل معها المستند، لذا تتخذ التشغيلات المختلفة مسارات مختلفة خلاله). كل كلمة من مؤشر يتم تحميله دائما تكلف في كل دورة، لذا فإنها تستحق تقليما أكثر صرامة من النص الأساسي:

- **ضع الكلمة الرئيسية في المقدمة**: المؤشر هو المكان الذي يقوم فيه بعمله التحفيزي. - **محفز واحد لكل فرع.** المرادفات التي تعيد تسمية فرع واحد هي فرع واحد مكتوب مرتين؛ ادمجها واحتفظ فقط بالفروع المتميزة حقا. - **قص الهوية التي يحملها النص الأساسي بالفعل.**

## الحملان

كل مستند ومؤشر تضيفه يستهلك إحدى ميزانيتين:

- **حمل السياق** هو تكلفة المواد المحملة دائما على نافذة الوكيل: سطر `AGENTS.md`، وصف مهارة، أي شيء موجود في السياق في كل دورة، يستهلك الرموز والانتباه سواء تم تفعيله أم لا. - **الحمل المعرفي** هو التكلفة على الإنسان: ما هي المستندات الموجودة ومتى يجب الوصول إلى كل منها. الإنسان هو الفهرس. ليست تكلفة يجب تقليلها: إنها ثمن الوكالة البشرية؛ أنفقها حيث يكون الحكم البشري مهما، وأزلها حيث لا يكون كذلك.

المواد التي يتم الوصول إليها فقط من خلال مؤشر تفلت من حمل السياق على حساب سطر المؤشر الخاص بها؛ المواد التي لا تحتوي على مؤشر على الإطلاق تعتمد بالكامل على الحمل المعرفي.

## التسلسل الهرمي للمعلومات

يتكون المستند من نوعين من المحتوى: **الخطوات** (الإجراءات المرتبة التي يقوم بها الوكيل) و**المرجع** (التعريفات والقواعد والحقائق التي يتم الرجوع إليها عند الطلب). يختلط الاثنان بحرية: جميع الخطوات (وصفة)، جميع المراجع (قواعد مراجعة، هذه المهارة)، أو كلاهما. القرار الأساسي هو أين تقع كل قطعة في **التسلسل الهرمي للمعلومات**، وهو سلم مصنف حسب مدى فورية حاجة الوكيل للمادة:

1. **الخطوة داخل الملف** هي المستوى الأساسي: ما يفعله الوكيل، بالترتيب. 2. **المرجع داخل الملف** يتم الرجوع إليه عند الطلب. غالبا ما يكون مجموعة متساوية شرعية (كل قاعدة من قواعد المراجعة على درجة واحدة)، وهو ترتيب جيد، وليس مؤشرا على مشكلة. 3. **المرجع المكشوف** يتم دفعه إلى ملف منفصل، يتم الوصول إليه بواسطة مؤشر سياق، ويتم تحميله فقط عندما يتم تفعيل المؤشر. يمتد عبر ملف شقيق في نفس المجلد من خلال مرجع خارجي بالكامل يمكن أن يوجد في أي مكان ويمكن لأي مستند أن يشير إليه.

إذا دفعت القليل جدا إلى الأسفل، يتضخم الجزء العلوي؛ وإذا دفعت الكثير جدا، فإنك تخفي المواد التي يحتاجها الوكيل بالفعل. هذا التوتر هو القرار بأكمله.

**الإفصاح التدريجي** هو الانتقال إلى الأسفل في السلم (خارج الملف الرئيسي وخلف مؤشر) بحيث يظل الجزء العلوي واضحا. ليس تحسينا للرموز في المقام الأول: إنه كيفية حماية التسلسل الهرمي. التفرع هو أوضح اختبار للإفصاح: قم بتضمين ما يحتاجه كل فرع، وادفع ما يصل إليه بعض الفروع فقط خلف مؤشر. عندما يحتوي المستند على خطوات، فإن المرجع داخل الملف الذي يجب الكشف عنه يدفنها ويحول الانتباه إليها إلى رمية عملة: محفز للتباين، وليس مجرد محفز للوضوح.

**الموقع المشترك** هو الرفيق داخل الملف: حيث يقرر السلم _إلى أي مدى_ تقع قطعة ما، يقرر الموقع المشترك _ماذا يقع بجانبها_ بمجرد وصولها إلى هناك. احتفظ بتعريف المفهوم وقواعده وتحذيراته تحت عنوان واحد بدلا من تشتيتها، بحيث يؤدي قراءة جزء واحد إلى جلب أجزائه المجاورة معه. الاختبار: يجب أن يقرأ المستند كوثائق مكتوبة للوكيل. المواد المجمعة تقرأ بهذه الطريقة؛ المواد المشتتة لا تقرأ كذلك. (يختلف عن التكرار: الذي يكرر معنى واحدا في مكانين؛ التشتيت يجزئ معنى واحدا عبر العديد.)

**الانتشار** هو وضع الفشل هنا: مستند طويل جدا ببساطة، حتى عندما يكون كل سطر حيا وفريدا. يتضاءل الانتباه عبر الفائض، وكل سطر إضافي هو سطر آخر يجب الحفاظ على أهميته. العلاج هو السلم: اكشف المرجع خلف المؤشرات، وقسم حسب الفرع أو التسلسل بحيث يحمل كل مسار ما يحتاجه فقط.

## الخطوات ومعايير الإنجاز

تنتهي كل خطوة ب **معيار إنجاز**، وهو الشرط الذي يخبر الوكيل بأن العمل قد اكتمل. خاصيتان تجعلانه محفزا:

- **الوضوح**: هل يمكن للوكيل التمييز بين المنجز وغير المنجز؟ الحد الغامض ("تم الوصول إلى الفهم") يدعو إلى **الإنجاز المبكر**.

التثبيت

شغل هذا الأمر

npx skills add mattpocock/skills

يعمل مع

claude appclaude codeclaude apicursorcodexwindsurfclinezed

خطوات التثبيت

ثبت باستخدام `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.

هل الكتابة للوكلاء مجانية؟

نعم، يمكنك استخدامها مجانا.

أصول ذات صلة

مختارات أخرى في إنشاء المحتوى.

كل بدائل الكتابة للوكلاء ←
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
الشواء مع المستندات
مقابلة مكثفة لصقل خطة أو تصميم، والتي تنشئ أيضا وثائق (ADR's ومسردا) أثناء تقدمنا.1,062,214+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
إعداد مهارات مات بوكوك
قم بتهيئة هذا المستودع لمهارات الهندسة: إعداد متتبع المشكلات الخاص به، ومفردات تصنيف الفرز، وتخطيط وثائق المجال. يشغل مرة واحدة قبل الاستخدام الأول لم…967,342+
skillclaude_appclaude_codeclaude_api
npx skills add heygen-com/hyperframes
Hyperframes الأساسية
عقد تركيب HyperFrames — أنشئ مشروعا واحدا قابلا للتقديم. استخدمه لهيكل التركيب، وسمات التوقيت `data-*`، و`class="clip"`، والمسارات، والتركيبات الفرعية…876,697+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
نمذجة النطاق
لبناء وصقل النموذج النطاقي للمشروع. يستخدم عند مناقشة مصطلحات قاعدة الكود، أو كتابة أو تعديل ملف GLOSSARY.md، أو تسجيل أو تعديل ADR.747,767+
skillclaude_appclaude_codeclaude_api
npx skills add microsoft/azure-skills
بوابة Azure AI
تهيئة Azure API Management كبوابة للذكاء الاصطناعي لنماذج الذكاء الاصطناعي وأدوات MCP والوكلاء. متى: التخزين المؤقت الدلالي، حد الرمز المميز، سلامة ال…605,853+
skillclaude_appclaude_codeclaude_api
npx skills add mattpocock/skills
بحث
تحقق من سؤال مقابل مصادر أولية موثوقة للغاية، وسجل النتائج كملف Markdown في المستودع. استخدم هذا عندما يريد المستخدم البحث في موضوع، أو جمع حقائق حول…576,164+

افحص قبل التثبيت

شغل أي مصدر عبر فحوصاتنا - الظهور في الذكاء الاصطناعي والأمان والأداء واكتشاف التقنيات.

المزيد في إنشاء المحتوى