pStack: مجموعه‌ای از skillها برای اینکه ایجنت کدنویسی درست باگ رفع کنه
هوش مصنوعیخلاصهٔ کامل‌تر
pStack یه بستهٔ skill متن‌باز با لایسنس MIT هست که یه مهندس با اسم مستعار Potato ساخته؛ کسی که تو Cursor و تیم هستهٔ React کار می‌کنه. skill یعنی یه سری دستورالعمل آماده که ایجنت کدنویسی دنبالشون می‌کنه. مشکلی که هدف گرفته آشناست: از ایجنت می‌خوای یه باگ رو درست کنه، چند فایل رو تغییر می‌ده، تست‌ها رو اجرا می‌کنه و می‌گه تموم شد، ولی باگ هنوز هست. یا یه فیچر کوچیک می‌خوای و یه لایهٔ abstraction تازه تحویل می‌گیری.
اصلی‌ترین ورودی، دستور /potato-mode هست. ایجنت باید اول باگ رو تو برنامهٔ در حال اجرا بازتولید کنه، نه اینکه فقط کد رو بخونه و حدس بزنه. مثال مقاله یه جعبهٔ جستجوئه که با تایپ سریع گاهی نتیجهٔ یه query قدیمی‌تر رو نشون می‌ده. ایجنت باید درخواست‌های شبکه رو نگاه کنه و ثابت کنه یه پاسخ قدیمی که دیر رسیده داره نتیجهٔ جدید رو بازنویسی می‌کنه، نه اینکه فرضش کنه.
نکتهٔ مهمش اینه که اگه ایجنت بر اساس یه فرضیه تغییری داده و بعداً شواهد اون فرضیه رو رد کنه، باید اون تغییرها رو برگردونه. وگرنه آخر کار چند تا وصلهٔ بی‌ربط روی هم جمع میشه و معلوم نیست کدوم واقعاً کار کرده. بعد از پیدا شدن علت اصلی، اگه ارزون باشه یه تست شکست‌خورده نوشته میشه، کوچک‌ترین اصلاح ممکن اعمال میشه و همون تعامل اول دوباره اجرا میشه تا معلوم بشه درست شده.
سه skill دیگه برای فهمیدن کدن: /how مسیر یه جریان رو تو کد دنبال می‌کنه، مثلاً اینکه یه فیلد فرم چطوری به query دیتابیس می‌رسه. /why دلیل یه تصمیم قدیمی رو از تاریخچه درمیاره، مثلاً یه timeout که الکی به نظر می‌رسه. /teach هم بعد از رفع باگ توضیح می‌ده چی خراب بود و چرا اصلاح جواب داده، تا کدی که merge می‌کنی رو واقعاً بفهمی.
برای کارهای بزرگ‌تر، /architect قبل از نوشتن کد سؤال‌های طراحی رو جلو میاره و طرفدار ساده‌ترین راه‌حله. /arena یه کار رو به چند ایجنت می‌ده و یه ایجنت اصلی نتیجه‌ها رو مقایسه می‌کنه و ایده‌های خوب بقیه رو هم برمی‌داره. /swarm تحقیق رو بین چند ایجنت تقسیم می‌کنه، مثلاً یکی منطق فیلتر بک‌اند، یکی state فرانت‌اند و یکی پوشش تست. گزارش نهایی باید چیزهایی رو که تأیید نشده صریحاً بگه.
/interrogate بعد از پیاده‌سازی یه بازبینی چندایجنتی انجام می‌ده و یافته‌ها رو دسته‌بندی می‌کنه: چی واقعاً فیچر رو خراب می‌کنه، چی ارزش فکر کردن داره و چی اشتباهه. به گفتهٔ مقاله این جایگزین بررسی دستی نیست. نصبش هم ساده‌ست: Claude Code رو به مخزن pStack می‌دی و ازش می‌خوای skillها رو با پروژه‌ت تطبیق بده. فقط حواست باشه ایجنت‌های اضافه سهمیهٔ Claude Code یا بودجهٔ API رو زودتر تموم می‌کنن؛ برای کارهای روزمره یه پیاده‌سازی و یه بازبینی کافیه.
نکات کلیدی:
- pStack متن‌باز با لایسنس MIT هست و اول برای Cursor ساخته شده ولی با Claude Code هم قابل استفاده‌ست.
- /potato-mode چرخهٔ بازتولید، کوچک‌ترین اصلاح و تأیید دوباره رو اجباری می‌کنه.
- تغییرهای مربوط به یه فرضیهٔ ردشده باید برگردونده بشن.
- /how، /why و /teach برای فهمیدن کد هستن، نه تغییرش.
- /arena پیاده‌سازی‌های رقیب رو مقایسه می‌کنه و /swarm تحقیق رو بین چند ایجنت پخش می‌کنه.
- اجرای چند ایجنت هزینهٔ مصرف رو بالا می‌بره.
