استخدم improve لتدقيق قاعدة الشيفرة وإخراج plans فقط

لمن يناسب

إن أردت أن يرى نموذج أقوى قاعدة الشيفرة بوضوح، ويحكم ما يستحق العمل، ويكتب مواصفة، ثم يسلّم التنفيذ لنموذج أرخص، فإن improve يناسبك. الصيغة الرسمية: تدقيق أي قاعدة شيفرة وكتابة خطط تنفيذ لوكلاء آخرين. المهارة نفسها لا تنفّذ شيئًا؛ الخطة هي الناتج.

يجب أن تتوقف المرة الأولى عند الخطة. لن تغيّر المصدر. الكتابة المسموحة الوحيدة هي plans/. إن أردت أن تغيّر المهارة نفسها شيفرة العمل مباشرة فقد اخترت الخطأ. جهة التنفيذ يجب أن تغيّر فقط في worktree قابل للرمي؛ الدمج تفعله أنت دائمًا. هذه الصفحة لا تعطي أوامر worktree؛ لا تخترعها.

تقول الشروح العلنية إنها تعمل في أي وكيل يدعم تنسيق Agent Skills. الخطط markdown عادي يستطيع وكيل أو شخص مواصلته. لا يُسمَّى عميل محدد. لا تُضِف قائمة منتجات ولا تكتبها كدعم حصري.

أول تجربة في 3 دقائق

استخدم أمر التثبيت الرسمي هذا فقط:

npx skills add shadcn/improve

الشرط: لديك قاعدة شيفرة حقيقية للتدقيق وتستطيع تشغيل npx في ذلك المشروع. بعد التثبيت استعد لاستخدام /improve. لا تخترع طريقة تثبيت ثانية.

التثبيت يكتب ملفات المهارة. قبل التشغيل أكّد أن المجلد الحالي هو المستودع المراد تدقيقه. بعد الأمر افعل أولًا تحققًا لا يكتب خطة: أكّد أن الوكيل يعرف /improve ويستطيع إعادة عبارة «اكتب فقط في plans/ ولا تغيّر المصدر». هذه إشارة النجاح القابلة للرصد للتثبيت.

تشغيل /improve الحقيقي يقوم بتدقيق كامل وترتيب أولويات وكتابة خطط في plans/. أكّد أنك تقبل ملفات خطة markdown جديدة ثم نفّذ:

/improve

إشارة النجاح: المصدر لم تغيّره، وفي plans/ تظهر اكتشافات ذات أولوية وخطط تنفيذ. المواد العلنية لا تذكر أوامر شرطة مائلة أخرى ولا تضمن قاعدة تسمية ملفات الخطة.

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

الحالة 1: تدقيق كامل للمستودع الحالي ثم خطة. مع التثبيت شغّل /improve ودعه يُكمل التدقيق → اكتشافات الأولوية → الخطة. اقرأ أولًا markdown في plans/ ثم قرر إن كنت ستسلّم التنفيذ لغيرك. هذا هو مسار العمل الرئيسي. الشروح العلنية لا تكتب قائمة أبعاد التدقيق؛ لا تتظاهر بأنك تعرف أي ملفات ستُفحص.

الحالة 2: سلّم الخطة لوكيل أو شخص آخر للتنفيذ. الرسمي يقول إن الخطة markdown عادي يمكن لأي أحد إكمالها؛ هذه المهارة ما زالت لا تنفّذ. جهة التنفيذ تغيّر فقط في worktree قابل للرمي؛ أنت تُكمل الدمج. أكّد نطاق الخطة أولًا ثم سلّم. هذه الصفحة لا تعطي أوامر تنفيذ أو دمج. هذه الحالة تغطي فقط «تسليم الخطة والسيطرة على الدمج».

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

المهارة نفسها لا تغيّر المصدر أبدًا. الكتابة تذهب فقط إلى plans/. لا تعاملها كأداة إعادة هيكلة أو إصلاح تلقائي. ولا تدعها تنفّذ الخطة في مساحة العمل الرئيسية.

التثبيت هو فقط npx skills add shadcn/improve. الصفحة لا تسمّي عميلًا، بل دعم تنسيق Agent Skills فقط. لا تُضِف marketplace ولا تنسخ مجلد skills لم يُعطَ.

/improve يكتب ملفات خطة؛ أكّد قبل التشغيل. المواد العلنية بلا خطوات إزالة، ولا تحوّل «نموذج أقوى / نموذج أرخص» إلى معرفات نماذج إلزامية.

عنوان المستودع:

https://github.com/shadcn/improve