نوشتن گزارش مهاجرت نرمافزار با هوش مصنوعی
امتیازهای آماده بررسی کد رو به گزارشی تبدیل کنید که نشون بده کدوم فایلها نیاز به بازبینی دارن و مدیر پروژه قبل از تصمیم درباره تحویل چه چیزی باید بدونه.
نوشتن گزارش مهاجرت نرمافزار با هوش مصنوعی وقتی به کارتون میاد که بررسی کد انجام شده ولی نتیجهاش هنوز بین چند فایل پخش شده. مثلا از بیست بخش یک برنامه، نوزده بخش خوب منتقل شدن و فقط بخش محاسبه تخفیف هنوز درستی نتیجهاش معلوم نیست. یک میانگین خوب ممکنه همین مورد مهم رو پنهان کنه. اسکیل migration-report کمک میکنه امتیاز کلی رو کنار بخشهای ضعیف ببینید و بگید هر نگرانی دقیقا به کدوم فایل برمیگرده.
برای کسی که قراره درباره تحویل تصمیم بگیره، فرق بین «بخش زیادی از کد منتقل شده» و «رفتار نسخه جدید درست بررسی شده» مهمه. شاید یک فایل از نظر پوشش کامل باشه اما در چند حالت نتیجه اشتباه بده. گزارش باید این دو موضوع رو جدا توضیح بده. اگه داده بررسی یک فایل رو ندارید، در متن مشخصش کنید تا جای خالی به اشتباه به عنوان امتیاز کامل حساب نشه.
کاربردها
- برای گزارش مهاجرت تعداد فایلهای بررسیشده و پراکندگی امتیازها رو بنویسید تا فقط میانگین جلوی چشم خواننده نباشه.
- هر امتیاز کیفیت پایین رو به نام فایل و دلیل ثبتشده وصل کنید تا تیم بدونه از کجا دنبال شواهد بیشتر بگرده.
- اولویت بازبینی فایلها رو با توجه به ضعف گزارششده تنظیم کنید و موارد مهم رو از تغییرهای صرفا ظاهری جدا نگه دارید.
- در خلاصه مدیریتی روشن کنید درباره کدوم بخش اطمینان بیشتری دارید و نتیجه کدوم بخش هنوز نیاز به بررسی داره.
- یک نمونه موفق رو هم ثبت کنید تا تیم بدونه کدوم رویکرد میتونه در بخشهای باقیمونده کمکش کنه.
نصب و استفاده
- اسکیل رو در ایجنتتون نصب کنید. دو فایل ورودی امتیاز مهاجرت و امتیاز سبک کد رو از بررسی مجاز پروژه آماده کنید. حساب جدا یا دسترسی به سرویس خارجی لازم ندارید.
- بگید «از روی این دو فایل یک گزارش بنویس. سه مورد نیازمند بررسی رو جلوتر بیار و برای هرکدوم امتیاز و دلیلش رو نشون بده.»
- قبل از تحویل، نام فایلهای کمامتیاز رو با ورودیها تطبیق بدید و برای ادعای مهم به نتیجه بررسی اصلی برگردید.
سوالات متداول
منبع
ساخته OpenHands. نام اصلی: migration-report، منتشرشده در GitHub با مجوز MIT.
مشاهده در GitHub