صفحه ۳۳ از ۴۹، مراجع
نقشه روش‌ها
این جدول شایع‌ترین حالت‌های شکست ایجنت‌های کدنویسی در اجراهای طولانی‌مدت را به مصنوع یا قاعده عملیاتی‌ای که معمولاً ابتدا آن را برطرف می‌کند نگاشت می‌نماید.
| حالت شکست | در عمل چگونه به نظر می‌رسد | راهکار اصلی | مصنوع پشتیبان |
|---|---|---|---|
| سردرگمی شروع سرد | یک نشست جدید بیشتر وقت خود را صرف بازکشف راه‌اندازی و وضعیت می‌کند | تبدیل مخزن به یگانه منبع حقیقت | claude-progress.md |
| خزش دامنه | ایجنت چندین ویژگی را آغاز می‌کند و هیچ‌کدام را به صورت تمیز تمام نمی‌کند | محدود کردن دامنه فعال | feature_list.json |
| اتمام زودهنگام | ایجنت پس از ویرایش‌های کد اما پیش از اثبات قابل‌اجرا اعلام اتمام کار می‌کند | گره زدن اتمام کار به شواهد | clean-state-checklist.md |
| راه‌اندازی شکننده | هر نشست از نو یاد می‌گیرد که چگونه پروژه را بوت کند | استانداردسازی راه‌اندازی و راستی‌آزمایی | init.sh |
| تحویل ضعیف | نشست بعدی نمی‌تواند تشخیص دهد چه چیزی تأیید شده، چه چیزی خراب است، یا بعداً چه شود | پایان دادن با یک تحویل صریح | session-handoff.md |
| بازبینی سلیقه‌ای | کیفیت بازبینی به سلیقه یا حافظه وابسته است | امتیازدهی به خروجی با دسته‌بندی‌های ثابت | evaluator-rubric.md |
اصل عملیاتی#
کوچک‌ترین مصنوعی را اضافه کنید که مستقیماً به حالت شکست مشاهده‌شده می‌پردازد. از حل تمام مشکلات قابلیت اطمینان از طریق ریختن متن بیشتر در یک فایل دستورالعمل سراسری واحد پرهیز کنید.