/ الدليل / الملعب / Spec Workflow
← كل الخوادم ↗ GitHub
● مجتمع Pimzino ⚡ فوري

Spec Workflow

بواسطة Pimzino · Pimzino/spec-workflow-mcp

تدفق عمل منظم: المتطلبات ← التصميم ← المهام، مع لوحة تحكم حية وبوابات موافقة بشرية — أوقف Claude من البرمجة العشوائية للميزات.

يحوّل Spec Workflow تطوير الميزات إلى خط أنابيب من ثلاث مراحل: وثيقة المتطلبات، وثيقة التصميم، قائمة المهام. كل مرحلة تتطلب موافقة (عبر لوحة تحكم ويب أو شريط جانبي في VSCode) قبل المتابعة. لا يمكن لـ Claude القفز إلى الأمام، ويكتب سجلات تنفيذ، ويتتبع حالة شريط التقدم لكل مهمة. يشبه Jira لـ Claude.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

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

عرض مباشر

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

spec-workflow-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "spec-workflow-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pimzino/spec-workflow-mcp@latest",
        "/path/to/project"
      ]
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "spec-workflow-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pimzino/spec-workflow-mcp@latest",
        "/path/to/project"
      ]
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "spec-workflow-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pimzino/spec-workflow-mcp@latest",
        "/path/to/project"
      ]
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "spec-workflow-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@pimzino/spec-workflow-mcp@latest",
        "/path/to/project"
      ]
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "spec-workflow-mcp",
      "command": "npx",
      "args": [
        "-y",
        "@pimzino/spec-workflow-mcp@latest",
        "/path/to/project"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "spec-workflow-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@pimzino/spec-workflow-mcp@latest",
          "/path/to/project"
        ]
      }
    }
  }
}

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

claude mcp add spec-workflow-mcp -- npx -y @pimzino/spec-workflow-mcp@latest /path/to/project

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

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

استخدامات عملية: Spec Workflow

ابنِ ميزة بمواصفة، لا بنبضة حدس عشوائية

👤 المطورون الذين يشحنون ميزات متوسطة التعقيد ⏱ ~90 min intermediate

متى تستخدمه: أنت على وشك أن تطلب من Claude «إضافة OAuth» وتهاب الـ diff من 500 سطر الذي سيصل دفعةً واحدة.

المتطلبات الأساسية
  • مسار المشروع معروف — يُشغَّل MCP مع /path/to/project كمعامل
الخطوات
  1. المتطلبات
    استخدم spec-workflow. أنشئ مواصفة باسم oauth-login. ابدأ بالمتطلبات — ماذا نضيف؟ لمن؟ ما الخارج من النطاق؟✓ تم النسخ
    → وثيقة متطلبات مسودة ورابط للوحة التحكم للموافقة
  2. الموافقة + التصميم
    وافقت في لوحة التحكم. الآن اكتب التصميم: المكونات، نموذج البيانات، مخطط التسلسل، حالات الخطأ.✓ تم النسخ
    → وثيقة تصميم مع بنية معمارية ملموسة
  3. المهام + التنفيذ
    وافقت. قسّم إلى مهام. ثم نفّذ المهمة 1.1 — هذه فقط، توقف بعدها.✓ تم النسخ
    → قائمة مهام منشأة؛ المهمة 1.1 فقط منفَّذة مع سجل

النتيجة: ميزة مشحونة مع مخرجات وسيطة قابلة للمراجعة — لا diff مجهول المصدر.

المزالق
  • Claude يحاول القفز مباشرةً إلى الكود — MCP يحجبه — لكن كن صريحًا في الـ prompts أيضًا: "لا تنفّذ بعد"
اجمعها مع: github · filesystem

احصل على موافقة طرف غير مهندس على المواصفة قبل الشروع في الكود

👤 الفرق التي لديها حلقات موافقة من مدير المنتج/التصميم ⏱ ~60 min intermediate

متى تستخدمه: تحتاج موافقة مدير المنتج قبل التنفيذ والمدير لا يقرأ GitHub PRs.

المتطلبات الأساسية
  • رابط لوحة التحكم قابل للمشاركة — أعد توجيه المنفذ أو اكشف localhost:5000 عبر ngrok للمديرين عن بُعد
الخطوات
  1. المواصفة
    أنشئ وثيقة متطلبات لـ checkout-v2 وشارك رابط لوحة التحكم.✓ تم النسخ
    → الوثيقة + رابط قابل للمشاركة
  2. التكرار بحسب التغذية الراجعة
    ترك مدير المنتج 3 تعليقات تعديل في لوحة التحكم. اجلبها وراجع الوثيقة.✓ تم النسخ
    → الوثيقة محدَّثة مع سجل التعديلات مرئيًا
  3. التنفيذ بعد الموافقة
    مرّت الموافقة للتو — انتقل إلى التصميم.✓ تم النسخ
    → تبدأ المرحلة التالية؛ طابع زمني للموافقة مسجَّل

النتيجة: سلسلة موافقة قابلة للتتبع من أطراف غير مهندسين.

المزالق
  • لوحة التحكم غير متاحة للمستخدمين عن بُعد — استخدم Tailscale أو ngrok مع مصادقة
اجمعها مع: github

التركيبات

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

spec-workflow-mcp + github

افتح PR لكل مهمة موافق عليها

بعد تنفيذ المهمة 2.1، افتح GitHub PR بعنوان "feat(oauth): task 2.1" مع الـ diff.✓ تم النسخ
spec-workflow-mcp + filesystem

خزّن المواصفات داخل المستودع بجانب الكود

احفظ المواصفة الموافق عليها في /docs/specs/oauth-login.md وأودعها.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
create_spec name: str ابدأ ميزة جديدة free
write_requirements spec_id, content: markdown المرحلة الأولى من أي مواصفة free
write_design spec_id, content: markdown بعد الموافقة على المتطلبات free
create_tasks spec_id, tasks: [] بعد الموافقة على التصميم free
execute_task spec_id, task_id نفّذ مهمة واحدة في كل مرة free
get_approval_status spec_id, stage بوابة المرحلة التالية free

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

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

حصة API
محلي
الرموز لكل استدعاء
يتناسب مع حجم الوثيقة/المهمة
التكلفة المالية
مجاني
نصيحة
أبقِ المتطلبات موجزة — تكلفة الموافقة وقت بشري لا رموز

الأمان

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

الحد الأدنى من الصلاحيات: filesystem-write (for spec docs)
تخزين بيانات الاعتماد: لا شيء
نقل البيانات الخارجي: لا شيء — لوحة تحكم محلية

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

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

لوحة التحكم لا تُحمَّل

شغّلها صراحةً: npx -y @pimzino/spec-workflow-mcp@latest --dashboard

تحقق: Visit localhost:5000
المنفذ 5000 مستخدَم (macOS AirPlay)

مرّر --port 5050 أو عطّل AirPlay Receiver في إعدادات النظام

تحقق: Check with `lsof -i :5000`
المهام تبقى معلّقة بعد الموافقة

عميل MCP قد يُخزّن نتائج أدوات قديمة — أعد تشغيل العميل

البدائل

Spec Workflow مقابل البدائل

البديلمتى تستخدمهاالمقايضة
Plain Markdown in /docsمطور فردي لا يحتاج حلقة موافقةلا تطبيق هيكلي، لا لوحة تحكم
Linear MCPتستخدم Linear للمهام وتريد من Claude لمس المشكلات مباشرةًلا طبقة وثيقة مواصفة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills