spec-flow MCP — حالات الاستخدام, التثبيت & عرض مباشر

لماذا تستخدمه

الميزات الأساسية

سير عمل من 5 مراحل: الاقتراح → المتطلبات (صيغة EARS) → التصميم → المهام → التنفيذ
كل مرحلة تكتب وثيقة Markdown إلى .spec-flow/ ليسهل تتبع القرارات والتحقق منها
انتقالات بوابات مقيدة — يتوقف Claude لانتظار تأكيدك قبل الانتقال للمرحلة التالية
محفزات بلغات متعددة: إنجليزية وصينية ('写个方案', '做个规划')
خيارات بديلة: --fast لتخطي البوابات، و--skip-design للميزات البسيطة

عرض مباشر

كيف يبدو في الممارسة

spec-flow-skill.replay ▶ جاهز

0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "spec-flow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/echoVic/spec-flow",
        "~/.claude/skills/spec-flow"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "spec-flow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/echoVic/spec-flow",
        "~/.claude/skills/spec-flow"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "spec-flow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/echoVic/spec-flow",
        "~/.claude/skills/spec-flow"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "spec-flow-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/echoVic/spec-flow",
        "~/.claude/skills/spec-flow"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "spec-flow-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/echoVic/spec-flow",
        "~/.claude/skills/spec-flow"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json

{
  "context_servers": {
    "spec-flow-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/echoVic/spec-flow",
          "~/.claude/skills/spec-flow"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add spec-flow-skill -- git clone https://github.com/echoVic/spec-flow ~/.claude/skills/spec-flow

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

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

استخدامات عملية: spec-flow

تحويل فكرة ميزة غامضة إلى مواصفات موثقة وتنفيذ

👤 المهندسون الذين يرفضون قول 'ابدأ الترميز فقط' ⏱ ~60 min intermediate

متى تستخدمه: عندما يعطيك مدير المشروع فكرة في سطر واحد، وتفضل قضاء 20 دقيقة لكتابة المواصفات من قضاء يومين في كتابة الكود الخاطئ

المتطلبات الأساسية

تم استنساخ Skill إلى ~/.claude/skills/spec-flow — git clone https://github.com/echoVic/spec-flow ~/.claude/skills/spec-flow

الخطوات

استدعاء سير العمل

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 للعمل البسيط

اجمعها مع: github · filesystem

هندسة عكسية لمواصفات الكود الموجود قبل إعادة الهيكلة

👤 المهندسون الذين يرثون وحدات بدون توثيق ⏱ ~45 min intermediate

متى تستخدمه: عند إعادة هيكلة شيء لم يكتب أحد مواصفات له

الخطوات

اطلب من 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 يربط البنية المعمارية الجديدة بالمتطلبات الموجودة

النتيجة: إعادة هيكلة مبنية على عقد مكتوب بدلاً من المعرفة الضمنية

اجمعها مع: filesystem

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

spec-flow-skill + github

ألحق ملفات .spec-flow/ مع الكود بحيث تبقى المواصفات حية في سجل المستودع

After implementation, commit .spec-flow/ + src/ changes in one PR titled after the proposal.✓ تم النسخ

spec-flow-skill + planning-with-files

Spec-Flow يدفع بنية المراحل؛ planning-with-files يحافظ على ذاكرة التقدم بين الجلسات

Use spec-flow for the phases and planning-with-files for progress.md tracking across days.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداة	المدخلات	متى تستدعيها
proposal_phase	feature description	بداية ميزة جديدة
requirements_phase	approved proposal	بعد تأكيد الاقتراح
design_phase	approved requirements	بعد تأكيد المتطلبات؛ يمكن تخطيها باستخدام --skip-design
tasks_phase	approved design	قبل التنفيذ
implementation_phase	approved tasks	المرحلة الأخيرة — البناء الفعلي

التكلفة والحدود

تكلفة التشغيل

حصة API: بلا
الرموز لكل استدعاء: تعيد كل مرحلة قراءة وثائق .spec-flow/ السابقة، لذلك ينمو السياق عبر المراحل
التكلفة المالية: مجاني — skills هي ملفات محلية
نصيحة: استخدم --fast للميزات البسيطة؛ البوابات تستحق فقط للعمل الذي يستغرق يومين أو أكثر

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: بلا بيانات اعتماد — prompts نقية فقط

نقل البيانات الخارجي: بلا — .spec-flow/ تبقى في دليل العمل الخاص بك

ملفات .spec-flow/ سيتم الالتزام بها إلا إذا أضفتها إلى .gitignore؛ لكن معظم الفريق يفضل الالتزام بها

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

لم يتم استدعاء Skill — يقوم Claude بالترميز بدون كتابة proposal.md

استخدم إحدى عبارات المحفزات بدقة: 'spec-flow' أو 'spec mode' أو 'need a plan' أو '写个方案'.

تحقق: ls ~/.claude/skills/spec-flow/SKILL.md

رأس ملف SKILL.md خاطئ

استنسخ المستودع مرة أخرى؛ الوصف هو ما يدفع التفعيل التلقائي

تحقق: head ~/.claude/skills/spec-flow/SKILL.md

كلمات مفتاح المحفزات خاطئة — يتخطى Claude المراحل

لا تقل '--fast' بدون قصد. إذا كنت تريد البوابات الكاملة، احذف الأعلام وقل 'spec-flow'.

البدائل

spec-flow مقابل البدائل

البديل	متى تستخدمها	المقايضة
planning-with-files	تريد ذاكرة دائمة عبر الجلسات بدلاً من بوابات المراحل	محور مختلف — متكامل وليس متنافس
Freeform dev	الميزة تستغرق 1-2 ساعة من العمل	أسرع، لكن بدون مسار تدقيق

spec-flow

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

التثبيت

اختر العميل

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

استخدامات عملية: spec-flow

تحويل فكرة ميزة غامضة إلى مواصفات موثقة وتنفيذ

المتطلبات الأساسية

الخطوات

المزالق

هندسة عكسية لمواصفات الكود الموجود قبل إعادة الهيكلة

الخطوات

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

الأدوات

ما يوفره هذا الـ MCP

التكلفة والحدود

تكلفة التشغيل

الأمان

الصلاحيات والأسرار ونطاق الأثر

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

البدائل

spec-flow مقابل البدائل

المزيد

الموارد