تحليل الاختيار الأصلي من CODEZ / 02
كيفية اختيار مهارة سير عمل Superpowers: المتطلبات والقبول وكتابة المهارات
ضمن فئة "سير عمل الوكيل" نفسها، قد تخدم المهارات مراحل مختلفة تمامًا. قبل اختيار أي مهارة، حدد أولًا ما إذا كنت تفتقر إلى متطلبات واضحة، أو نتيجة قابلة للتحقق، أو وصف عملية قابل لإعادة الاستخدام. تستخدم هذه المقالة ثلاثة مصادر واقعية لتوضيح كيفية اختيار المهارات حسب المهمة.
التحقق من البيانات:
تأتي حقائق المشروع من SKILL.md الأصلي عند نسخة commit محددة. نصائح الاختيار والحكم على التكلفة وتصميم السيناريوهات تحليل تحريري من CODEZ. لم تُنفذ مهارات الطرف الثالث في هذا المقال؛ السيناريوهات وسجلات التجربة أمثلة، ولا توجد معدلات نجاح مقاسة أو تصنيفات أداء.
اختر بناءً على المخرجات المطلوبة أولاً.
تنتمي العناصر الثلاثة إلى obra/superpowers وتعرض عدد نجوم المستودع نفسه. لا يحدد عدد النجوم أيها تختار؛ شروط التفعيل والمخرجات أكثر فائدة للتمييز بينها.
نهجنا هو تحديد الثغرات في المهمة أولاً: عندما لا تزال هناك غموضات رئيسية في المتطلبات، نحتاج إلى مواءمة النية؛ عند التحضير للتسليم، نحتاج إلى التحقق من الأدلة؛ عند التحضير لكتابة التجربة في قدرات يمكن للوكلاء إعادة استخدامها، نحتاج إلى التحقق مما إذا كانت التعليمات تغير السلوك بالفعل.
| ما هو المطلوب الآن | مهارة مرشحة | الناتج المتوقع | تكلفة العملية اللازمة |
|---|---|---|---|
| توضيح الأهداف والنطاق والتصميم | brainstorming | فهم المتطلبات وأساس التصميم الذي يستطيع المستخدم تأكيده | ينبغي أن تتناسب المناقشة والتأكيد مع مدى تعقيد المهمة. |
| إثبات إنجاز العمل أو إصلاحه | verification-before-completion | أوامر التحقق والنتائج والقيود المتعلقة بالتغييرات الحالية. | قم بتشغيل الفحص واقرأ الناتج الكامل. |
| إنشاء أو تحسين المهارات القابلة لإعادة الاستخدام | writing-skills | سجلات التحقق من التعليمات والسيناريوهات القابلة للصيانة | صمم السيناريوهات، وراقب الخطوط الأساسية، وقم بالمراجعة والتنقيح. |
المتطلبات غير واضحة: افحص brainstorming
يدور النص الأصلي حول تنظيم التعاون بناءً على النية والسياق والمتطلبات والتحقق من صحة التصميم، ويُميّز بين المهام ذات التعقيد المتفاوت. يُصنّف هذا النص ضمن سير عمل الوكيل لأن هذه الخطوات تُحدّد كيفية سير العمل وتحقيق التحقق؛ ومع ذلك، يجب تحديد مدى انطباقه بالرجوع إلى النص الأصلي.
من العلامات الجيدة التي يجب التحقق منها أولاً هو عندما تستطيع وصف المنتج الذي ترغب في تصنيعه، ولكنك لا تستطيع بعد تحديد المستخدمين أو معايير النجاح أو نطاق العمل. ابدأ بسجل فهم موجز، وتحقق من كل بند مقابل متطلباتك وما هي الافتراضات من المرشحين المحتملين.
إذا كانت المهمة تتضمن بالفعل مدخلات ومخرجات ومعايير قبول واضحة، فلاحظ ما إذا كانت تستخدم هذه المعلومات الموجودة، وما إذا كانت المناقشات الجديدة تحل أي غموض حقيقي. لا تستخدم "طرح المزيد من الأسئلة" كمعيار للجودة.
عند الاستعداد للتسليم: افحص verification-before-completion
يشترط النص الأصلي تحديد طريقة التحقق وتشغيل الفحوصات وقراءة المخرجات كاملة قبل إعلان إنجاز العمل. وهو ينظم الحكم على التسليم ولا يوفر أدوات اختبار لمشروع بعينه.
عند إجراء الاختبارات، ابدأ بتحديد النتائج التي تريد إثباتها، ثم اكتب عمليات التحقق المناسبة. على سبيل المثال، يمكن التحقق من عبارة "يحتوي ملف CSV الناتج على أربعة أعمدة محددة" من خلال التحقق من أسماء الأعمدة؛ بينما لا يمكن عادةً إثبات عبارة "لا توجد مشاكل في النظام بأكمله" من خلال فحص جزئي واحد.
لا يضمن اجتياز مراجعة الكود مرة واحدة صحة الوظائف والنشر وتجربة المستخدم الفعلية. ما تحتاجه هو تطابق واضح بين الاستنتاجات والأدلة؛ وينبغي الاحتفاظ بأي جوانب لم يتم تغطيتها.
verification-before-completion: الملف الأصلي عند نسخة commit محددة ↗
صيانة مهاراتك: افحص writing-skills
يتناول النص الأصلي إنشاء المهارات وتعديلها، وربط التحقق من صحة أوصاف العمليات باختبار السيناريوهات، بما في ذلك مراقبة السلوك بدون الوصف والتغييرات التي تطرأ بعد المراجعة. وينصب التركيز هنا على قدرات الوكيل القابلة لإعادة الاستخدام.
تُعدّ هذه العملية مُجدية عندما يتكرر نفس نوع المهمة، وتظل المواصفات الحالية تؤدي إلى انحرافات قابلة للوصف. إنّ كتابة الانحرافات المحددة وطرق قبولها مُسبقًا يُسهّل عملية التحقق بدلاً من مجرد التوسع في عدد كبير من القواعد.
يؤدي التحقق من السيناريو إلى زيادة الوقت والتكاليف التشغيلية، وقد تختلف أساليب التنفيذ التي يدعمها العملاء. بالنسبة للمهام التي لا تحتاج إلا إلى إنجازها مرة واحدة، يجب أولاً تحديد ما إذا كان من الضروري حقًا الحفاظ على مهارة جديدة؛ ويتم التحقق من صحة التنسيق وصحة السلوك بشكل منفصل.
مثال توضيحي: إصلاح خطأ في التحقق من صحة المدخلات
هذا مثال للاختيار صممه محررو الموقع، وليس تقريرًا عن استخدام المهارات الثلاث. نفترض أنك حددت إدخالًا يعيد إنتاج المشكلة، ورسالة الخطأ المتوقعة وأمر فحص الانحدار، وأن المطلوب الآن إصلاح واضح النطاق.
في هذا المثال، فحص الأدلة قبل التسليم هو الحاجة المباشرة. إذا بقيت شروط إعادة الإنتاج أو السلوك الخاطئ غامضة، فأضف خطوة لتوضيح المتطلبات. وإذا كان الفريق يغفل فحصًا معينًا مرارًا في إصلاحات مشابهة ويريد صيانته كمهارة قابلة لإعادة الاستخدام، ففكر في عملية كتابة المهارات.
يعتمد هذا الاختيار على المراحل والمخرجات، وليس على استخدام جميع مسارات العمل داخل المستودع لكل مهمة في آن واحد. عند دمج عدة مرشحين، يجب أيضًا التحقق من شروط التشغيل وخطوات الموافقة والنطاقات التشغيلية للتأكد من عدم وجود تعارضات.
استخدم سجلًا لتقييم ملاءمة المهارة لبيئتك
قارن المرشحين بالمدخلات ومعايير القبول نفسها، وسجّل العميل ونسخة commit في المستودع ومسار الملف المستخدم. قبل التجربة الفعلية، استخدم استنتاجات المصادر العامة لتصفية المرشحين فقط.
| عنصر السجل | املأ المحتوى |
|---|---|
| المهام والمدخلات | ما يحتاج إلى توضيح أو تحقق أو كتابة؛ احتفظ بنفس المدخلات. |
| العميل والإصدار | العميل الوكيل، والأدوات اللازمة، وبيئة التنفيذ |
| مصادر المرشحين | المستودع، نسخة commit محددة، مسار SKILL.md |
| الناتج المتوقع | فهم المتطلبات أو تسجيل الأدلة أو التعليمات والسيناريوهات |
| النتائج الفعلية | المخرجات والأوامر والأخطاء الفعلية بعد الانتهاء |
| التكاليف والقيود | مناقشات إضافية، وإجراءات تشغيل، ومجالات لم يتم تغطيتها |