سؤال مصاحبه

تفاوت بسته‌ی تحویل دست‌به‌دست با گزارش وضعیت

What a handoff packet carries that a status report does not

  • سطح ۱: غربالگری
  • مفهومی
  • ۶ دقیقه

در پایان هر نشست (session)، ایجنت شما پاراگرافی می‌نویسد و کارهای انجام‌شده را شرح می‌دهد. با این حال، نشست بعدی باز هم نیم ساعت اولش را صرف سر درآوردن از اوضاع می‌کند. جای چه چیزی در دست‌سازه (artifact) پایان نشست خالی است، و چطور باید آن را تولید کرد تا هیچ‌وقت از قلم نیفتد؟

اول خودتان جواب بدهید، بعد پاسخ را باز کنید.

پاسخ کوتاه

آن پاراگراف صرفاً یک گزارش وضعیت است، اما بسته‌ی تحویل دست‌به‌دست (handoff packet) به 7 فیلد نیاز دارد: خلاصه، فایل‌های تغییریافته، دستورهای اجراشده، تلاش‌های ناموفق، ریسک‌های باز، اقدام بعدی (next action) و ارجاعی به گزارش‌های راستی‌آزمایی و بازبینی. «اقدام بعدی» مهم‌ترین فیلد است؛ چون گام اول نشست بعدی را کاملاً قطعی (deterministic) می‌کند. این بسته را به جای اینکه از ایجنت بخواهید بنویسد، از روی دست‌سازه‌های میز کار (workbench) بسازید؛ همچنین قبل از آن یک بررسی پاک‌سازی اجرا کنید تا بسته، درختی را توصیف کند که نشست بعدی بتواند با خیال راحت به آن اعتماد کند.

پاسخ کامل

هفت فیلد اصلی

فیلد پرسشی که به آن پاسخ می‌دهد
summary چه کارهایی انجام شد، در یک پاراگراف
changed_files تفاوت‌های بازنگری (diff) در یک نگاه
commands_run چه دستورهایی اجرا شد، بر اساس رکوردهای بازخورد
failed_attempts چه راه‌هایی امتحان شد و چرا جواب نداد
open_risks چه خطرهایی نشست بعدی را تهدید می‌کند، همراه با سطح اهمیت
next_action اولین گام ملموسی که نشست بعدی برمی‌دارد
verdict_pointer مسیر گزارش‌های راستی‌آزمایی و حکم ارزیابی (verdict) بازبینی

بسته‌ای که همه‌ی فیلدها را به جز next_action داشته باشد، صرفاً یک گزارش وضعیت است. این گزارش مفید است، اما نشست بعدی همچنان مجبور است خودش برای نقطه‌ی شروع تصمیم بگیرد.

تولید خودکار، نه دستی

تحویل‌نامه‌ای که دستی نوشته شود، در روزهای سخت و پرفشار جا می‌ماند. مولد بسته، فایل وضعیت (state file)، گزارش راستی‌آزمایی، گزارش بازبینی و لاگ بازخورد را می‌خواند و بسته را در دو قالب خروجی می‌دهد: handoff.md برای انسان و handoff.json برای ایجنت بعدی. در صورت مغایرت میان این دو، اولویت با نسخه JSON است. وظیفه‌ی ایجنت فقط این است که میز کار را در وضعیتی بگذارد که مولد بتواند آن را خلاصه کند.

کوتاه کردن لاگ

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

به جا گذاشتن وضعیتی تمیز

اگر نشست بعدی کارش را با تفاوت‌های بازنگری نیمه‌کاره، فایل موقت سرگردان، branch اشتباه و تست‌هایی باز کند که حتی قبل از اجرا خطا می‌دهند، بهترین بسته هم دردی دوا نمی‌کند. پاک‌سازی یک مرحله‌ی مستقل است؛ یک بررسی الزامی، نه یک عادت اختیاری. تغییرات درخت کاری باید commit شوند یا همراه با یادداشت stash گردند. هیچ دست‌سازه‌ی موقتی نباید باقی بماند. تست‌ها یا باید سبز باشند، یا اگر قرمزند علت خرابی در ریسک‌های باز قید شده باشد. بورد ویژگی‌ها (feature board) باید با واقعیت منطبق باشد. شاخه همان branch مورد انتظار باشد. مرحله‌ی پاک‌سازی فهرستی از مسائل مسدودکننده تولید می‌کند و خالی بودن این فهرست، پیش‌شرطی است که مولد قبل از نوشتن بسته، برقرار بودنش را بررسی و تأیید می‌کند.

سؤال‌های تکمیلی مصاحبه‌گر
  • سطح 1: چرا هنگام مغایرت میان دو قالب، نسخه JSON ملاک است؟ پاسخ مورد انتظار: ایجنت بعدی نسخه JSON را بارگذاری می‌کند؛ بنابراین قالب ماشین‌خوان همان قالبی است که نشست بعدی را هدایت می‌کند.
  • سطح 2: کدام تلاش‌های ناموفق به بسته تعلق دارند؟ پاسخ مورد انتظار: تمام رکوردهای با کد خروجی غیرصفر همراه با زنجیره‌ی تلاش‌های مجدد، تا نشست بعدی بن‌بست‌های شناخته‌شده را دوباره تکرار نکند.
  • سطح 2: تفاوت میان بسته‌ی تحویل و فایل وضعیت چیست؟ پاسخ مورد انتظار: فایل وضعیت در هر نوبت گفت‌وگو (turn) خوانده می‌شود و نشان می‌دهد ایجنت اکنون کجاست؛ اما بسته‌ی تحویل فقط یک‌بار در پایان نشست تولید می‌شود و به نشست بعدی می‌گوید کار را از کجا شروع کند.
  • سطح 3: دو نشست روی دو branch مختلف هر کدام یک بسته‌ی تحویل نوشته‌اند؛ نشست بعدی چطور یکی را انتخاب می‌کند؟ پاسخ مورد انتظار: هر بسته مشخصات branch، آخرین commit معتبر و یکی از وضعیت‌های active، superseded یا archived را با خود دارد؛ و فقط بسته‌ی active مربوط به همین branch مبنای پیشبرد نشست قرار می‌گیرد.
جواب‌های اشتباهی که مصاحبه‌گرها زیاد می‌شنوند
  • «از ایجنت بخواهید در پایان یک خلاصه‌ی مفصل بنویسد.» وقتی نشست بد تمام شود، خلاصه‌ی دستی از قلم می‌افتد؛ در حالی که دقیقاً همان نشست‌های ناموفق بیشترین نیاز را به بسته‌ی تحویل دارند.
  • «تاریخچه‌ی گفت‌وگو همان بسته‌ی تحویل است.» تاریخچه کوتاه یا پاک می‌شود، و نشست بعدی هم نمی‌تواند در دقیقه‌ی اول خود، یک ساعت گفت‌وگو را بازپخش (replay) کند.
  • «گزارش راستی‌آزماییِ سبز برای ادامه‌ی کار کافی است.» این گزارش وضعیت وظیفه (task) را اثبات می‌کند نه وضعیت درخت کد را، و یک درخت نامرتب ده دقیقه‌ی اول نشست بعدی را هدر می‌دهد.

کجای دوره آموزش داده می‌شود

درس تحویل وظیفه میان چند نشست این بسته را از روی فایل‌های میز کار می‌سازد و بررسی پاک‌سازی را به آن اضافه می‌کند.