العودة إلى المشاريع
a2 / مهارات متحقق منها وأعمال البيانات

من حلّ واحد إلى مهارة قابلة لإعادة الاستخدام.

a2 وكيل Python صغير يحل مهام تحويل البيانات، ويفحص النتائج خارجيًا، ويبحث في إعادة استخدام الحلول المقبولة كمهارات تنفيذية ذات إصدارات محددة. يجمع هذا المدخل المصدر ومسار العمل والعرض التجريبي وسجلات التقييم.

حالة العمل0.1.0a1 · معاينة تقنيةتاريخ فحص المصادر
وسم المصدر
01

لماذا a2؟

حل المهمة مرة واحدة وإعادة استخدام الحل بأمان مع مدخلات أخرى مسألتان مختلفتان. يبحث a2 هذه الفجوة بحلقة وكيل صغيرة قابلة للفحص. مجاله الأول تحويلات بيانات محددة النطاق: تطبيع السجلات ومطابقة المصادر وكشف التعارضات واختيار الحقول.

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

رحلة المهمة

أربع مسؤوليات حول نواة صغيرة

الحلقة والذاكرة

Base + Trace

يبني السياق من الهدف والآثار السابقة وملاحظات الأدوات، ويختار الأفعال ضمن حدود الخطوات والميزانية.

صلاحية الإجراءات

Gate

يحيل إجراءات الأدوات الخطرة في الوكيل العام إلى الموافقة. الموافقة ليست عزلًا على مستوى نظام التشغيل.

فحص المخرجات

Auditor

يفصل فحوص التنسيق عن فحص الصحة أمام نتائج متوقعة مستقلة. من دون مرجع لا يثبت schema_only صحة الإجابة.

الحفظ وإعادة الاستخدام

Skills

يحفظ العقد والمنشأ والإصدار وبصمة الكود وسجلات التحقق، مع مسارات إعادة الفحص والتعطيل والرجوع.

من المهمة إلى سجل قابل للفحص

  1. 01

    العقد والنتيجة المتوقعة المستقلة

    يحدد صاحب المهمة معنى البيانات والنتيجة المقبولة.

  2. 02

    الحل والمهارة المرشحة

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

  3. 03

    التحقق بمدخلات منفصلة

    يلزم فحصان مختلفان على الأقل يقدمهما المستدعي قبل الحفظ؛ يستخدم متعلم البيانات المدمج ثلاث مهام تحقق منفصلة.

  4. 04

    إعادة الاستخدام بإصدار مثبت

    تُشغّل المهارة مباشرة أو ضمن خطة صريحة. لا يُنفذ اقتراح النموذج تلقائيًا؛ ويوقف اختلاف الإصدار التنفيذ.

  5. 05

    المخرج وسجل التقييم

    تُسجّل الجودة والاستدعاءات والزمن والرموز المرصودة بصورة منفصلة. لا تتحول التجربة غير المكتملة إلى ادعاء نجاح.

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

ثلاثة استخدامات محددة

قوائم عملاء من نظامين
تُطابق صادرات CSV من CRM وERP تطابقًا تامًا على رموز فريدة مشتركة. يعرض مثال اليومين الاصطناعي السجلات المطابقة والمحتاجة للمراجعة، من دون اتصال حي بالنظامين.
القاعدة نفسها وملف جديد غدًا
تُطبق مهارة متحقق منها لاختيار الحقول أو المطابقة على مدخلات جديدة. يتوقف العقد غير المطابق من دون رجوع آلي إلى النموذج، وتتيح النتيجة المرجعية فحصًا مستقلًا للصحة.
تغيّر مهارة خطة تمت مراجعتها
تثبت الخطط الجديدة معرفات المهارات وبصمات الكود. يوقف الإصدار المتغير أو غير المتاح الخطة قبل الخطوة الأولى.
03

التشغيل الأول

ابدأ بعرض CRM/ERP الذي لا يحتاج نموذجًا. احصل على المصدر في مساحة عمل محلية خاصة بك؛ الإعداد التالي لنظام Linux أو macOS وPython 3.11 أو أحدث. لا تنفذ هذه الصفحة الأوامر.

  1. 01

    نزّل أو استنسخ وسم المصدر v0.1.0a1، وأنشئ بيئة افتراضية وثبّت الحزمة.

  2. 02

    شغّل عرض العملاء الاصطناعيين في مجلد إخراج جديد. لا يلزم مفتاح API ولا استدعاء نموذج.

  3. 03

    افتح runs/customer-demo/report.html وافحص الخطط والمطابقات والمشكلات وفحص تغير إصدار المهارة.

إعداد محلي من الوسم

git clone --branch v0.1.0a1 --single-branch https://github.com/omasim/a2.git
cd a2
python -m venv .venv
source .venv/bin/activate
python -m pip install -e .

عرض تعريفي من دون API

python -m a2.customer_demo --output runs/customer-demo --compact

نفّذ الأوامر في الطرفية نفسها من مجلد المصدر. اختر مجلد إخراج جديدًا عند التكرار. يعيد العرض استخدام المهارتين نفسيهما، وهما مكتوبتان بشريًا ومتحقق منهما، مع مجموعتين اصطناعيتين؛ ولا يثبت تعلم النموذج أو التحقق مع عميل فعلي. لفحص المهارات المحفوظة اتبع data init --with-demo-skills في README.

04

مقالات مرتبطة

ما الذي تغيّر قبل إعادة المحاولة؟

ملاحظة عمل من a2 عن إظهار سبب محاولة أخرى.

لماذا ترفض خطة أن تعمل؟

توقف التنفيذ قبل البدء عند تغير إصدار المهارة في عرض a2، والتمييز بين هوية الكود وصحته.

العمل نفسه، وملف آخر في اليوم التالي

إعادة الاستخدام بالمهارات نفسها والمطابقة التامة للرموز وفحص النتيجة المستقل في عرض CRM/ERP اصطناعي ليومين.

المعاينة التقنية الأولى لـa2

الإصدار 0.1.0a1: أعمال بيانات قابلة للفحص، ومهارات قابلة لإعادة الاستخدام، وحدود المعاينة التقنية المعلنة.

رحلة مهمة في a2

مثال من سجلين لتتبع العقد ومسار التنفيذ وفحص المخرجات والسجل الباقي في النهاية.

متى ينبغي أن يتوقف الوكيل؟

الاكتمال والتكرار والميزانية المشتركة والعمليات غير المؤكدة وحدود الصلاحية في a2: ماذا نحتاج إلى معرفته قبل الخطوة التالية؟

تحول الفكرة إلى أداة تعمل

من خلال a2: المسافة بين الحل المتحقق منه والمهارة القابلة لإعادة الاستخدام والمهمة المكتملة.

05

الوثائق والروابط

المصدر والإصدار

الوسم المتحقق منه وأرشيف المصدر والالتزام الذي تمت مراجعته.

المعمارية والمهارات

الحلقة الأساسية والعقود ودورة حياة المهارة.

البدء والعرض التجريبي

من التثبيت إلى فحص الأمثلة الاصطناعية.

التجارب والتقييم

القياس والشروط المفتوحة وبروتوكول التجربة الفعلية.

المساهمة والأمان

سجل CI والمشكلات والمساهمة والترخيص.

06

الحالة والحدود

في فحص 22 أكتوبر 2026، كان المستودع عامًا بترخيص MIT، ووسم v0.1.0a1 متاحًا. نجحت عمليات CI الأخيرة. لا تتضمن قائمة GitHub Releases سجل إصدار منفصلًا؛ يشير التنزيل إلى ZIP المصدر الموسوم. المعاينة التقنية لا تعني اكتمال قبول الإصدار العام.

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

عرض اصطناعي ≠ تعلم النموذج. فحص التنسيق ≠ صحة المعنى. نجاح CI ≠ اكتمال قبول المستخدم أو الإصدار.

يستند هذا المدخل إلى README ووثائق المعمارية والمهارات والتقييم والنشر العامة في الالتزام نفسه الخاص بـv0.1.0a1. لم تُشغّل تجربة نموذج جديدة ولا استدعاء مدفوع لمزود. الوثائق بالإنجليزية غالبًا، ودليل العرض وبعض نصوص النشر بالتركية.

نص المشروع الحالي ومصادره المؤرخة

يحفظ سجل المشروع القابل للتحرير أدناه الملخص السابق المؤرخ في 13 أكتوبر 2026. عبارات ما قبل النشر سياق تاريخي؛ حالة المصدر الحالية موضحة أعلاه.

السؤال

هل يمكن تحويل حل ناجح إلى مهارة قابلة لإعادة الاستخدام في مهام أخرى؟ يبحث a2 هذا السؤال من خلال تحويل البيانات.

الأجزاء العاملة

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

التقييم

تُثبّت المهارات المتعلمة وتُقارن على مهام منفصلة بالحل دون تاريخ والأمثلة السابقة والمهارات المكتوبة بشريًا والمهارات غير المرتبطة. تُسجّل الجودة والزمن والاستدعاءات واستخدام الرموز المرصود بصورة منفصلة.

الحالة والحدود

تصف المصادر التي روجعت في 13 أكتوبر 2026 نسخة ألفا تطويرية. يعرض المثال غير المتصل التحقق من مهارات كتبها بشر وإعادة استخدامها، ولا يثبت تعلم النموذج. سجلت تجربة حية محدودة مهارات متحققًا منها، لكن دراسة تطويرية غير مكتملة لم تُظهر تفوقًا في الكفاءة. يظل التقييم المثبت ببذور متعددة والتحقق مع مستخدمين فعليين مفتوحين. نشر هذه الصفحة لا يعني إطلاق الحزمة البرمجية للاستخدام العام.

المصادر

ملخص README ووثائق التصميم والتقييم الخاصة بـa2، كما روجعت في 13 أكتوبر 2026. لم تُشغّل تجربة جديدة.

07

مفاهيم الأطلس