پرش به مطلب اصلی

کار طولانی‌مدت ایجنت

وقتی کار به ازسرگیری یا تحویل به دیگری نیاز دارد، یا وقتی یک اجرای واحد آن‌قدر طولانی است که فشرده‌سازی کانتکست ممکن است رد کارهای باقی‌مانده را گم کند، وضعیت ماندگار وظیفه را نگه دارید. وظایف کوچک به برد وظایف یا فایل پیشرفت نیاز ندارند. برای کار مشترک، یک feature-list.json و یک progress.md مختصر در پوشه docs/agent-runs/<slug>/ مخصوص همان وظیفه نگه دارید و هر جا مفید است از الگوهای موجود استفاده کنید.

نتیجه درخواست‌شده، شاخه/worktree فعلی، مالکیت فایل‌ها، تغییرات انجام‌شده، بررسی‌ها همراه با نتایجشان، فرایندها و نشست‌هایی که در اختیار دارید و گام حل‌نشده بعدی را ثبت کنید. اعتبارنامه‌ها یا رونوشت‌های دلبخواه از کد منبع را ذخیره نکنید. یک ویژگی را فقط وقتی کامل علامت بزنید که معیارهای پذیرش آن راستی‌آزمایی شده باشند.

هنگام ازسرگیری، پیش از ویرایش، وضعیت Git، آخرین پیشرفت ثبت‌شده و کد منبع مرتبط را بررسی کنید. منابع سازگاری را که در اختیار دارید دوباره به کار ببرید؛ سرور توسعه را فقط وقتی راه بیندازید که بررسی بعدی به آن نیاز دارد. به جای تکرار یک اجرای کامل روی کدی که تغییر نکرده، بررسی‌ها را بر اساس اثر تغییر و با کمک verification.md انتخاب کنید.

کارهای واگذارشده مرتبط را محدود و بدون هم‌پوشانی نگه دارید. بررسی‌های سنگین و نشست‌های مرورگر بر عهده یک ایجنت است. وقتی یک بخش تکمیل‌شده، یک مانع یا یک تحویل کار، چیزی را که مشارکت‌کننده بعدی باید بداند تغییر می‌دهد، وضعیت ماندگار را به‌روز کنید؛ هر فرمان را به‌شکل مکانیکی ثبت نکنید.