improve: اسکیل shadcn که کد رو بررسی میکنه و برای بقیه ایجنتها برنامه مینویسه
خلاصهٔ کاملتر
improve یه agent skill از shadcn هست که کدبیس رو audit میکنه و برای ایجنتهای دیگه implementation plan مینویسه. ایدهش اینه که قویترین مدل رو برای بخشی بذاری که هوش واقعاً توش اثر داره، یعنی فهمیدن کد، تشخیص اینکه چی ارزش انجام دادن داره و نوشتن مشخصات. اجرا رو هم بدی به مدلهای ارزونتر. خود اسکیل هیچوقت چیزی رو پیاده نمیکنه و به قول خودش «برنامه همون محصوله».
با npx skills add shadcn/improve نصب میشه و تو هر ایجنتی که فرمت Agent Skills رو پشتیبانی کنه کار میکنه. دستور اصلی /improve هست که یه audit کامل انجام میده. حالتهای دیگه هم داره: quick برای یه بررسی ارزون، deep برای بررسی کامل، security یا perf برای تمرکز روی یه دسته، branch فقط برای تغییرات برنچ فعلی، و next برای پیشنهاد فیچر.
روند کار چند مرحله داره. اول repo رو نقشهبرداری میکنه: stack، قراردادها و دستورهای build و test و lint، که بعداً تو هر برنامه شرط تأیید میشن. سندهایی مثل ADR و CONTEXT.md و DESIGN.md رو هم میخونه تا تصمیمهای قبلی رو دوباره بهعنوان مشکل گزارش نکنه. بعد چند subagent (یعنی ایجنتهای فرعی که موازی کار میکنن) رو تو نُه دسته پخش میکنه، از درستی و امنیت و کارایی تا tech debt و مستندات. هر یافته باید شاهد file:line داشته باشه.
چون subagentها زیادی گزارش میدن، ایجنت اصلی خودش دوباره همه جاهای ذکرشده رو میخونه تا موارد اشتباه حذف بشن و ردشدهها با دلیل ثبت بشن که دفعه بعد برنگردن. یافتهها تو یه جدول بر اساس اثر تقسیم بر زحمت مرتب میشن و خودتون انتخاب میکنید کدومها برنامه بشن.
برنامهها برای ضعیفترین اجراکننده ممکن نوشته میشن، یعنی مدلی که اصلاً جلسه قبلی رو ندیده. همه context داخل خود فایله، هر مرحله با یه دستور و خروجی مورد انتظارش تموم میشه، و شرطهای STOP دارن که اگه واقعیت با برنامه نخوند، مدل کوچیک سرخود تصمیم نگیره. هر برنامه commit گیت رو هم ثبت میکنه تا اجراکننده اول تغییرات کد رو چک کنه.
با /improve execute یه مدل ارزونتر تو یه git worktree جدا برنامه رو اجرا میکنه و اسکیل مثل یه tech lead نتیجه رو بررسی میکنه، ولی merge همیشه با خودتونه. reconcile هم وضعیت برنامهها رو بهروز میکنه و با --issues میشه برنامهها رو بهصورت GitHub issue منتشر کرد.
نکات کلیدی:
- improve فقط تو پوشه plans/ مینویسه و هیچوقت سورس کد رو تغییر نمیده.
- audit تو نُه دسته انجام میشه و هر یافته شاهد file:line، اثر، زحمت و میزان اطمینان داره.
- برنامهها شرطهای تأیید ماشینی و شرطهای STOP دارن تا مدلهای کوچیک هم بتونن اجراشون کنن.
- execute اجرا رو تو یه git worktree جدا انجام میده و حداکثر ۲ دور اصلاح میگیره.
- مقدار secretها هیچوقت تو خروجی نمیاد، فقط جا و نوعشون.
- لایسنس MIT هست.




