/ الدليل / الملعب / Waza (技)
● مجتمع tw93 ⚡ فوري

Waza (技)

بواسطة tw93 · tw93/Waza

عادات المهندس المتقدم مُعبَّأة كمهارات Claude Code — commits صغيرة وإعادة هيكلة مُحكمة وتصحيح مُركَّز ومراجعات متأنية. أشياء تعرفها، جُعلت قابلة للتكرار.

Waza (التقنية بالياباني 技) هي مجموعة منتقاة من مهارات الانضباط الهندسي بقلم tw93، مُصاِن نظام بيئي eSheep / Pake / Waza. كل مهارة تُرمّز عادة محددة: 'commit ذري صغير'، 'أحمر-أخضر-إعادة هيكلة'، 'تتبع ثنائي منهجي'، 'مراجعة كود بقائمة تحقق'. ليست ميزات رائعة — بل هي الانضباطات الصغيرة التي تُميّز مخرج المطوّر المتقدم عن المبتدئ، مُطبَّقة تلقائياً.

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

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

عرض مباشر

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

جاهز

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "waza-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ],
      "_inferred": true
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "waza-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/tw93/Waza",
        "~/.claude/skills/waza"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "waza-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/tw93/Waza",
          "~/.claude/skills/waza"
        ]
      }
    }
  }
}

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

claude mcp add waza-skill -- git clone https://github.com/tw93/Waza ~/.claude/skills/waza

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

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

استخدامات عملية: Waza (技)

جعل Claude يكتب commits صغيرة وذرية بدلاً من كتلة عملاقة واحدة

👤 أي شخص تنتهي PRs Claude الخاصة به كـ commit واحد مع 600 سطر متغيّر ⏱ ~30 min intermediate

متى تستخدمه: المراجعة في PR جحيم لأن الـ commit غير قابل للمراجعة.

المتطلبات الأساسية
  • المهارة مثبّتة — git clone https://github.com/tw93/Waza ~/.claude/skills/waza
الخطوات
  1. تخطيط الـ commits
    Use waza commit skill. Plan the work as a sequence of atomic commits before writing any code.✓ تم النسخ
    → خطة commits مُرقَّمة؛ كل منها ملخص بسطر واحد
  2. التنفيذ واحداً بواحد
    Make commit 1. Stop. Show me the diff and message.✓ تم النسخ
    → commit صغير واحد؛ الرسالة تتّبع الاتفاقية
  3. المتابعة أو المراجعة
    Continue with the next commit, or revise the plan if step 1 changed your understanding.✓ تم النسخ
    → إما الـ commit التالي أو الخطة المُراجَعة

النتيجة: PRs يمكنك مراجعتها فعلاً.

المزالق
  • الخطة دقيقة جداً (10 commits لتغيير بسيط) — الافتراضي في المهارة 3–7 commits لكل PR؛ مرّر --target N للتخصيص
اجمعها مع: github

تطبيق أحمر-أخضر-إعادة هيكلة على إعادة هيكلة تستحق الفعل

👤 المطورون الذين يُعيدون هيكلة كود موروث ⏱ ~90 min intermediate

متى تستخدمه: تريد إعادة الهيكلة؛ كذلك لا تريد كسر الأشياء.

الخطوات
  1. التغطية بالاختبارات
    Use waza refactor skill on /src/<module>.ts. First step: characterize current behavior with tests.✓ تم النسخ
    → اختبارات للسلوك الحالي؛ تجتاز
  2. إعادة الهيكلة
    Now refactor incrementally. Tests must stay green at every step.✓ تم النسخ
    → سلسلة commits إعادة هيكلة، جميعها خضراء

النتيجة: كود أنظف مع إثبات أنه لم ينكسر.

المزالق
  • 'اختبارات السلوك الحالي' تتضمن أخطاء موجودة — المهارة تُعلّم الاختبارات المشبوهة؛ ضعّها علامة وأعِد هيكلتها بشكل منفصل

إجراء مراجعة كود منظّمة على PR

👤 المراجعون الذين يريدون الاتساق ⏱ ~30 min beginner

متى تستخدمه: مراجعة PR لم تكتبه — من السهل تفويت الأشياء.

الخطوات
  1. المشي خلال الفروق
    Use waza review skill on PR #123. Walk the diff hunk by hunk; check: correctness, naming, error handling, tests, security.✓ تم النسخ
    → ملاحظات لكل hunk؛ أي مشكلة مُظهَرة
  2. الملخص
    Write the review summary — 3 strengths, 3 concerns, 1 question.✓ تم النسخ
    → ملخص بأسلوب نشر

النتيجة: مراجعات تجد أشياء، لا مسرح 'lgtm'.

المزالق
  • المهارة تنتقد الأسلوب عندما توجد مشكلات أكبر — تُعيد الترتيب حسب الخطورة؛ ثق بالترتيب
اجمعها مع: github

التركيبات

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

waza-skill + github

إقران مع GitHub MCP لدورة حياة PR كاملة

Plan, commit, push, open PR, request review — chain waza commit + github.✓ تم النسخ
waza-skill + ccpm-skill

CCPM تمتلك دورة حياة الـ issue، Waza تمتلك الانضباط الهندسي داخلها

/start issue 42, then run waza commit.plan inside the worktree.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
commit.plan task_description بداية أي عمل غير بسيط 0
refactor.tdd path, target إعادة هيكلة مع شبكة أمان 0
debug.systematic symptom, context خطأ يقاوم التخمين 0
review.checklist pr_url مراجعة PR 0

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

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

حصة API
غير ذي صلة
الرموز لكل استدعاء
خفيف — المهارات markdown قصير
التكلفة المالية
مجاني
نصيحة
العادات تتراكم — طبّقها باتساق لا فقط عند التعثّر

الأمان

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

تخزين بيانات الاعتماد: لا شيء
نقل البيانات الخارجي: محلي

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

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

المهارة تستمر في تقسيم الـ commits عندما يكون الواحد كافياً

أصغر وحدة تغيير تتفاوت؛ مرّر PR مثال للمعايرة

اختبارات إعادة الهيكلة تغطي القليل جداً

المهارة تُحذّر عندما التغطية <30% على الوحدة المتأثرة — أضف بذوراً يدوية

البدائل

Waza (技) مقابل البدائل

البديلمتى تستخدمهاالمقايضة
wshobson/agentsتريد وكلاء قائمة على الأدوار (frontend وbackend) بدلاً من مهارات عادةشكل مختلف؛ كلاهما جيد — مستويات تجريد مختلفة
addyosmani/agent-skillsتريد عمق web-perf/a11y تحديداًمجموعة Addy لـ web-frontend؛ Waza هندسة عامة

المزيد

الموارد

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

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

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