عن المشروع

Worktrail هو نظام لتنسيق المهام مصمم ليكون مستقلاً عن تنسيق المواصفات، مما يتيح التنفيذ الموازي عبر git worktrees، وتصنيف المسارات الحتمي، وتسليم طوابير العمل. تم استخلاصه من سوق إضافات Claude Code الخاص بـ `developer-kit` ليتم استهلاكه بواسطة أي نظام تشغيل وبأي تنسيق مهام عبر واجهة محول `TaskSource`. يفهم النظام تنسيقات مهام متعددة بما في ذلك ملفات مهام DevKit، وتغييرات OpenSpec، ومهام ميزات GitHub Spec Kit. ويتضمن خطاف Stop يتم تشغيله مرة واحدة لكل جلسة لالتقاط أفكار الخطوات التالية الاستثنائية بعد العمل الجوهري. الميزات الرئيسية للتشغيل الذاتي: - يقوم `worktrail-drain` بتشغيل طابور العمل دون تدخل بشري، حيث يطلق عمليات تنفيذ لمرة واحدة بدون واجهة (Claude أو Codex أو OpenCode) التي تطالب بالملخصات الموجودة في الطابور، وتؤدي العمل، وتفتح طلبات سحب (PRs). - مرحلة فرز المدخلات المسبقة: تقيم ملخصات المدخلات مقابل التغييرات النشطة، وتقترح أحكاماً (مثل fold-into-change أو propose-change)، وتطبق الإجراءات المعتمدة (معطلة افتراضياً). - بذر المتراكمات (Backlog seeding): يحول متراكم التخطيط (مثل المواصفات في مرحلة `needs-tasks`) إلى ملخصات طابور (مفعل افتراضياً)، مع بذر حتمي وخالٍ من التكرار. - طابور القرارات البشرية: عندما يكون هناك قرار متعلق بالمنتج مطلوباً، يقوم النظام بإنشاء سجل منظم وينتظر مدخلات بشرية عبر أوامر `worktrail-decision` أو تحرير الملفات. - تكوين المشغل: يستخدم `~/.worktrail/routing.yaml` لتعريفات الأهداف والمستويات، والتي تحكم اختيار المزود/النموذج أثناء عمليات drain. - معالجة الحالة القابلة للاستئناف: يقوم بالبحث عن الحالات المتقطعة والتعافي منها (مثل استنفاد الميزانية أو انتظار التحقق). يوفر النظام أيضاً `worktrail-check-provider-commands` للتحقق من صحة الأوامر التي تم إنشاؤها مقابل محللات CLI دون الحاجة إلى مصادقة.