پیدا کردن علت مشکل مستندات با هوش مصنوعی
وقتی یک راهنمای قدیمی مدام دوباره سر راه خواننده قرار میگیره، با شواهد پروژه ببینید مشکل از کجا شروع شده و چه تغییری میتونه جلوی تکرارش رو بگیره.
پیدا کردن علت مشکل مستندات با هوش مصنوعی برای وقتی مناسبه که یک ایراد بیشتر از یک بار تکرار شده. مثلا پشتیبان تیم دوباره لینکی برای همکار جدید فرستاده که به راهنمای نسخه قبلی میرسه. اسکیل docs-retro از شما میخواد اول اتفاق مشخص رو انتخاب کنید. بعد ایجنتتون سراغ ردش در پیامها، تغییرهای راهنما یا نتیجه بررسی قبلی میره.
شاید کسی لینک اشتباه رو کپی کرده باشه، شاید هم صفحه شروع پروژه هنوز همون لینک قدیمی رو نشون بده. راهحل این دو حالت یکی نیست. ایجنت بین چیزی که سند نشون میده و دلیلی که هنوز باید بررسی بشه فرق میذاره. اگر یک تغییر کوچیک مثل اصلاح صفحه شروع کافیه، لازم نیست تیم برای هر ویرایش راهنما یک فرم دیگه پر کنه.
کاربردها
- برای بررسی مشکل راهنما، نمونهای رو انتخاب کنید که دفعه قبل هم خواننده رو به صفحه اشتباه فرستاده.
- در مرور تغییرهای مستندات، ببینید لینک قدیمی بعد از جابهجایی فصل چطور باقی مونده.
- برای پیدا کردن متن تکراری، بررسی کنید چرا دو صفحه جدا درباره یک تصمیم حرف میزنن و کدوم باید مرجع باشه.
- در تحلیل خطای تکراری، نمونهای که شواهد کافی نداره رو کنار موردهای قطعی علامت بزنید.
- برای بهبود تحویل پروژه، یک راه مشخص پیشنهاد بدید که همکار بعدی از صفحه شروع به راهنمای درست برسه.
نصب و استفاده
- مجموعه اصلی docs-governance رو در ایجنتتون آماده کنید و فقط به یادداشتها و پروژهای که اجازهشون رو دارید دسترسی بدید. اگر بررسی محلی لازم باشه، پایتون و Git هم کاربرد دارن.
- مشکل رو با یک مثال و زمان وقوعش توضیح بدید. بخواید ایجنت تغییرها، پیامهای مربوط و تصمیمهای قبلی رو کنار هم بذاره و هر جا مدرکی کم داره مشخص کنه.
- پیشنهادها رو مرور کنید و برای راهحلی که میپسندید یک روش آزمایش تعیین کنید. حالت عادی فقط گزارش میده و ثبت تغییر در راهنمای تیم با اجازه شماست.
سوالات متداول
منبع
ساخته qshanx. نام اصلی: docs-retro، منتشرشده در GitHub با مجوز MIT.
مشاهده در GitHub