● مجتمع
echoVic
⚡ فوري
spec-flow
بواسطة echoVic · echoVic/spec-flow
يسير Spec-Flow بـ Claude Code عبر سير عمل موجه بالمواصفات من 5 مراحل — الاقتراح والمتطلبات (EARS) والتصميم والمهام والتنفيذ — مع وثائق حية في .spec-flow/.
Spec-Flow هي skill تنظم تطوير الميزات كخط أنابيب متسلسل مع بوابات توقف. تنتج كل مرحلة وثيقة Markdown وتتوقف لانتظار تأكيدك. تتضمن المحفزات 'spec-flow' و'spec mode' و'need a plan' بالإضافة إلى العبارات الصينية '写个方案' و'做个规划'. وتدعم الخيارات --fast (لتخطي التأكيدات) و--skip-design.
لماذا تستخدمه
الميزات الأساسية
- سير عمل من 5 مراحل: الاقتراح → المتطلبات (صيغة EARS) → التصميم → المهام → التنفيذ
- كل مرحلة تكتب وثيقة Markdown إلى .spec-flow/ ليسهل تتبع القرارات والتحقق منها
- انتقالات بوابات مقيدة — يتوقف Claude لانتظار تأكيدك قبل الانتقال للمرحلة التالية
- محفزات بلغات متعددة: إنجليزية وصينية ('写个方案', '做个规划')
- خيارات بديلة: --fast لتخطي البوابات، و--skip-design للميزات البسيطة
عرض مباشر
كيف يبدو في الممارسة
spec-flow-skill.replay
▶ جاهز
حالات الاستخدام
استخدامات عملية: spec-flow
متى تستخدمه: عندما يعطيك مدير المشروع فكرة في سطر واحد، وتفضل قضاء 20 دقيقة لكتابة المواصفات من قضاء يومين في كتابة الكود الخاطئ
الخطوات
-
استدعاء سير العمل
spec-flow: add multi-region failover to our billing service.✓ تم النسخ
→ يكتب Claude ملف .spec-flow/proposal.md وينتظر تأكيدك
-
تأكيد أو تعديل كل مرحلة
Proposal looks good — proceed to requirements.✓ تم النسخ
→ يظهر ملف requirements.md مع عبارات بصيغة EARS
-
التنفيذ من قائمة المهام
Start the implementation phase. Work through tasks.md top-to-bottom.✓ تم النسخ
→ تغييرات الكود التي تتطابق 1:1 مع بنود المهام في tasks.md
النتيجة: يتم إطلاق الميزة ومع ذلك تبقى المواصفات حية في .spec-flow/ — بحيث يمكنك لاحقاً رؤية السبب وراء كل قرار
المزالق
- أنت تعمل على إصلاح سريع يستغرق 10 دقائق فقط، لكن skill تضيف 4 مراحل — استخدم --fast أو تخطي skill للعمل البسيط
متى تستخدمه: عند إعادة هيكلة شيء لم يكتب أحد مواصفات له
الخطوات
-
اطلب من Spec-Flow ملء الفراغات
spec-flow --skip-design: backfill proposal and requirements.md for the existing src/auth module.✓ تم النسخ
→ متطلبات EARS نظيفة مستخرجة من سلوك الكود الفعلي
-
استخدم المواصفات كهدف لإعادة الهيكلة
Now design phase — how would we restructure while preserving these requirements?✓ تم النسخ
→ ملف design.md يربط البنية المعمارية الجديدة بالمتطلبات الموجودة
النتيجة: إعادة هيكلة مبنية على عقد مكتوب بدلاً من المعرفة الضمنية
التركيبات
اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10
ألحق ملفات .spec-flow/ مع الكود بحيث تبقى المواصفات حية في سجل المستودع
After implementation, commit .spec-flow/ + src/ changes in one PR titled after the proposal.✓ تم النسخ
Spec-Flow يدفع بنية المراحل؛ planning-with-files يحافظ على ذاكرة التقدم بين الجلسات
Use spec-flow for the phases and planning-with-files for progress.md tracking across days.✓ تم النسخ
التكلفة والحدود
تكلفة التشغيل
- حصة API
- بلا
- الرموز لكل استدعاء
- تعيد كل مرحلة قراءة وثائق .spec-flow/ السابقة، لذلك ينمو السياق عبر المراحل
- التكلفة المالية
- مجاني — skills هي ملفات محلية
- نصيحة
- استخدم --fast للميزات البسيطة؛ البوابات تستحق فقط للعمل الذي يستغرق يومين أو أكثر
الأمان
الصلاحيات والأسرار ونطاق الأثر
تخزين بيانات الاعتماد: بلا بيانات اعتماد — prompts نقية فقط
نقل البيانات الخارجي: بلا — .spec-flow/ تبقى في دليل العمل الخاص بك
- ملفات .spec-flow/ سيتم الالتزام بها إلا إذا أضفتها إلى .gitignore؛ لكن معظم الفريق يفضل الالتزام بها
استكشاف الأخطاء
الأخطاء الشائعة وحلولها
كلمات مفتاح المحفزات خاطئة — يتخطى Claude المراحل
لا تقل '--fast' بدون قصد. إذا كنت تريد البوابات الكاملة، احذف الأعلام وقل 'spec-flow'.
البدائل
spec-flow مقابل البدائل
| البديل | متى تستخدمها | المقايضة |
|---|
| planning-with-files | تريد ذاكرة دائمة عبر الجلسات بدلاً من بوابات المراحل | محور مختلف — متكامل وليس متنافس |
| Freeform dev | الميزة تستغرق 1-2 ساعة من العمل | أسرع، لكن بدون مسار تدقيق |