عن المشروع

Specrails Core هو CLI للـ Node.js وإطار عمل لسير عمل الوكلاء لتطوير البرمجيات القائم على المواصفات. يقوم بتثبيت الأدوار الأساسية — المعماري والمطور والمراجع — في المشروع ويكشف عن الأوامر الخاصة بالمزود لـ Claude Code وCodex CLI وGemini CLI وKimi Code. التدفق المقصود هو المواصفات → المعمارية → التنفيذ → المراجعة → التسليم؛ يقوم المعماري بإنتاج اقتراح OpenSpec وتصميم ومهام، ويقوم المطور بتنفيذ العمل المتفق عليه، ويقوم المراجع بالتحقق من النتائج مقابل المواصفات وأوامر التحقق من المشروع. التثبيت من مشروع: npx specrails-core@latest init --provider claude (اختر claude، codex، gemini أو kimi). غير تفاعلي: npx specrails-core@latest init --yes --provider claude. يستخدم المزودون الأوامر الأصلية مثل /specrails:implement، $implement، و/skill:specrails-implement. يستهدف تكامل Kimi إصدار Kimi Code 0.27.0+ ويستخدم .kimi-code/specrails/run-skill.mjs للتنشيط بدون رأس. يقوم Core 5 بتثبيت الأدوار وسير العمل مباشرة دون استدعاء نموذج لمرحلة الإثراء. تشمل الأسطح المثبتة مجلدات المزودين (.claude، .codex، .gemini، .kimi-code)، وspecs الخاصة بـ openspec/ وartifacts الخاصة بالتغيير، و.specrails/config.yaml وinstall-config.yaml، و.specrails/rules/ وagent-memory/، و.specrails/runtime/ وpipeline/، و.specrails/local-tickets.json اختياريًا، و.specrails/profiles/. عادةً ما تقوم عمليات التثبيت المستقلة بنسخ artifacts القابلة للالتزام إلى المستودع وتستخدم مخزن إطار عمل مشترك تحت ~/.specrails/؛ يمكن للمساحات العمل المنقولة أو التي يديرها Desktop الاحتفاظ بروابط الإطار العمل وartifacts المشروع خارج عملية الاستخراج. يمكن إعادة إنشاء الملفات المُدارة بواسطة التحديثات؛ يجب أن تستخدم امتدادات المستخدم المسارات الموثقة مثل .specrails/profiles/** وأدوار custom-*. التحديثات منفصلة عن تحديث التنفيذ: npx specrails-core@latest update --dry-run، update، doctor. يتم الحفاظ على اختيارات المزود الحالية بواسطة تنفيذ التحديث الحالي؛ يرفض المصدر الحالي أن يقوم CLI أقدم بكتابة إطار عمل مثبت أحدث. يتضمن الانتقال من Core 4 إزالة أمر enrich، ومستويات التثبيت السريع/الكامل، والوكلاء المتخصصين غير الأساسيين المضمنين؛ يجب نقل الوكلاء المخصصين إلى أدوار custom-* المحمية وتحديث مراجع الملف الشخصي. تم تضمين وقت تشغيل وكيل برمجي اختياري: سير عمل LangGraph مشترك مع مزودين لكل دور، واستعادة دائمة، ونماذج محلية متوافقة مع OpenAI، ومُكشَفة من خلال واجهة برمجة تطبيقات TypeScript وCLI. يمكن للتسليم التلقائي المستقل إنشاء فروع، والتزامات، ودفعات، وطلبات سحب عند التمكين؛ تتطلب طلبات سحب GitHub وجود gh CLI مُصادَق عليه. يمكن للمضيفين مثل Specrails Desktop ضبط SPECRAILS_GIT_AUTO=false وتملك worktrees والتسليم. يجب على السياقات متعددة المستودعات تحديد المستودعات المحددة ومالك OpenSpec/backlog بشكل صريح. التكوين، والمواصفات، وحالة التشغيل هي ملفات محلية، لكن CLIs الخاصة بالمزودين ترسل السياق المُزود إلى خدمات النموذج المُكوَّنة، وقد تستخدم عملية تثبيت الحزمة، وGitHub/Jira، وتكاملات MCP الشبكة. يتم احتساب استخدام النموذج بواسطة المزود. المشروع مرخص بموجب MIT ويتطلب Node.js 20.19.0+ مع Git وأحد CLIs الخاصة بالذكاء الاصطناعي المُصادَق عليها على الأقل؛ يستخدم التطوير من المصدر أوامر npm ci، npm test، npm run build، typecheck وcoverage.