همه محصولات

ثبت تصمیم فنی با هوش مصنوعی

دلیل یک انتخاب رو همراه با گزینه‌هایی که کنار گذاشتید ثبت کنید. برای تصمیم کوچک یک یادداشت تاریخ‌دار و برای انتخاب ماندگارتر یک سند تصمیم می‌گیرید.

ثبت تصمیم فنی با هوش مصنوعی وقتی ارزشش رو نشون می‌ده که چند ماه بعد کسی بپرسه چرا تیم این راه رو انتخاب کرد. مثلا برای گزارش فروش بین خروجی روزانه و به‌روزرسانی لحظه‌ای بحث کردید و به خاطر هزینه نگهداری، اولی رو انتخاب کردید. اسکیل recording-decisions کمک می‌کنه همون دلیل و شرایطی که بهش رسیدید کنار تصمیم بمونه.

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

کاربردها

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

نصب و استفاده

  1. مجموعه technical-writer رو در ایجنت‌تون نصب کنید تا راهنمای مشترک نگارش و این اسکیل هر دو در دسترس باشن.
  2. انتخاب نهایی، تاریخ و یادداشت‌های مربوط به بررسی گزینه‌ها رو آماده کنید. اگر کسی مخالفت مهمی داشته، دلیل اون رو هم بگید.
  3. مثلا بنویسید «تصمیم گرفتیم گزارش روزانه باشه. از روی این یادداشت توضیح بده چرا حالت لحظه‌ای رو کنار گذاشتیم و چه وقت باید دوباره درباره‌اش تصمیم بگیریم.»
  4. از کسانی که در تصمیم دخیل بودن بخواید متن رو بخونن. بعد فایل رو با وضعیت درستش کنار مستندات بذارید.

سوالات متداول

منبع

ساخته riekelt. نام اصلی: recording-decisions، منتشرشده در GitHub با مجوز MIT.

مشاهده در GitHub