بني سيرڤيس أذكى مع Claude Code باستعمال claude-kit

شنو كيوفّر claude-kit

claude-kit هو مجموعة ديال المهارات والوكلاء والتعديلات المستقلة لـ Claude Code. كل عنصر كاين فالمجلد plugins/ ديال المستودع، وهادشي كيخلّيك تثبّت غير الوظائف اللي محتاج.

• savvy-flow: حزمة فيها مهارة ووكيل، كتخلّي الجلسة تخطّط للمهمة، وتفوّض الخدمة لوكلاء فرعيين خدامين بمستويات مختلفة، وتراجع النتائج ديالهم. كتستعملها بـ /savvy-flow ملي كتثبّتها يدويًا، ولا بالمساحة الاسمية ديال الإضافة ملي كتثبّتها من خلال السوق.
• savvy-progress: تعديل كيزيد شريط تقدّم فوق خانة الطلب ولوحة حيّة ديال الوكلاء. متصمّم باش يخدم مع savvy-flow، ولكن يقدر حتى يعرض أي وكلاء فرعيين.

الإضافتين كيخدمو بشكل مستقل. ملي كتكونو بجوج مثبتين، savvy-flow كيسوق شريط التقدّم، والعمّال ديالو كيعرضو التقدّم ديالهم فلوحة الوكلاء.

ثبّت claude-kit من السوق

طريقة السوق هي الأسهل باش تثبّت الإضافات فـ Claude Code.

1. حلّ Claude Code.
2. زيد المستودع كسوق وثبّت الإضافات اللي بغيتي:

/plugin marketplace add johnnyvizz/claude-kit
/plugin install savvy-flow@claude-kit
/plugin install savvy-progress@claude-kit

عاود شغّل الجلسة من بعد التثبيت. المهارات والوكلاء المثبتين من السوق كيتسمّاو بمساحات اسمية. لذلك، كتستعمل مهارة savvy-flow بهاد الشكل /savvy-flow:savvy-flow، والوكلاء ديالها كيتستعملو بأسماء بحال savvy-flow:savvy-careful.

تقدر تثبّت غير إضافة وحدة إلا كانت هي اللي مناسبة أكثر لطريقة خدمتك. ثبّت بجوج إلا بغيتي سير العمل ديال التخطيط ومؤشرات التقدّم البصرية يخدمو مجموعين.

ثبّت المكوّنات يدويًا

التثبيت اليدوي مفيد إلا بغيتي تنسخ مهارة لإعدادات Claude Code ديالك ولا تحمّل تعديل مباشرة من نسخة محلية من المستودع.

نسخ المستودع

git clone https://github.com/johnnyvizz/claude-kit.git ~/claude-kit

نسخ مهارة ووكلاء savvy-flow

المهارة ما كتحتاجش لنظام الإضافات ملي كتتثبت بهاد الطريقة. نسخ مجلد المهارة لمجلد المهارات ديال Claude Code:

cp -R ~/claude-kit/plugins/savvy-flow/skills/savvy-flow ~/.claude/skills/

ومن بعد نسخ تعريفات الوكلاء المرفقة لمجلد الوكلاء:

cp ~/claude-kit/plugins/savvy-flow/agents/*.md ~/.claude/agents/

بهاذ الطريقة، الأسماء كتبقى قصيرة: استعمل /savvy-flow للمهارة وأسماء بحال savvy-careful للوكلاء.

حمّل savvy-progress لجلسة وحدة

باش تحمّل تعديل التقدّم غير لجلسة معيّنة ديال Claude Code، شغّل Claude Code مع مجلد الإضافة ديالو:

claude --plugin-dir ~/claude-kit/plugins/savvy-progress

حمّل savvy-progress لكل الجلسات

باش تخلي التعديل متاح فكل الجلسات، بما فيها تطبيق سطح المكتب، ضبط CLAUDE_CODE_PLUGIN_DIRS فـ ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_PLUGIN_DIRS": "~/claude-kit/plugins/savvy-progress"
  }
}

إلا ضبطتي بزاف ديال مجلدات الإضافات، فرّق بينهم بـ :. وإلا كان CLAUDE_CODE_PLUGIN_DIRS فيه قيمة من قبل، زيد المجلد الجديد بلا ما تعوّض المداخل الموجودة.

شغّل سير عمل أساسي

من بعد ما تثبّت savvy-flow، عطيو مهمة باش يخطّط وينسّق. مثلًا، مع مهارة منسوخة يدويًا:

/savvy-flow راجع التغييرات ديال المصادقة وحدّد الاختبارات الناقصة

مع التثبيت من السوق، استعمل الصيغة ذات المساحة الاسمية:

/savvy-flow:savvy-flow راجع التغييرات ديال المصادقة وحدّد الاختبارات الناقصة

نموذج الجلسة كيخطّط للخدمة، وكيفوّض المهام للوكلاء الفرعيين العمّال ديالو، وكيراجع المخرجات ديالهم. إلا كان savvy-progress خدام حتى هو، شريط التقدّم ولوحة الوكلاء كيعطيوك نظرة حيّة على هاد النشاط.

المهمة بالضبط راجعة ليك: عطيو مراجعة للكود، ولا بحث، ولا أي مهمة تطوير أخرى كتستافد من التخطيط وتفويض الخدمة.

فهم بنية المستودع

كل إضافة كتتبع بنية واضحة ومتوقعة. كتالوج السوق وملفات تعريف الإضافات كيوضحو كيفاش كيلقى Claude Code المكوّنات:

.claude-plugin/marketplace.json   الكتالوج اللي كيقراه `/plugin marketplace add`
plugins/<name>/
  .claude-plugin/plugin.json      ملف التعريف
  skills/<skill>/SKILL.md         مهارة
  agents/*.md                     الوكلاء الفرعيون اللي كيتشحنو معاها
  hooks/hooks.json                تعديل: كيشير لوحدة hooks
  hooks/register.tsx              تعديل: الوحدة نفسها
  types/index.d.ts                تعديل: العقد ديال $.state

فهاد البنية، المهارة موصوفة بملف SKILL.md وتقدر تشحن تعريفات الوكلاء معاها. التعديل كيستعمل إعدادات hooks ووحدة التسجيل؛ والتصريح بالنوع ديالو كيوثّق العقد ديال $.state.

تحقّق من الإضافات قبل النشر

استعمل أوامر التحقّق ديال Claude Code باش تفحص إضافة معيّنة ولا كتالوج السوق:

claude plugin validate plugins/<name>
claude plugin validate .

الأمر الأول كيفحص مجلد الإضافة. والثاني كيفحص كتالوج المستودع من الجذر ديالو.

خلّي التثبيتات اليدوية محدّثة

ملي كتحمّل تعديل مباشرة من المستودع المنسوخ، حدّثو بهاد الأوامر:

cd ~/claude-kit
git pull

المود اللي تحمّل من داك المجلد كيستعمل الملفات المحدّثة. المهارات اللي تنسخات لـ ~/.claude/skills/ ما كتتحدّثش أوتوماتيكياً؛ من بعد ما تجيب التغييرات الجديدة، عاود نسخ ملفات المهارة والوكيل.

اعتبارات متقدمة

اختار أسماء بنطاقات أو أوامر قصيرة عن قصد

التثبيت من Marketplace كيوفّر عزل الإضافات باستعمال أسماء بنطاقات بحال /savvy-flow:savvy-flow. التثبيت اليدوي ديال المهارات كيتجاوز نظام الإضافات وكيخلّي الأوامر قصيرة. استعمل الطريقة اللي كتناسب أكثر واش كتفضّل تدبير Marketplace ولا الملفات المحلية المباشرة.

خد بعين الاعتبار توافق المودات

المودات كيستعملو خطافات الدوال عبر hooks/register.tsx، وهاد الشي عبارة عن واجهة برمجية ديال Claude Code مازال فمرحلة الوصول المبكر. المستودع تجرّب على Claude Code 2.1.286، والواجهة البرمجية تقدر تتبدّل بين الإصدارات.

إلا ما بانش مود مثبّت من Marketplace، حمّلو يدوياً باستعمال --plugin-dir ولا ضبط المجلد ديالو عبر CLAUDE_CODE_PLUGIN_DIRS.

جمع بين الإضافات ملي كتحتاج للرؤية

يقدر savvy-flow يخدم بلا savvy-progress، وsavvy-progress يقدر يخدم بلا savvy-flow. تثبيت بجوج هو الإعداد اللي كيعطي أكبر قدر من المعلومات: سير العمل كينسّق المهمة، والمود كيبين التقدّم وحالة الوكيل النشيط.

الخلاصة

claude-kit كيعطي لمستخدمي Claude Code أدوات معيارية للتخطيط، والتفويض، والمراجعة، وتتبع التقدّم. ثبّت savvy-flow وsavvy-progress من Marketplace باش يكون عندك إعداد مُدار، ولا دير clone للمستودع ونسخ المكوّنات أو تحميلها يدوياً. تذكّر الاختلافات فالنطاقات، وتحقّق من التغييرات قبل النشر، وحدّث المهارات المنسوخة بشكل منفصل على المودات اللي كتتحمّل من المستودع.