وكيل البناء

# بناء الوكيل

حوّل شيئاً يفعله المالك كل أسبوع إلى شيء يطلبه باسمه.

هذا هو ما يحافظ على المكون الإضافي من الاضطرار إلى شحن سير عمل كل صناعة. لا يمكن لأي فهرس أن يغطي روتين التصاريح للمقاول الخاص بالخزانات الصحية أو روتين التوفيق بين عمولات الناقل لوكالة التأمين. يمكن لأولئك المالكين بناءها بأنفسهم.

## الخطوة 1 — راقبها أو استمع إلى وصفها

نقطة بداية واحدة أفضل بكثير من الأخرى.

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

**بخلاف ذلك: يصفونها.** اطلب منهم أن يسيروا خلال آخر مرة فعلوها، بشكل ملموس. التفاصيل الحقيقية تفوق الوصف المجرد — "الثلاثاء الماضي سحبت ملف الناقل، طابقته مع ما حجزناه، وتتبعت ست اختلافات" يخبرك أكثر من "أقوم بالتوفيق بين العمولات."

اقرأ `reference/capture.md` لمعرفة كيفية الحصول على صورة كاملة دون استجواب.

## الخطوة 2 — افصل ما يختلف عما يبقى ثابتاً

هذا هو كل فن هذه الخطوة. المهارة التي تحدد بشكل صارم تفاصيل يوم الثلاثاء الماضي تعمل فقط في يوم الثلاثاء الماضي.

لكل جزء من المهمة، قرر:

- **ثابت** — التسلسل والمصادر وتنسيق الإخراج والقواعد - **متغير** — التواريخ والأسماء والمبالغ وأي ملف وأي عميل - **حكم** — الأجزاء حيث يقرر المالك، والتي تصبح بوابات موافقة

التصحيحات التي أجراها المالك أثناء السير خلالها عادة ما تحدد نقاط الحكم. عندما يقول شخص ما "لا، ليس هذا — نحن نتخطى أي شيء أقل من 50 دولار أمريكي،" فهذا قاعدة. عندما يقولون "حسناً، يعتمد على الحالة،" فهذا بوابة موافقة.

## الخطوة 3 — ابحث عن بوابات الموافقة

كل خطوة تُرسل أو تُنفق أو تُنشر أو تحذف تحتاج بوابة. وكذلك كل خطوة تردد فيها المالك.

لا تضع بوابة على كل شيء — المهارة التي تطلب إذناً تسع مرات أسوأ من فعلها يدوياً. ضع بوابات على ما هو مهم والغامض، واترك الباقي ينطلق.

اقرأ `reference/skill_authoring.md` لمعرفة أين تنتمي البوابات وكيفية صياغتها.

## الخطوة 4 — اكتبها

أنتج مهارة حقيقية بنفس شكل كل شيء آخر في هذا المكون الإضافي: `SKILL.md` مع البيانات الوصفية ومجموعة خطوات مرقمة، بالإضافة إلى مجلد `reference/` إذا كانت التفاصيل تستحق ذلك.

المتطلبات التي يجب أن تفي بها، مثل كل مهارة مُرسلة:

- الاسم والمجلد متطابقان، أحرف صغيرة مع شرطات - الوصف يقول ما الذي يفعله **ومتى** يتم تشغيله، بصيغة الغائب - بديل حقيقي لعندما يكون الموصل مفقوداً - بوابات موافقة على أي شيء مهم - لا تخترع رقماً أبداً؛ البيانات المفقودة يتم الإبلاغ عنها كمفقودة

**اكتبها بمصطلحات المالك، وليس بلغة عامة للأعمال.** إذا اتصلوا بها "ملف الناقل،" فإن المهارة تقول ملف الناقل. المهارة المليئة بالمفردات غير المألوفة هي واحدة لن يثقوا في تشغيلها دون إشراف.

## الخطوة 5 — اختبرها على حالة حقيقية قبل أن يعتمدوا عليها

قم بتشغيل المهارة الجديدة مقابل حالة يعرف المالك بالفعل الإجابة عليها — يفضل أن تكون نفس الحالة التي سار خلالها. اعرض الإخراج بجانب ما حصلوا عليه يدوياً.

هذه هي الخطوة التي تحدد ما إذا تم استخدام المهارة. المالك الذي رأى أنها أعادت إنتاج النتيجة الجيدة المعروفة سيقوم بجدولتها. واحد لم يرها سيقوم بتشغيلها يدوياً ويتحقق منها في كل مرة، وهذا لا يوفر شيئاً.

إذا لم تطابق، أصلح المهارة وقم بتشغيلها مرة أخرى. لا تطلب من المالك قبول نتيجة قريبة.

## الخطوة 6 — سجل وحدد الوتيرة

أضفها إلى `smb-router` بحيث تصل الطلبات باللغة الإنجليزية البسيطة إليها، وسجل عبارات التشغيل التي يستخدمها المالك فعلاً.

إذا كانت مهمة متكررة، عرض عليه جدولتها. الجدولة هي ما يحول "مهارة يمكنني تشغيلها" إلى "شيء يحدث بدوني،" وهي النتيجة التي أرادوها.

## الخطوة 7 — شارك بموافقة

عرّض المشاركة مع الفريق. قل ما تعنيه المشاركة: من يحصل عليها، وما البيانات التي يمكنها الوصول إليها، وما الذي يمكنها فعله دون إشراف.

**كن محدداً بشأن المخاطرة عندما تُرسل مهارة أو تُنفق أو تكتب.** مهارة ترسل رسائل بريد إلكتروني للعملاء، وتعمل لشخص لم يبنها ولا يعرف افتراضاتها، هي خطر حقيقي. أوصِ بالمسودة فقط للمهارات المشتركة التي ترسل أي شيء.

## ما لا يجب فعله

- **لا تعيد المقابلة حول مهمة فعلوها للتو.** النص هو المواصفات. - **لا تحدد المثال.** الأسماء والتواريخ والمبالغ تختلف؛ التسلسل لا يختلف. - **لا تضع بوابة على كل خطوة.** تسع موافقات أسوأ من فعلها يدوياً. - **لا تتخطى جولة الاختبار.** مهارة غير مختبرة يتم فحصها يدوياً دائماً، وهذا لا يوفر شيئاً. - **لا تكتبها بلغة عامة للأعمال.** كلماتهم، أو لن يثقوا بها. - **لا تبنِ شيئاً يُرسل أو ينفق بدون بوابات موافقة.** أبداً، بغض النظر عما يطلبه المالك.

## بعد البناء

يمتلك المالك الآن مهارة مسماة يمكنه تشغيلها أو جدولتها. إذا كانت المهارة الجديدة قد وصلت إلى أداة غير