دليل CODEZ الأصلي / 01
كيفية اختيار مهارة Agent: من ترتيب النجوم إلى التجربة الفعلية
تساعدك القوائم في تضييق نطاق بحثك. ويعتمد الاختيار الفعلي على ما إذا كانت المهارة قادرة على إنجاز مهمة محددة في بيئتك. يوفر هذا الدليل طريقة تصفية قابلة لإعادة الاستخدام.
التحقق من البيانات:
تأتي معلومات التنسيق والمشروع من المصادر الأصلية المرتبطة، وخطوات الاختيار وشروط القبول نصائح تحريرية من CODEZ. مهارات PDF المرشحة عناصر مدرجة فعلًا، وقورنت بنصوصها الأصلية عند نسخ commit محددة. لم تُنفذ مهارات الطرف الثالث هذه؛ الأمثلة ليست نتائج قياس فعلية.
01 / حدد أولاً المهارة التي تحتاجها
تُنظَّم مهارات Agent عادةً في مجلدات. يوفر SKILL.md البيانات الوصفية وتعليمات المهمة، وقد ترافقه نصوص برمجية ومراجع وقوالب. يمكن لحقل compatibility في مواصفات التنسيق توضيح متطلبات البيئة، لكنه اختياري؛ لذا يجب فحص النص والتبعيات حتى إذا لم يُملأ.
أولًا، دوّن طرق الإدخال والإخراج والقبول. على سبيل المثال، "استخراج الجداول من ملفات PDF التي تحتوي على طبقات نصية إلى ملفات CSV، مع الحفاظ على أسماء الأعمدة". عبارة "ساعدني في معالجة المستندات" عامة جدًا، مما يصعب معه تحديد مدى ملاءمة المرشح.
02 / ما الذي يخبرك به عدد نجوم المستودع؟
يمكن استخدام نجوم GitHub لحفظ المشاريع في المفضلة والتعبير عن التقدير لجهود القائمين عليها. لذا، نستخدمها كمؤشر لمعرفة مدى شعبية المشروع.
يعتمد ترتيب الموقع على نجوم المستودع. قد تأتي شعبية مستودع يضم مئات المهارات من بعض محتواه فقط، ولا يمكن توزيع مجموع النجوم على المهارات منفردة. عند مقارنة مهارتين من مستودعين، ابدأ بملاءمة المهمة واستخدم الشعبية عاملًا مساعدًا.
لا يُفيد تاريخ آخر تحديث إلا في تحديد موقع المعلومات. ولا يعني وجود تغيير واحد غير ذي صلة بالضرورة أن الخاصية التي تحتاجها قد تم إصلاحها؛ لذا عليك مراجعة سجلات التغييرات والأمثلة وسجلات المشكلات في الدليل ذي الصلة.
03 / تحويل المتطلبات إلى شروط قابلة للتفتيش
تُعدّ الشروط التالية أسهل في التفسير والتحقق من تصنيف الشعبية الواحد. ولا داعي لدمج عدد الشروط التي يستوفيها المرشحون في مجموع نقاط يبدو دقيقًا.
| سيناريو | التحقق الأول | راقب أثناء الاستخدام التجريبي |
|---|---|---|
| معالجة المستندات وجداول البيانات | نوع الإدخال، تنسيق الإخراج، تبعيات النظام | هل فُقدت أسماء الأعمدة أو الترميز أو التخطيط أو البيانات؟ |
| كتابة التعليمات البرمجية وسير العمل التطويري | اللغة المستهدفة، وإصدار إطار العمل، والأدوات المطلوبة | نطاق التغييرات، وردود الفعل على الأخطاء، وما إذا كان المشروع يجتاز الفحص. |
| البحث وتنظيم المراجع | نطاق المصادر، ومتطلبات الاستشهاد، وشروط الاتصال بالإنترنت | هل يمكن تتبع المراجع؟ هل تتجاوز النتيجة الأدلة؟ |
04 / افتح الملف الأصلي وتحقق من البيئة ونطاق التشغيل.
افتح SKILL.md من بطاقة الموقع ثم اقرأ README في المجلد نفسه. تساعد النسخة الصينية على فهم التعليمات، لكن اكتمال اللغات لا يثبت ملاءمة المهارة؛ عند غيابها، ارجع إلى الأصل للتحقق من الشروط المهمة.
دوّن هذه المعلومات قبل تجربتها:
- بيئة التشغيل: العملاء المدعومون، وأنظمة التشغيل، وأدوات سطر الأوامر، ومتطلبات الإصدار المحددة بوضوح.
- نطاق التشغيل: ما هي الملفات التي سيتم قراءتها أو تعديلها، وما هي الخدمات الخارجية التي سيتم استدعاؤها، وما إذا كانت بيانات الاعتماد مطلوبة.
- مصادر إضافية: هل توجد البرامج النصية وملفات المراجع المذكورة في النص؟ ما الذي ستفعله الأوامر المنفذة؟
- شروط الاستخدام: اقرأ ملفات ترخيص المشروع ومجلد المهارة. يعني الوسمان «غير محدد» و«بحاجة إلى التحقق» أن المعلومات لم تُؤكد بعد.
- معلومات إعادة الإنتاج: سجّل رابط المستودع ومسار المهارة المحدد ونسخة commit عند التجربة، لتتمكن من العثور على المحتوى نفسه لاحقًا.
05 / قارن المرشحين باستخدام المهمة الصغيرة نفسها
اختر اثنين أو ثلاثة مرشحين يناسبون المهمة على أفضل وجه، واختبرهم باستخدام نفس المدخلات غير الحساسة في نسخة اختبار قابلة للاسترداد. فعّل فقط الإمكانيات التي تحتاجها حاليًا لأول مرة، باتباع تعليمات التثبيت الخاصة بالعميل الفعلي.
حدد شروط النجاح قبل البدء. عند استخراج البيانات من الجداول، تحقق من عدد الصفوف وأسماء الأعمدة والقيم الفارغة؛ وعند تعديل التعليمات البرمجية، تحقق من الوظائف المستهدفة والملفات المُعدّلة وفحوصات المشروع الحالية. عند فشل التشغيل، سجّل الخطأ والبيئة؛ ولا تُعزِ الفشل مباشرةً إلى النموذج أو المهارة نفسها.
سجّل جميع التصحيحات اليدوية اللازمة، والأدوات الإضافية، وتكاليف الخدمات الخارجية، ووقت الإنجاز. إن استخدام طريقة تسجيل موحدة للمهام المتكررة يُسهّل عملية اتخاذ القرارات مقارنةً بالاعتماد على انطباع واحد عن الناتج.
- المرشح والإصدار: المستودع / مسار المهارة / نسخة commit.
- المدخلات والبيئة: العينة / نظام التشغيل / العميل والتبعيات.
- النتائج والتصحيحات: ما هي بنود القبول التي اجتازت بنجاح وما هي البنود التي تطلبت معالجة يدوية.
- الموارد والقرارات: الخدمات والوقت والتكاليف المستخدمة، وأسباب التبني أو التأجيل.
06 / المرشحون الفعليون: كيف تختار بين مهارتين في مجال ملفات PDF تحملان نفس الاسم؟
يضم الموقع skills/pdf/SKILL.md من anthropics/skills وskills/.curated/pdf/SKILL.md من openai/skills. اسما المهارتين هما pdf؛ سجّل المستودع والمسار الكامل أولًا لتجنب الخلط بينهما كمجموعة تعليمات واحدة. يقارن الجدول تركيز المهمة في النص الأصلي، ولا يعني أن القدرات متنافية ولا يحكم على الدقة بعدد النجوم.
يقدم نص Anthropic الأصلي أمثلة على استخراج النصوص والجداول، ومعالجة صفحات PDF، وإنشاء الملفات، والتعرف الضوئي على الأحرف في المستندات الممسوحة، ويحيل معالجة النماذج إلى FORMS.md. يركز نص OpenAI على القراءة والإنشاء ومراجعة التخطيط، ويطلب عرض الصفحات وفحصها ثم إعادة الفحص بعد التحديثات المهمة؛ استخراج النص وحده لا يثبت صحة التخطيط.
| المرشح والمسار الكامل | أبرز ما جاء في النص الأصلي | توصي CODEZ بالتحقق من هذا أولاً. | لا يزال بحاجة إلى التحقق |
|---|---|---|---|
| anthropics/skills / skills/pdf/SKILL.md | يتم تقديم أمثلة لكل عملية: الاستخراج، ومعالجة الصفحة، والإنشاء، والتعرف الضوئي على الأحرف (OCR). | عند استخراج الجداول أو معالجة المستندات الممسوحة ضوئياً، تحقق أولاً من العمليات والتبعيات المقابلة. | بنية الجدول، ولغة التعرف الضوئي على الأحرف ودقتها، وتوافر المصادر والأدوات المذكورة |
| openai/skills / skills/.curated/pdf/SKILL.md | قم بإنشاء ومراجعة وتحقق من التخطيط عن طريق عرض الصفحة. | عند الحاجة إلى تقرير قابل للقراءة، تحقق أولاً من عملية العرض والتفتيش. | الخطوط والجداول وأرقام الصفحات والترقيم؛ وما إذا كان من الممكن عرض النص في بيئة واقعية. |
anthropics/skills: skills/pdf/SKILL.md (عند نسخة commit محددة) ↗
openai/skills: skills/.curated/pdf/SKILL.md (عند نسخة commit محددة) ↗
07 / تقسيم "الاستخراج الناجح" إلى عناصر قبول قابلة للتحقق.
هذا تصميم مقترح للتجربة: قارن المرشحين بقائمة مخزون غير حساسة من صفحتين. يتضمن المثال رقم مادة 0017، وعناوين أعمدة صينية، وخانة وصف فارغة، ورأس جدول مكررًا في الصفحة الثانية وخلية مدمجة. تحقق يدويًا من النتائج المتوقعة أولًا، واحتفظ بأرقام صفحات المصدر ونسخة من الملف الأصلي؛ هذه تجربة لم تُنفذ.
قبل البدء، تأكد من إمكانية تحديد النص في المدخلات، وحاول استخراج جزء صغير منه. يجب استخدام عمليات التحقق من التحديد والاستخراج كمؤشرات فقط: فوجود طبقات نصية لا يضمن صحة بنية الجدول، وقد تحتوي المستندات الممسوحة ضوئيًا التي تحتوي على نص مُستخرج بتقنية التعرف الضوئي على الحروف (OCR) على أخطاء. عند الحاجة إلى استخدام تقنية التعرف الضوئي على الحروف، سجّل اللغة وأدوات النظام؛ أما التبعيات المفقودة فتُسجّل كمشاكل في بيئة التشغيل.
- سجّل نسخة commit للمرشح والعميل والنموذج وإصدار الأداة ونوع الإدخال، حتى لا تُحسب اختلافات البيئة على أنها اختلافات المهارة.
- سجل الأسطر المصححة يدويًا وأسبابها، ووقت التشغيل، والخدمات التي تم استدعاؤها فعليًا؛ يجب ترك البيانات التي لم يتم قياسها فارغة.
- لن يُقبل الاستنتاج إلا إذا استُوفيت جميع معايير القبول المذكورة. حتى في حال اجتياز العينة للمعايير، لا يزال يتعين التحقق من بياناتك الفعلية.
| بنود الفحص | النتائج التي يجب التحقق منها | كيفية التعامل مع الفشل |
|---|---|---|
| رقم المادة | يحتفظ الرقم 0017 بالأصفار البادئة ولا يمكن تغييره تلقائيًا إلى 17 | بعد توضيح أنواع الحقول، استخرج البيانات مرة أخرى وتحقق من كل عنصر. |
| جدول مقسم إلى صفحات | لا يتم احتساب رأس الصفحة الثانية كبيانات، ولا يتم فقدان أو تكرار أي سجلات. | احتفظ بأرقام الصفحات، وتحقق من عدد الأسطر في كل صفحة، ثم ادمجها. |
| الأحرف الصينية والقيم الفارغة | أسماء الأعمدة مقروءة، وخانات الوصف الفارغة تبقى فارغة دون إضافة محتوى تخميني | تحقق من الترميز ومواضع الحقول، وقم بتحديد المواضع التي لا يمكن استعادتها. |
| خلية مدمجة | قيم الوصف مرتبطة بالسجلات الصحيحة، وقواعد تقسيم الخلايا مسجلة بوضوح | يتم الاحتفاظ بمنطقة المصدر، ويتم تحديد قواعد التعيين يدويًا. |
| تنسيق تقرير الإخراج | لا يحتوي المحتوى المعروض على أي اقتطاع أو تداخل أو أحرف مفقودة. | قم بتصحيح الخط أو التخطيط وتحقق من أحدث نسخة معروضة. |
08 / الفئات والتراخيص والتبعيات هي ثلاث عمليات فحص منفصلة
هذه المرة، تم تصحيح تصنيف ملفي PDF من "تصميم" و"تطوير" إلى "مستند" على التوالي، وفقًا للنص الأصلي: المدخلات والمخرجات الرئيسية عبارة عن ملفات PDF، ويتم إنجاز المهمة باستخدام كود بايثون وأدوات العرض. يساعد التصنيف الأحادي فقط في إيجاد المرشحين ولا يمكنه تحديد ما إذا كان استخراج البيانات أو مراجعة التخطيط أنسب.
لكل من العنصرين ملف LICENSE.txt مستقل في مجلده، ويحتفظ الموقع بوسم «ملف الترخيص بحاجة إلى التحقق». اقرأ الترخيص الأصلي لكل مجلد؛ لا تفترض حرية الاستخدام لمجرد أن المستودع عام أو أن المؤسسة معروفة.
يجب أيضًا مراجعة قائمة التبعيات لكل عملية على حدة. تثبيت مكتبات بايثون لا يعني توفر أدوات عرض النظام أو بيئة التعرف الضوئي على الأحرف (OCR)؛ ولا يضمن هذا المستند التوافق مع أي عميل. دوّن أي أدوات مفقودة، أو خطوات غير مُثبتة، أو قيود على الاستخدام في سجل قراراتك.
09 / Skill من Cloudflare: تحقق أولًا من إعدادات المشروع وبيانات الاعتماد
تحقق هذا القسم بتاريخ 2026-10-14 من ملف cloudflare/skills / skills/cf-cli/SKILL.md عند commit محدد ومن الوثائق الرسمية. ما يلي توصيات CODEZ للاختيار والتجربة؛ ولم يتم تشغيل هذا Skill.
لا يعيد cf استخدام تسجيل دخول Wrangler. تحقق أولًا من الحساب وصلاحيات الرمز؛ وسجّل إصدار CLI والإعدادات والموارد المستهدفة لتجنب اعتبار اختلافات البيئة اختلافات في Skill.
| سيناريو | التحقق الأول | راقب أثناء الاستخدام التجريبي |
|---|---|---|
| يوجد wrangler.jsonc أو wrangler.json أو wrangler.toml، ولا يوجد cloudflare.config.ts | احتفظ أولًا بسير عمل Wrangler لأوامر dev وbuild وdeploy؛ فأوامر مشروع cf لا تقرأ هذه الإعدادات الحالية. | راجع أولًا الأوامر وتغييرات الملفات التي يقترحها Skill؛ واتخذ قرار ترحيل الإعدادات بشكل منفصل. |
| يوجد cloudflare.config.ts بالفعل | تحقق من dev وbuild وdeploy وفق سير مشروع cf؛ فالـ CLI في مرحلة beta، والتصنيف لا يثبت التوافق. | تحقق من Node.js 22.18 أو أحدث ومن الحساب المستهدف؛ وافحص مخرجات البناء وWorker المستهدف في نسخة اختبار. |
cloudflare/skills / skills/cf-cli/SKILL.md ↗