مراجعة zcode-smart-skill: بروتوكول مدير مكتوب في ملف Markdown واحد
ينسق skill سياقات جديدة عبر ledger واختبارات مستقلة وcheckpoints وتنفيذ فعلي. قوته الانضباط؛ وحدّه أن Markdown لا يفرض قواعده.
مراجعة عميقة · المصدر
أربعة ملفات ولا وقت تشغيل. هذا هو المستودع كله، وهذا هو المقصود. القطعة الأساسية ملف `SKILL.md` كبير واحد يحوّل وكيل برمجة قديرًا إلى مدير لسياقات عمل جديدة. تنتقل الحالة عبر سجل `.smart/
ما أُحسن فيه
- يعالج فشل المحادثة الطويلة التي تراكم افتراضات قديمة وتلمع نهجاً خاطئاً. يقرأ العمال brief وledger محدودين. مدير يخطط، عامل مستقل يكتب adversarial tests، آخر ينفذ مهمة، والمدير يشغل الناتج. لا تعني done شيئاً بلا artifact واختبار ناجح.
- Source repository
كيف بُني
الوكيل الرئيسي يخطط ويتحقق. الوكلاء الجدد يفكرون أو يكتبون الاختبارات أو ينفذون مهمة واحدة. الملفات هي الحافلة: `task.md` للهدف، `plan.md` للاستراتيجية، `tasks.json` للنطاق، `notes.md` للدروس، و`verify.log` للتنفيذ. قد تتسابق worktrees معزولة.
عشرة امتدادات، حلقة واحدة
يضيف V2 كتابة اختبار عدائية، reflection، سباقاً متوازياً، scrutiny، ميزانيات صعوبة، نماذج حسب الدور، backtracking، self-attack، ذاكرة workflow وhandoff صارماً. كل إضافة تغير نقطة قرار فعلية.
ما تستطيع مراجعة الشيفرة التحقق منه هنا وما لا تستطيع
لا يوجد تقريباً كود تنفيذي. يمكن مراجعة البروتوكول والترخيص. لا يمكن إثبات مكاسب benchmark لهذا skill لغياب harness وcorpus ونتائج وCI. الأبحاث تبرر العناصر ولا تثبت التركيبة.
{"id":"implement-1","difficulty":"hard","status":"in_progress","done_when":"artifact exists and tests pass"}مقتطف توضيحي أصلي من السجل، وليس ملف مشروع حرفيًا.
الأمان والثقة
يقول brief إن ledger بيانات لا سلطة. النسخ غير مدمرة والحدود واضحة. لكن المهمة تُنسخ حرفياً والدفاع يعتمد على امتثال الوكيل لعبارة trust. يلزم sandbox وصلاحيات وعزل وفحص مسارات خارج prompt.
التصميم بوصفه تجربة مطوّر
رسم ASCII يشرح المدير والعمال والledger. يعرض README الحلقة قبل التثبيت ومسارين بسيطين. سجل التدقيق مفيد لرؤية الطرق الفاشلة والتنفيذ. ويعلن تغير التكلفة قبل العمال.
أين يضعف
يفترض host يملك subagents وملفات وأوامر واختيار نماذج. التوافق ليس بسيطاً بين أنظمة الصلاحيات. Markdown لا يضمن الميزانيات أو العزل أو الدمج أو تشغيل الاختبارات. pruning قد يمحو دليلاً والسباق يضاعف الكلفة وauto-trigger قد يكون واسعاً.
كيف تختبره بأمانة
أنشئ suite علنية بميزانية ثابتة. قارن محادثة طويلة والحل الأساسي وablation لكل إضافة. انشر النجاح والوقت والtokens وfalse done والتعارض والاستجابة لـprompt injection مزروعة وكل ledgers.
الحكم
هو دليل تشغيل قوي لا framework. أفضل أفكاره استقلال كاتب الاختبار والتنفيذ كحقيقة والhandoff المحدود وترك النهج الفاشل. أضعف نقطة enforcement: القواعد نثر. استخدمه مع sandbox قوي ونتائج قابلة للتكرار.
العرض والمؤلف
لا يوجد live demo مستقل في المستودع. الأثر القابل للفحص هو المصدر و`SKILL.md`.
نقاط القوة
- كاتب اختبارات مستقل قبل التنفيذ
- Bounded ledger makes handoffs auditable
- تراجع صريح وتحقق بالتنفيذ
المقايضات
- Markdown cannot enforce its own guards
- No benchmark harness or reproduced results
- Parallel races can sharply increase cost
الأنسب لـ: مضيفو الوكلاء الذين يوفرون أصلًا العزل وسياقات عمل جديدة وتنفيذ أوامر موثوقًا.
أسئلة شائعة
ما هو zcode-smart-skill؟
هو بروتوكول Markdown من أربعة ملفات ينسق سياقات وكلاء برمجة جديدة عبر سجل ملفات.
هل هو framework تنفيذي؟
لا. يحتوي المستودع تعليمات، ولا يحتوي runtime أو benchmark harness أو اختبارات أو CI.
ما ميزته الأساسية؟
اختبارات مستقلة وhandoff محدود وcheckpoints وتحقق بالتنفيذ تجعل العمل قابلاً للتدقيق.
Reviewed source at commit b847694 · No separate live demo listed