اگر از نوشتن ده‌ها صفحه مستندات فنی می‌ترسید، یک متدولوژی جدید این کابوس را به ۴ روز کاهش داده است. تصور کنید به جای تایپ دستی هر بخش، تنها بر خروجی نظارت کنید.
برای انتشار محصول The AI Platform (متعلق به شرکت Zephyr Cloud) در ۱۳ مه ۲۰۲۶، نویسنده باید راهنمای کاملی برای کاربران نهایی می‌نوشت؛ آن هم در حالی که رابط کاربری (UI) مدام تغییر می‌کرد. برای حل این مشکل، او از Goose استفاده کرد؛ یک عامل (Agent) — مثل کارمندی است که نه تنها دستور می‌گیرد، بلکه می‌تواند ابزارها را برای رسیدن به هدف به کار بگیرد — که توسط شرکت Block به صورت متن‌باز عرضه شده است.
همان‌طور که در تحلیل‌های قبلی ما درباره‌ی اتوماسیونِ عامل‌محور اشاره کردیم، کلید موفقیت در این پروژه، تعریف سه «مهارت» (Skill) پایدار بود:
- مهارت
write-docs: با ۵۱۳ خط دستورالعمل، لحن و قالب‌بندی دقیق متن را کنترل می‌کند.
- مهارت
doc-screenshots: با استفاده از Peekaboo برای اتوماسیون macOS و Swift OCR، متن‌های روی صفحه را می‌یابد. طبق گزارش نویسنده، عامل به جای ثبت دستی، از یک مانیفست YAML (یک فرمت ساده برای سازماندهی داده‌ها) استفاده کرد تا ۵۹ اسکرین‌شات دقیق را بگیرد.
- مهارت
docs-preview: با اتصال به Rspress، هر صفحه را در ۱.۸ ثانیه روی یک شبکه توزیع محتوا (CDN) منتشر می‌کند تا لینک زنده هر صفحه فوراً بررسی شود.
این روش مشکل «اسکرین‌شات‌های قدیمی» را حل کرد. وقتی در اواسط پروژه، نوار کناری برنامه تغییر کرد، نویسنده فقط مانیفست را به‌روز کرد و تمام ۵۹ تصویر در چند دقیقه بازتولید شدند. خروجی نهایی شامل ۵۵ صفحه و ۸۱ کامیت (Commit) در بازه ۴ روزه بود.
به باور ما، این تجربه ثابت می‌کند که عامل‌های هوش مصنوعی زاینده (Generative AI) زمانی بیشترین بازدهی را دارند که به جای پرامپت‌های پراکنده، «مهارت‌های پایدار» یاد بگیرند. با تبدیل مستندات به یک اثر مهندسی بازتولیدپذیر، تیم‌ها می‌توانند حتی در زمان تغییرات سریع برند یا رابط کاربری، کیفیت راهنماها را حفظ کنند.
گام بعدی شما
- بررسی استقرار فایل
llms.txtبرای اینکه مستندات شما برای سایر عامل‌های هوش مصنوعی خواندنی شود. - جایگزینی پرامپت‌های تکراری در گردش‌کارهای خود با تعریف «مهارت‌های پایدار».
- تست ابزار متن‌باز Goose برای اتوماسیون وظایف تکراری سیستم‌عامل.
اما تأثیر این رویکرد بر هزینه‌های نگهداری نرم‌افزار در مقیاس بزرگ چه خواهد بود؟ به تحلیل ما درباره‌ی مدل‌های استدلالی مراجعه کنید.
گفتگو