پرش به محتوای اصلی
پرش به محتوای مقاله

درون سازوکار عامل‌های هوش مصنوعی SlideOps برای بازسازی مستندات

·۹ شهریور ۱۴۰۵۴ دقیقه مطالعه۲ بازدید
مخزن گیت‌هاب را به مجموعه اسلاید تبدیل کنید که با تغییر کد، ناسازگاری را گزارش می‌دهد.
مخزن گیت‌هاب را به مجموعه اسلاید تبدیل کنید که با تغییر کد، ناسازگاری را گزارش می‌دهد.
اشتراک‌گذاری
واقعاً چه چیز جدید است؟

نوآوری اصلی در ایجاد یک لایه بررسی تازگی (Freshness Check) بدون نیاز به LLM است که تطابق اسلاید و کد را در میلی‌ثانیه‌ها و به‌صورت آفلاین تایید می‌کند.

تصور کنید در میانه یک جلسه فنی، متوجه می‌شوید اسلایدی که نمایش می‌دهید مربوط به نسخه سال گذشته کد است و حالا باید با جمله‌ای شرم‌آور بگویید «این اسلاید کمی قدیمی است». SlideOps با تبدیل اسلایدها به یک مصنوع ساخت (Build Artifact) — شبیه به فایل‌های اجرایی که پس از کامپایل کد تولید می‌شوند — این مشکل را به‌طور ریشه‌ای حل می‌کند. در واقع، این ابزار اسناد را به گونه‌ای مدیریت می‌کند که بتوان آن‌ها را در عرض چند میلی‌ثانیه در برابر یک مخزن کد زنده تأیید کرد.

نگهداری دقت اسلایدهای فنی یکی از گلوگاه‌های شناخته‌شده در مهندسی نرم‌افزار است. طبق گزارش‌های منتشرشده، حتی اگر هوش مصنوعی زاینده (Generative AI) — مثل نویسنده‌ای که میلیاردها متن را خوانده و حالا سریعاً پیش‌نویس می‌زند — بتواند یک ارائه را سریع تولید کند، محتوا با تغییر کدها به‌سرعت منسوخ می‌شود. برای مثال، اسلایدی که می‌گوید پروژه دو مهاجرت دیتابیس دارد، ممکن است یک سال بعد که تعداد آن‌ها به ۱۰ رسیده، هنوز عدد «دو» را نشان دهد. SlideOps با ثبت دقیق اینکه هر اسلاید از کدام فایل منبع تولید شده، به‌جای بازسازی کل ارائه، فقط بخش‌های تغییریافته را به‌روز می‌کند.

بر اساس مستندات گیت‌هاب این پروژه، این ابزار به‌عنوان مجموعه‌ای از مهارت‌های عامل (Agent) برای Claude Code و سایر عامل‌های کدنویسی سازگار مانند Codex، Copilot CLI و OpenCode عمل می‌کند. هر چهار عامل، یک فایل SKILL.md را می‌خوانند و بنابراین نیازی به بازنویسی یا انتقال کدها بین این مدل‌های مختلف نیست.

کاربران می‌توانند با یک درخواست ساده مثل «برای این مخزن اسلاید بساز»، فرآیند را آغاز کنند. عامل ابتدا مخزن را اسکن کرده و سپس مجموعه‌ای از سوالات فشرده درباره موضوع (با پیشنهاد گزینه‌های مشخص و توجیه «چرا اکنون»)، مخاطب، تعداد اسلایدها، تم بصری و موارد اضافی می‌پرسد. همان‌طور که در تحلیل‌های قبلی ما درباره‌ی اکوسیستم عامل‌های کدنویس اشاره کردیم، این رویکرد تعاملی باعث می‌شود خروجی نهایی با نیاز کاربر همراستا باشد. در نهایت، کاربر پیش از تولید فایل HTML، یک طرح کلی (Outline) را تایید می‌کند. همچنین کاربران می‌توانند مرحله پرسش و پاسخ را رد کرده و مستقیماً دستوراتی مانند «بررسی عمیق زیرسیستم احراز هویت، تم Ledger Dark، ۱۵ اسلاید، همراه با PDF» را ارسال کنند.

اسلایدآپس: تبدیل مخزن گیت‌هاب به اسلایدشو با هشدار عدم‌همخوانی با کد

معماری فنی و قابلیت‌ها

این سامانه بر پایه یک مکانیزم بررسی تازگی (Freshness Check) بنا شده است. به نقل از مستندات فنی، یک اسکریپت پایتون در مسیر scripts/check.py پوشه docs/slides/ را بررسی می‌کند تا بفهمد کدام اسلایدها به کدهایی ارجاع می‌دهند که از زمان ساخت، تغییر کرده، جابه‌جا شده یا به‌کلی حذف شده‌اند. این فرآیند هیچ توکن (Token) — تکه‌های کوچکی از متن که مدل‌ها می‌خورند — یا مدل هوش مصنوعی و دسترسی به شبکه مصرف نمی‌کند و کاملاً بر اساس کتابخانه استاندارد پایتون در میلی‌ثانیه‌ها اجرا می‌شود. وقتی عدم تطابق شناسایی شود، عامل بر اساس وضعیت موارد، آن‌ها را دسته‌بندی کرده، موارد جابه‌جا شده را دوباره نقل می‌کند و ادعاهایی که دیگر صادق نیستند را علامت‌گذاری می‌کند. این روش باعث می‌شود فقط بخش‌های منسوخ شده تعمیر شوند و ریتم و روایت اصلی ارائه حفظ شود. این دقت در پیوند میان مستندات و کد، پاسخی به این چالش است که چگونه کدهای تولیدشده توسط هوش مصنوعی در نبود زیرساخت معماری فرو می‌پاشند و نیاز به نظارت مستمر دارند.

SlideOps مجموعه‌ای جامع از ۱۳ الگوی اسلاید را ارائه می‌دهد، از جمله:

  • قطعات کد حاشیه‌نویسی شده (در دو حالت عرض کامل و نیم‌عرض)
  • مقایسه‌های کد قبل و بعد
  • نمودارهای جریان (Flow Diagrams) و مقایسه‌های خطی (Lane Comparisons)
  • جداول مرجع و حباب‌های گفتگو
  • اسلایدهای عنوان، دستور جلسه (Agenda)، جداکننده‌های بخش، ترکیب متن و کارت‌ها، و تصویر به همراه کپشن

اسلایدپس: تبدیل مخزن گیت‌هاب به مجموعه اسلاید با هشدار عدم تطابق با کد

طراحی و تحویل

سفارشی‌سازی بصری از طریق یک بلوک توکن :root و با استفاده از تابع color-mix() انجام می‌شود. این قابلیت به کاربران اجازه می‌دهد بدون تغییر در ساختار نشانه‌گذاری (Markup)، بین تم‌هایی مثل Ledger Light (پیش‌فرض)، Ledger Dark، Midnight و Graphite جابه‌جا شوند. همچنین کاربران می‌توانند مقادیر CSS برند خود را روی این نقش‌های توکنی مپ کنند.

اسلایدآپس: تبدیل مخزن گیت‌هاب به مجموعه اسلاید با هشدار عدم‌همخوانی کد

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

هر ارائه یک فایل HTML مستقل و خودکفا است که بدون نیاز به مرحله ساخت (Build step)، بدون CDN و با قابلیت عملکرد کامل آفلاین ارائه می‌شود. ناوبری اسلایدها شامل کلیدهای جهت‌نما، کلیک برای پیشروی، لینک‌های عمیق مبتنی بر هش URL و یک شبکه نمای کلی (Overview grid) است که با کلید Esc فعال می‌شود. یادداشت‌های سخنران با کلید 'N' در دسترس هستند اما در خروجی‌های PDF یا اسکرین‌شات‌ها نامرئی می‌مانند. نمودارهای Mermaid نیز در زمان ساخت به SVGهای داخلی تبدیل شده و از طریق توکن‌های تم اسلاید استایل‌دهی می‌شوند تا هیچ وابستگی خارجی باقی نماند.

برای تضمین قابلیت اطمینان، ابزاری برای خروجی PDF تأییدشده تعبیه شده است. یک مهارت مکمل، PDF نهایی را دوباره به تصویر تبدیل می‌کند تا صفحات را بررسی کند؛ این کار برای جلوگیری از مشکل رایجی است که در آن PDF تعداد صفحات درست دارد اما حاوی تصاویر خالی است. این سطح از سخت‌گیری در خروجی، یادآور رویکرد بومی‌سازی تست‌ها در openleetcode است که برای تضمین صحت عملکرد از ابزارهای دقیق سیستمی بهره می‌برد.

این تغییر رویکرد به سمت «مستندسازی عملیاتی» (Ops-style)، فرض بنیادین درباره اسلایدها به عنوان دارایی‌های ایستا را تغییر می‌دهد. با متصل کردن محتوا به مخزن کد، SlideOps یک ارائه را به آینه‌ای زنده از کد تبدیل می‌کند. برای خواننده، این به معنای پایان سلب مسئولیت‌های شرم‌آور درباره «قدیمی بودن اسلاید» در طول بررسی‌های فنی است.

توسعه‌دهندگان اکنون می‌توانند این ابزار را در خط لوله‌های CI/CD خود ادغام کنند تا هر درخواست ادغام (Merge Request) که دقت یک اسلاید را به هم می‌زند، فوراً علامت‌گذاری شود. این یعنی اسلایدها از یک ابزار بازاریابی به یک مشخصات فنی قابل تایید تبدیل می‌شوند و در واقع یکی از لایه‌های ضروری برای تبدیل دموهای سریع به محصولات عملیاتی به شمار می‌روند.

گام بعدی شما

  • اگر از Claude Code استفاده می‌کنید، پلاگین را با دستور /plugin marketplace add glukicov/slideops و سپس /plugin install slideops@slideops نصب کنید.
  • متناوباً، می‌توانید مخزن را از گیت‌هاب کلون کرده (git clone https://github.com/glukicov/slideops) و اسکریپت ./install.sh را اجرا کنید. این پروژه تحت لایسنس MIT منتشر شده است.
  • اسلایدهای قدیمی خود را به فرمت HTML تبدیل کنید تا از مکانیزم بررسی تازگی بهره‌مند شوید.

اما داستان سخت‌افزاری این تحول حتی شگفت‌انگیزتر است — به تحلیل ما درباره‌ی تراشه‌های Blackwell مراجعه کنید.

چرا این موضوع مهم است؟

این ابزار با تکیه بر اعتبار مستندات فنی، خطای انسانی در ارائه‌های مهندسی را حذف می‌کند. تبدیل اسلاید به یک موجودیت قابل تست در CI/CD، استانداردهای گزارش‌دهی فنی را ارتقا می‌دهد.

تأثیر برای ایران

توسعه‌دهندگان ایرانی که در پروژه‌های Open Source یا تیم‌های نرم‌افزاری فعال‌اند، می‌توانند با نصب رایگان این ابزار (تحت لایسنس MIT)، هزینه‌ی به‌روزرسانی مستندات بصری خود را حذف کنند.

·نگاه ما
تحریریه دات‌هوش

جایگزینی اسلایدهای استاتیک با مصنوعات ساخت (Build Artifacts) نشان‌دهنده بلوغ رویکرد Infrastructure as Code در لایه مستندات است. این ابزار در واقع فاصله بین «کد» و «توضیح کد» را به صفر می‌رساند و مفهوم Documentation Drift را به چالش می‌کشد. به نظر ما، این اولین قدم به سوی ارائه‌هایی است که در لحظه نمایش، بر اساس آخرین کامیت (Commit) مخزن رندر می‌شوند.

منابع

این گزارش با خط‌لولهٔ خودکار دات‌هوش از منابع معتبر جهانی تدوین و زیر نظر تحریریه منتشر شده است. روش کار ما

گفتگو

پنج‌شنبه‌های هوش‌محور

بسته‌ی هفتگی دات‌هوش

۵ خبر، ۲ ابزار، ۱ پرامپت در هر شماره. به‌زودی راه‌اندازی می‌شود — هر پنج‌شنبه صبح.

خبر کلیدی
ابزار کاربردی
پرامپت حرفه‌ای
تحلیل پژوهش
به‌زودی
زاویه‌ی ایرانی
به‌زودی
تمرین این هفته
به‌زودی

راهنماهای دات‌هوش

راهنماهای کاربردیِ دات‌هوش برای کار با هوش مصنوعی — از همین‌جا شروع کنید:

دات‌هوش

راهنمای فارسی هوش مصنوعی — با نگاه به ایران

اخبار روزانه، معرفی ابزارها و مدل‌ها، و آموزشِ کار با هوش مصنوعی؛ همیشه با این پرسش که از ایران چه چیزی کار می‌کند و چه چیزی نه.