اسکیل‌ها و ساب‌اجنت‌ها

اسکیل‌ها

اسکیل‌ها نقاط ورود نگارش‌اند. سه‌تا از یک منبع مستندات تولید می‌کنند و یکی آن را بازبینی می‌کند.

اسکیل	کارکرد
lore:figma-to-doc	تولید مستندات از فایل‌های طراحی Figma.
lore:brief-to-doc	تولید مستندات از بریف، PRD یا یوزر استوری.
lore:site-to-doc	مستندسازی یک محصول زنده با مشاهده‌ی آن در مرورگر.
lore:doc-reviewer	اعتبارسنجی مستندات در برابر تعریف انجام‌شدن.

ساب‌اجنت‌ها

ساب‌اجنت‌ها کارگرانی‌اند که اسکیل‌ها به آن‌ها واگذار می‌کنند. آن‌ها با انجام کار سنگین یا پرسروصدا در انزوا و بازگرداندن یک خلاصه‌ی فشرده، context جلسه‌ی اصلی را تمیز نگه می‌دارند.

ساب‌اجنت	نقش
lore:doc-validator	اعتبارسنج فقط-خواندنی که یک سند را در برابر تعریف انجام‌شدن ممیزی می‌کند و گزارش قبول یا رد می‌دهد. اسکیل‌های تولیدکننده آن را پیش از تحویل اجرا می‌کنند.
lore:figma-extractor	استخراج سنگین Figma، یعنی کامنت‌ها، حاشیه‌نویسی‌ها، فهرست فریم‌ها و تصاویر فریم، که به‌شکل یک خلاصه‌ی مقطّر بازگردانده می‌شود.
lore:site-explorer	کاوش سنگین سایت زنده، یعنی هدایت مرورگر، گرفتن اسکرین‌شات، و ثبت متن دقیق رابط کاربری، که به‌شکل یک خلاصه‌ی فشرده بازگردانده می‌شود.
lore:doc-reviser	یافته‌های اعتبارسنج را اعمال می‌کند. گزارش را مثل دستور کار شخص دیگری می‌گیرد و فقط فایل‌ها و بخش‌هایی را که هر یافته نام برده ویرایش می‌کند: همه‌ی یافته‌های یک دور به‌صورت یک دسته، هر بار یک مورد دقیق. توان واکشی ندارد و نمی‌تواند فایل بسازد، پس تنها نقصی که نمی‌تواند وارد کند، منبع ساختگی است. اصلاحی که نتواند دقیقاً اعمال کند، چون شواهد نقضش می‌کند یا باید جایی را دست بزند که یافته نامش را نبرده، به‌جای حدس‌زدن اعمال‌نشده برمی‌گردد.

چرا بازنویس همان نویسنده نیست

بازنویسی یک صفحه در همان نشستی که آن را نوشته، همان‌جایی است که مستندات بی‌صدا خراب می‌شود. بازنویس وجود دارد تا عاملی که ادعا را تولید کرده، تصمیم‌گیرنده‌ی تغییر آن نباشد، و تا اصلاح‌های یک دور با هم اعمال شوند نه یکی‌یکی. یافته‌ها بر اساس جنسشان مسیردهی می‌شوند: اصلاح متن به بازنویس، رسید جامانده به جمع‌آوری منابع (بازنویسی که نمی‌تواند واکشی کند هرگز نباید آن را «حل» کند)، و هر چیزی که تصمیم محصولی می‌خواهد به شما.

اگر دو دور پیاپی همچنان نقص‌هایی پیدا کنند که دور قبل ایجاد کرده، اجرا می‌ایستد و از شما می‌پرسد، به‌جای بازکردن دور سوم.

چطور کنار هم می‌نشینند

یک اسکیل تولیدکننده یک اجرا را هماهنگ می‌کند: منابع را جمع می‌کند (استخراج یا مرور سنگین را به یک ساب‌اجنت کارگر واگذار می‌کند)، مستندات را می‌نویسد، و سپس lore:doc-validator را فرامی‌خواند تا پیش از تحویل در برابر تعریف انجام‌شدن خودبررسی کند. اگر آن بازبینی مسدود کند، یافته‌ها به‌صورت یک دسته به lore:doc-reviser می‌روند و دقیقاً همان فایل‌هایی که ویرایش کرده دوباره بازبینی می‌شوند. هوک‌های کنترلی مستقل از این، روی همه‌چیز اجرا می‌شوند و نقض قواعد را به‌صورت قطعی هنگام نوشتن فایل‌ها می‌گیرند.