گردش کار عامل طولانی مدت

هنگامی که یک کار احتمالاً چندین جلسه، انتقال یا عامل ایجاد شده را در بر می گیرد، از این کتاب بازی استفاده کنید.

اهداف

• به هر جلسه جدید راهی سریع برای بازیابی زمینه بدهید
• به جای اینکه یک بار تغییر بزرگ انجام دهید، کار را افزایشی نگه دارید
• قبل از افزودن کد بیشتر، یک خط پایه محلی شکسته را بگیرید
• مصنوعات بادوام را بگذارید که جلسه بعدی بتواند به آنها اعتماد کند

کجا باید حالت را حفظ کرد

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

فایل های مورد نیاز

این فایل ها را در شروع کار طولانی مدت ایجاد کنید:

• feature-list.json
• progress.md

از الگوهای docs/agent-playbooks/templates/feature-list.template.json و docs/agent-playbooks/templates/progress.template.md استفاده کنید.

JSON را برای لیست ویژگی ها ترجیح دهید تا نمایندگان بتوانند تعداد کمی از فیلدها را بدون بازنویسی کل سند به روز کنند.

چک لیست شروع جلسه

1. pwd را اجرا کنید.
2. progress.md را بخوانید.
3. feature-list.json را بخوانید.
4. git log --oneline -20 را اجرا کنید.
5. ./scripts/agent-init.sh --smoke را اجرا کنید.
6. دقیقاً یک مورد با بالاترین اولویت را انتخاب کنید که همچنان pending، in_progress، یا blocked باشد.

اگر مرحله دود با شکست مواجه شد، قبل از اجرای یک برش ویژگی جدید، خط پایه شکسته را اصلاح کنید.

قوانین جلسه

• هر بار روی یک ویژگی یا تکه کار کار کنید.
• لیست ویژگی ها را برای ماشین قابل خواندن و پایدار نگه دارید. به جای بازنویسی موارد نامرتبط، وضعیت، یادداشت ها، فایل ها و فیلدهای تأیید را به روز کنید.
• فقط یک مورد تأیید شده را پس از اجرای فرمان یا جریان کاربر فهرست شده در آن مورد علامت بزنید.
• از عوامل تخم ریزی شده برای برش های محدود استفاده کنید، نه برای مالکیت کلی وضعیت وظیفه.
• وقتی یک نماینده فرزند صاحب یک مورد است، شناسه دقیق مورد، معیارهای پذیرش و فایل‌هایی را که ممکن است لمس کند به آن بدهید.

چک لیست پایان جلسه

1. یک ورودی پیشرفت کوتاه به progress.md اضافه کنید.
2. مورد لمس شده را در feature-list.json به روز کنید.
3. دستورات دقیق اجرا شده برای تایید را ضبط کنید.
4. مسدودکننده‌ها، پیگیری‌ها و بهترین مورد بعدی برای از سرگیری را ضبط کنید.

شکل ورودی پیشرفت توصیه شده

از یک ساختار کوتاه مانند:

## 2026-03-17 14:30

- Item: F003
- Summary: Updated the browser-check flow to use the shared init/bootstrap path.
- Files: `.cursor/agents/browser-check.md`, `.codex/agents/browser-check.toml`
- Verification: `corepack yarn build`, `corepack yarn lint`, `corepack yarn typecheck`
- Next: Run the smoke flow and update the task-board status.