آموزش مهارت unlazy و روش Depth Tree برای عاملهای هوشمند
با استفاده از مهارت unlazy و متد Depth Tree مانع از اعلام پایان زودهنگام کار توسط عامل شوید. این راهنما نحوه مدیریت فایلهای gates و قرارداد PLAN.md را شرح میدهد.
مهارت unlazy چه کاری انجام میدهد
مهارت unlazy یک مهارت عامل (agent skill) است که برای جلوگیری از یک خطای خاص ساخته شده است: عاملی که گزارش میدهد کار انجام شده است، در حالی که هنوز به پایان نرسیده است. هستهٔ این مهارت، Depth Tree است؛ روشی که یک وظیفه را بر اساس مرزهای واقعی آن تقسیم میکند و برای هر شاخه (leaf)، دروازههای پذیرش (acceptance gates) اختصاصی در نظر میگیرد. نسخه 2، اعمال این محدودیتها را از متن به فایلها منتقل کرد، بنابراین عامل باید بهجای ادعای انجام کار، تکمیل آن را با استفاده از فهرستی از دستورات قابلاجرا اثبات کند.
این مهارت توسط Leonxlnx در github.com/Leonxlnx/unlazy تحت مجوز MIT منتشر شده است. هیچ نسخه تگشدهای برای پین کردن وجود ندارد: تا تاریخ 2026-10-11، لیست تگها و نسخههای منتشرشده (releases) در مخزن خالی است. این راهنما ابتدا بر اساس milestone سورس 2.0.0 مورخ 2026-08-10 نوشته شده است. در تاریخ 2026-10-11، ما آن را با سورس فعلی در شاخه main بازبینی کردیم. فایل CHANGELOG این سورس را "Unreleased, target 2.1.0" نامگذاری کرده و ذکر میکند که هیچ تگ Git یا GitHub Release برای 2.1.0 ادعا نمیکند. اجرای دستور نصب در حال حاضر، سورس جدیدتر را دریافت میکند، نه نسخه 2.0.0 را. مهارتها در این حوزه بهسرعت تغییر میکنند، بنابراین پیش از کپی کردن هر بخشی از این راهنما در یک محیط عملیاتی، حتماً فایل CHANGELOG مخزن را مطالعه کنید.
منظور از مهارت در اینجا همان مفهوم معمول است: یک فایل SKILL.md که harness آن را در context مدل بارگذاری میکند، زمانی که وظیفه با توضیحات آن مطابقت داشته باشد. اگر این مکانیزم برای شما جدید است، با مهارت عامل چیست و harness چگونه آن را بارگذاری میکند شروع کنید. unlazy شامل فایلهای markdown ساده به همراه چند اسکریپت Node است، بنابراین به هیچ سرور یا API key اختصاصی نیاز ندارد.
چرا ایجنتها در 80 درصد متوقف شده و دستور سوم شما را نادیده میگیرند
این رفتار الگوی قابلتشخیصی دارد. شما چهار مورد را درخواست میکنید. پاسخ شامل مورد اول، دوم و چهارم است. خلاصهٔ پایانی، هر چهار مورد را بهعنوان تکمیلشده فهرست میکند. هیچ خطایی رخ نداده است، بنابراین هیچ هشداری صادر نمیشود و شما یک هفته بعد متوجه این شکاف میشوید.
فایل README پروژه unlazy این موضوع را بر اساس پژوهشهای منتشرشده درباره تنبلی مدلها تبیین میکند. این فایل به arXiv 2512.20662 استناد میکند که نشان میدهد «پرامپتهای چندبخشیِ مفصل، همچنان در مدلهای آزمایششده با عدم رعایت کامل و قطع زودهنگام مواجه میشوند». مستندات مربوط به gateها، پیشفرض طراحی را بهصراحت بیان میکند: «قوانین بالا متن (prose) هستند و متن همان لایهای است که این پروژه از پیش آن را ضعیفترین بخش میداند.» دستور دادن به یک ایجنت برای «تلاش بیشتر»، صرفاً متن بیشتری است که به همان متنی اضافه میشود که باعث بروز این نقص شده است.
به همین دلیل است که نسخه 2 وضعیت خود را در فایلها نگه میدارد. یک چکباکس در GATES.md خارج از حوزه اختیار مدل قرار دارد. یا شواهدی زیر آن gate وجود دارد یا وجود ندارد، و یک اسکریپت میتواند بدون پرسش از ایجنت، این موضوع را به شما بگوید.
درخت عمق، لایه به لایه
درخت عمق (Depth Tree) نوعی تجزیه است که قانونی برای محل مجاز تقسیمبندیها دارد. طبق مرجع این روش:
فقط در مرزهای واقعی دامنه، مؤلفه یا اعتبارسنجی تقسیم کنید. تقسیمهای دودویی اختیاری هستند.
لایه 1 را وظیفهٔ درخواستی قرار دهید.
برگها حامل خروجیهای نهایی (deliverables) هستند. هر لایه بالاتر از آنها، آنچه فرزندانش بازمیگردانند را یکپارچه و اعتبارسنجی میکند.
یک برگ بزرگتر از یک نکتهٔ فهرستوار است. مرجع، اندازهٔ آن را بر اساس نتیجه تعیین میکند، نه زمان:
هر برگ را به یک خروجی منسجم تبدیل کنید.
برگهای کوچکِ مجاور را ادغام کنید؛ برگی که چندین نتیجهٔ مستقل را در خود پنهان کرده است، تقسیم کنید.
این قانون همان چیزی است که مانع از تبدیل شدن یک درخت عمیق به کارهای بیهوده میشود. اگر یک برگ حاوی عبارت «تغییر نام متغیر» باشد، در این آزمون مردود است و تقسیمبندیِ بالای آن، یک لایه بیش از حد پیش رفته است.
سپس هر برگ چهار مرحله را طی میکند: پیادهسازی کامل بدون هیچ جایگذاری (placeholder)، بازخوانی به شیوهای که یک متخصص دامنه انجام میدهد، جستجو برای یافتن نقصها، و در نهایت صیقلکاری در جایی که هزینهٔ کمی دارد؛ این کار تا زمانی تکرار میشود که یک دور بررسیِ کامل، هیچ ایرادی نیابد. این مراحل، دلیل دیگری برای ادغام برگهای بسیار کوچک هستند. انجام چهار مرحله برای تغییری که 2 دقیقه زمان میبرد، صرفاً نمایش است.
شما هنگام فراخوانی مهارت، عمق را انتخاب میکنید:
/unlazy tree 5 refactor the payment moduleزبان ساده نیز کارساز است، زیرا توصیف مهارت بهجای دستورات اسلش (slash command)، با نیت کاربر مطابقت پیدا میکند:
tree 3 build the landing page and do not stop until every gate is checkedنسخههای پیشین این راهنما، بازههای عمق را با تعداد برگ برای هر عمق مشخص میکردند. مرجع فعلی هیچ تعداد برگی را تعیین نمیکند و میگوید: «با عمق بهعنوان یک وعدهٔ ریاضی دربارهٔ تلاش یا توکنها برخورد نکنید.» تنها راهنمایی کیفی باقی مانده است: «برای یک قابلیت، جستجوی محدودِ باگ یا یک سند، از درخت کمعمق یا دفتر کل تکی (solo ledger) استفاده کنید.» درخت ارکسترهشده برای مواردی است که چندین خروجی منسجم از زمینههای تازه یا مالکیت مستقل بهره میبرند. درخت عمیقتر تنها زمانی توجیهپذیر است که شاخههای اضافی آن با مرزهای واقعی یکپارچهسازی مطابقت داشته باشند.
وقتی عمقی را تعیین نمیکنید، مرجع میگوید: «کوچکترین درختی را انتخاب کنید که تمام خروجیهای مستقل و نقاط یکپارچهسازی را نمایان کند.» وقتی عددی را نام میبرید که با کار تناسب ندارد، به عامل میگوید که بهجای پر کردنِ بیهوده، این عدم تطابق را اعلام کند: «اگر عمق درخواستی باعث ایجاد برگهای پرکننده (filler) میشود، عدم تطابق را بیان کنید و از نزدیکترین تجزیهٔ صادقانه استفاده کنید.» عمق، توصیفکنندهٔ کار است، بنابراین افزایش عددی آن، کیفیت را به همراه نمیآورد.
ساختار فایل gates چگونه است
پیش از شروع هر کاری، عامل (agent) معیارهای پذیرش را در یک فایل gates مینویسد. هر gate یک چکباکس است که دستوری در زیر آن قرار دارد.
# Gates: pricing section
- [ ] G1: three tiers render with real copy
CHECK: node check.js pricing --tiers
EXPECT: 3/3 tiers ok
EVIDENCE: pending
- [ ] G2: annual toggle changes both price and label
CHECK: node check.js pricing --toggle
EXPECT: toggle ok
EVIDENCE: pendingCHECK همان دستور است. EXPECT خروجی مورد انتظاری است که به منزله قبولی (pass) تلقی میشود؛ همچنین برای قبولی، دستور باید با کد خروج 0 پایان یابد. EVIDENCE از pending شروع میشود. پس از یک اجرای موفق، بررسیکننده (checker) آن را با یک اثر انگشت (fingerprint) از خروجی پر میکند، نه با متن خام خروجی. یک gate دستی دستوری ندارد، بنابراین برای آن باید کوچکترین واقعیتی که نتیجه را اثبات میکند ثبت کنید. این ابزار با scripts/gate-check.mjs عرضه میشود تا این کار را انجام دهد. با --status، ابزار گزارش میدهد که کدام gateها هنوز باز هستند، بدون اینکه دستوری اجرا کند یا فایلی را تغییر دهد؛ بنابراین میتوانید بدون خواندن متن کامل گزارش (transcript)، یک اجرا را بازرسی کنید. این ابزار فقط زمانی دستورات ledger را اجرا میکند که شما --approve را پاس کنید، بنابراین پیش از تأیید، هر دستور و هر اسکریپتی که فراخوانی میشود را مطالعه کنید. یک scripts/gate-lint.mjs جداگانه، کیفیت یک ledger را بدون اجرای هیچ چیزی بررسی میکند.
قانون گزارشدهی در SKILL.md در یک خط خلاصه میشود:
تا زمانی که هر gate الزامی، برآوردهنشده، رهاشده، معوق یا در انتظار تصمیم مالک باقی مانده است، گزارش نهایی (done report) تهیه نکنید.
در کنار آن، به عامل گفته میشود که «هر عدد و ادعای تکمیل کار را دقیقاً پیش از گزارشدهی، مجدداً اندازهگیری کن.» یک gate نمیتواند صرفاً به این دلیل که عامل احساس میکند کار تمام شده است، بسته شود. بستن آن مستلزم اجرایی است که خروجیاش با EXPECT مطابقت داشته باشد یا نداشته باشد.
gateها را بهگونهای بنویسید که یک غریبه بتواند آنها را اجرا کند. «به نظر خوب میرسد» یک بررسی نیست. test -s dist/index.html && echo ok که ok را چاپ میکند یک بررسی است، زیرا در صورت خالی بودن یا نبودن فایل، با صدای بلند شکست میخورد.
قرارداد PLAN.md، پیش از هرگونه کار موازی
هنگامی که یک درخت به اندازهای گسترده میشود که برگها در زمینههای (context) جداگانه اجرا میشوند، آن برگها دیگر فرضهای مشترک نخواهند داشت. ارجاع به متد، قراردادی را پیش از انشعاب (fan-out) قرار میدهد: «قراردادها را پیش از انشعاب اصلاح کنید.» این طرح تمام خروجیهای مورد نیاز را در PLAN.md فهرست میکند، «سپس رابطها، فرمتها، فرضهای مشترک، قراردادهای خطا، نامگذاری و مالکیت را پیش از شروع کار یک برگ، ثبت کنید.»
دلیل این امر ملموس است. به دو زیرعامل (subagent) گفته میشود که «مدیریت خطا را اضافه کنند»؛ آنها دو ساختار خطای متفاوت ابداع خواهند کرد و هر دو برگ از دروازههای خود عبور میکنند، زیرا هر کدام بهصورت محلی صحیح هستند. شکست تنها در نقطهای ظاهر میشود که آنها به هم میرسند. آن نقطهٔ تلاقی، وظیفهٔ لایهٔ بالادستی آنهاست و ارجاع به ارکستراسیون آن را اینگونه بیان میکند: «فرزندان را دوباره تأیید کنید، سپس رابط، تستهای سرتاسری (end-to-end) و تستهای رگرسیون را اجرا کنید.»
در حالت ارکسترهشده، به درایور گفته میشود که «به هر برگ فقط قرارداد مشترک، مالکیت و وابستگیهای دقیق آن، و دفتر کل (ledger) خودش را بده» و «تاریخچههای نامرتبط برگها را فاش نکن.» هر دفتر کل برگ، مسیرهایی را که مجاز به نوشتن در آنهاست اعلام میکند و آن مسیرهای OWNS نباید با هیچ برگ دیگری که همزمان ارسال شده است، همپوشانی داشته باشند. هنگامی که یک زیرعامل بازمیگردد، درایور باید «دروازههای اجرایی برگ بازگشته را دوباره اجرا کند، از جمله دروازههایی که قبلاً بررسی شدهاند»، زیرا --status بهتنهایی به معنای تأیید مجدد نیست. برگی که جعبههای آن بدون شواهد واقعی تیک خورده باشند، از آن اجرای مجدد جان سالم به در نمیبرد.
ارکستراسیون یک کف (حداقل) دارد. ارجاع به ارکستراسیون میگوید: «زمانی که یک زمینهٔ متمرکز میتواند وظیفه را بدون پنهان کردن خروجیهای مستقل پیادهسازی و تأیید کند، بهصورت انفرادی (solo) باقی بمانید.» هر زیرعامل باید درک خود از وظیفه را از صفر بازسازی کند، بنابراین در یک وظیفهٔ کوچک، هزینهٔ آن راهاندازی بیش از سودی است که توجه تازه به همراه میآورد.
چگونه skill مربوط به unlazy را نصب کنیم؟
مسیر پشتیبانیشده، استفاده از CLI مربوط به skills است:
npx skills add Leonxlnx/unlazyبرای نصب در سطح کاربر از -g و برای نصب روی تمامی agentهایی که CLI شناسایی میکند از --all استفاده کنید. این دستور هر آنچه که امروز در شاخه main قرار دارد را نصب میکند. هیچ نسخه (release) برچسبگذاریشدهای وجود ندارد، بنابراین README توصیه میکند اگر به نصبی نیاز دارید که تغییر نکند، آن را روی یک commit مشخص ثابت (pin) کنید.
نصب دستی از طریق clone کردن در دایرکتوری skills مربوط به agent شما انجام میشود:
git clone https://github.com/Leonxlnx/unlazy ~/.claude/skills/unlazygit clone https://github.com/Leonxlnx/unlazy ~/.codex/skills/unlazyسپس بررسی کنید که فایلها در جای درست قرار گرفته باشند:
ls ~/.claude/skills/unlazy/SKILL.mdچاپ شدن مسیر به این معناست که فایل روی دیسک موجود است. خروجی No such file or directory نشان میدهد که clone در جای دیگری انجام شده است؛ این اتفاق معمولاً زمانی رخ میدهد که دایرکتوری skills با نامی که تصور میکردید وجود نداشته و git یک دایرکتوری جدید ایجاد کرده است. به گفتههای agent نیز اکتفا نکنید. agentای که میگوید skill نصب شده، لزوماً فایل را به شما نشان نداده است. ابزار بررسی (checker) و hook اختیاری به Node 16 یا جدیدتر نیاز دارند و از هیچ پکیج runtime شخص ثالثی استفاده نمیکنند.
تا تاریخ 2026-10-11، فایل README دو محیط اجرا (harness) را مستند کرده است: Claude Code که در آن skill را با /unlazy فراخوانی میکنید، و Codex CLI که در آن از $unlazy استفاده میشود. هیچ مسیری برای محیطهای اجرایی فاقد skill loader مستند نشده است، بنابراین کپی کردن محتوای SKILL.md در فایل قوانین (rules file) ابزارهای دیگر، تستنشده است. اگر میخواهید بدانید چه چیزی باعث میشود یک SKILL.md بهطور قابلاطمینان بارگذاری شود، بخش نوشتن skill اختصاصی برای agent به بررسی frontmatter و تطبیق توضیحات میپردازد که تعیین میکنند آیا skill اصلاً اجرا میشود یا خیر.
آیا Stop hook خارج از Claude Code کار میکند؟
خیر، و این بخشی است که باید در مورد آن دقیق بود. تمام موارد ذکر شده در بالا دستورالعمل هستند و دستورالعملها ممکن است نادیده گرفته شوند. تنها بخش اعمال ساختاری، یک Stop hook است و Stop hookها قابلیتی مختص Claude Code هستند.
node <path-to-skill>/scripts/install-hooks.mjs # this project only (settings.local.json)
node <path-to-skill>/scripts/install-hooks.mjs --global # every project
node <path-to-skill>/scripts/install-hooks.mjs --uninstallیک Stop hook در لحظهای اجرا میشود که عامل (agent) تلاش میکند نوبت خود را پایان دهد. این hook دفتر کل (ledger) و وضعیت ارسال (dispatch) نشست فعلی را اسکن میکند و در صورت برآورده نشدن گیتها (gates)، از توقف جلوگیری میکند؛ بنابراین نوبت نمیتواند روی یک مورد بررسینشده پایان یابد. این hook بررسیها را انجام نمیدهد و هیچ فراخوانی مدلی توسط خودش ایجاد نمیکند. با این حال، رایگان نیست. در بخش ارجاع به اقتصاد توکن ذکر شده است که: "یک مسدودسازی باعث ادامه کار عامل میشود که مصرفکننده کار مدل است." برای مکانیزم کلی و سایر رویدادهایی که میتوانید به آنها متصل شوید، به نحوه عملکرد hookهای Claude Code در طول یک نوبت مراجعه کنید. فایل README از شما میخواهد که hook را فقط با رضایت کاربر نصب کنید. همچنین از شما میخواهد که .claude/settings.local.json، .unlazy/ و .unlazy-hook-state.json را در قوانین ignore خود نگه دارید.
این قابلیت دارای یک سوپاپ اطمینان است که اهمیت آن بیش از چیزی است که به نظر میرسد. اگر عامل در طول 6 توقف مسدودشدهٔ متوالی هیچ پیشرفتی در گیتها نداشته باشد، hook به جای به دام انداختن، آن را آزاد میکند؛ ویرایشهایی که فقط متادیتای فایل را تغییر میدهند، این شمارش را بازنشانی نمیکنند. یک خط ABANDON: <gate> <reason> نیز اجازه میدهد نشست پایان یابد، اما به عنوان یک تحویلدهی (handoff) قابل مشاهده و نه به عنوان یک اتمام کار. گیت رهاشده به عنوان یک نتیجه ناموفق گزارش میشود، نه به عنوان کار تکمیلشده. بدون این دو راه گریز، گیتی که در محیط شما غیرممکن باشد، تا زمانی که خودتان نشست را متوقف نکنید، توکنها را مصرف خواهد کرد.
در Codex یا هر ابزار مشابه دیگر، install-hooks.mjs جایی برای نصب ندارد، زیرا فقط فایلهای تنظیمات Claude را مینویسد. شما همچنان فایل گیتها و بررسیهای قابل اجرا را در اختیار دارید، اما هیچ مانع ساختاری وجود ندارد که مدل را از پایان دادن زودهنگام نوبت باز دارد. در آنجا، فایل گیتها سندی است که باید خودتان آن را مطالعه کنید.
unlazy یا ponytail: کدام را انتخاب میکنید؟
این دو مهارت در یک فصل ترند شدند و از نظر حجم کار در جهت مخالف هم حرکت میکنند، که باعث میشود بهراحتی با هم اشتباه گرفته شوند.
مهارت ponytail باعث میشود ایجنت مانند یک توسعهدهنده ارشد رفتار کند که اولین سوالش این است که آیا اصلاً نیازی به وجود این کد هست یا خیر. این مهارت دامنه پروژه (scope) را کاهش میدهد، استفاده از کتابخانههای استاندارد را ترجیح میدهد و حجم تغییرات (diff) را کوچک میکند. مهارت unlazy فرض را بر این میگذارد که دامنه پروژه از قبل توافق شده است و تلاش میکند تا زمانی که تمام بخشهای آن تکمیل و تأیید نشوند، کار را پیش ببرد.
بنابراین، انتخاب خود را بر اساس خطایی که در حال حاضر مشاهده میکنید انجام دهید. اگر ایجنت شما یک قابلیت کوچک را به یک فریمورک تبدیل میکند، شما به مهارت ponytail و پرسونای توسعهدهنده ارشد تنبل آن نیاز دارید. اگر ایجنت شما سومین مورد از یک درخواست چهار بخشی را ناتمام میگذارد و سپس اعلام موفقیت میکند، شما به unlazy نیاز دارید.
اجرای همزمان هر دو ممکن است و ترتیب آنها اهمیت دارد. ابتدا دامنه کار را با سوالات ponytail مشخص کنید، سپس دامنه توافقشده را به دروازههای unlazy بسپارید. اگر این کار را برعکس انجام دهید، درختی از شاخ و برگ برای کاری میسازید که ponytail آن را حذف میکرد، و سپس هزینه تلاش اضافی برای تمام آن بخشها را میپردازید. این ترتیببندی توصیه شخصی من است، نه یک ادغام مستند بین این دو پروژه.
هزینه عمق (depth) در یک ایجنت میزبانیشده روی VPS چقدر است؟
تلاش به معنای توکن است و روی یک VPS که ایجنت را با API key شخصی شما اجرا میکند، توکنها همان پول هستند. اینکه unlazy چقدر به هزینهها اضافه میکند، پرسشی است که پروژه اکنون از پاسخ دادن به آن با یک عدد مشخص خودداری میکند.
نسخههای پیشین این راهنما، ضرایب توکنهای خروجی و هزینهها را بر اساس مقایسه ششمرحلهای نویسندگان ترسیم کرده بودند. نویسندگان از آن زمان، این ارقام را پس گرفتهاند. فایل references/token-economy.md اکنون بیان میکند که پرامپتهای خام، ردپاها (traces)، خروجیها و سوابق امتیازدهی پشت آن ارقام در مخزن موجود نیستند، «بنابراین آن اعداد در اینجا قابل بازتولید نیستند» و میافزاید: «از آنها به عنوان تضمین محصول استفاده نکنید.» مرجع روششناسی فراتر میرود: «عمق را به عنوان یک وعده ریاضی درباره تلاش یا توکنها در نظر نگیرید.» ما اعداد را حذف کردیم تا ارقامی را که نویسندگانشان دیگر پای آنها نمیایستند، تکرار نکنیم.
آنچه مرجع همچنان درباره هزینه میگوید، جنبه راهبردی دارد. توصیه آغازین آن این است که «تأییدهای تکراری و قطعی را به دستورات (commands) منتقل کنید و زمینه (context) ارکستراسیون را محدود نگه دارید.» حالت Solo توکنهای خروجی اضافی را در یک زمینه واحد صرف میکند. حالت Orchestrated زمینههای جدیدی اضافه میکند و هر زمینه جدید پیش از انجام هر کار مفیدی، قرارداد و دفتر کل (ledger) خود را میخواند. این مرجع در هر دو جهت هشدار میدهد: «وظیفهای را که یک نشست متمرکز میتواند بهطور تمیز پیادهسازی و تأیید کند، ارکستره نکنید.» همچنین هشدار میدهد که برای جلوگیری از سربار subagent، کل build را در یک زمینه نگه ندارید، بهویژه زمانی که برگهها (leaves) و قراردادها شفاف هستند.
چهار تنظیمات زیر از این موضوع ناشی میشوند:
- کوچکترین عمقی را انتخاب کنید که برگههای آن واحدهای واقعی کار باشند، سپس متوقف شوید. عمقی که به آن نیاز ندارید، هزینهای است که نباید بپردازید.
- زمانی که یک نشست متمرکز میتواند وظیفه را بسازد و تأیید کند، در حالت Solo بمانید؛ زیرا هزینه راهاندازی subagent در آنجا بیشتر از بازدهی زمینه جدید است.
- اگر از Claude Code استفاده میکنید، قلاب (hook) Stop را نصب کنید. این قلاب خود هیچ فراخوانی مدلی انجام نمیدهد، اما هر بلوک، ایجنت را به کار بازمیگرداند و آن کار مشمول هزینه است.
- پیش از شروع هر کار طولانی، یک سقف هزینه سخت (hard spend ceiling) در سطح حساب کاربری خود تعیین کنید.
نکته آخر، صادقانهترین مورد است. مهارتی که برای مقاومت در برابر توقفهای زودهنگام طراحی شده، ذاتاً مهارتی است که به کار کردن ادامه میدهد. بودجهبندی و هشداردهی، وظیفهای جدا از پرامپتنویسی هستند و کنترل هزینه ایجنت روی VPS سقفهایی را پوشش میدهد که ارزش دارد از همان ابتدا اعمال شوند.
آنچه نویسندگان اندازهگیری کردند و آنچه اثبات میشود
این مخزن قبلاً تست اختصاصی خود را منتشر میکرد که از آنچه باید باشد، نادرتر است. از آن زمان، این تست پس گرفته شده است که حتی نادرتر است. در README اکنون فقط آمده است که «نسخههای قبلی README به یک مقایسه داخلی ششمرحلهای اشاره داشتند» و «مستندات خام مورد نیاز برای بازتولید آن نسبتها و شمارشهای دقیق در این مخزن وجود ندارد». توصیه آن این است: «نتایج را به عنوان ورودی طراحی تاریخی در نظر بگیرید، نه به عنوان تضمین بنچمارک.»
این ساختار در research/validation-protocol.md باقی مانده است: دو وظیفه ساخت، هر کدام با سه وضعیت (بدون skill، درخت 3، درخت 6)، و یک پوشه و نشست تازه برای هر اجرا. این پروتکل آن را یک «مقایسه اکتشافی اجرا شده توسط نگهدارنده» مینامد. در آن ذکر شده که نسبتهای توکن، شمارش نقصهای خودیافته، خرابیهای زنده و خطاهای شماره گزارش تولید شده توسط آن، قابل بازتولید یا حسابرسی از طریق این مخزن نیستند. همچنین تأکید شده که این مقایسه نباید به عنوان اثباتی بر اینکه unlazy باعث بهبود خاص یا ضریب هزینه مشخصی میشود، توصیف گردد. نسخههای قبلی این راهنما، شمارشهای هر اجرا از آن تست را ترسیم کرده بودند. با عقبنشینی نویسندگان، ما آنها را حذف کردهایم.
یک درس طراحی از آن اعداد جان سالم به در برد. قانون «اندازهگیری مجدد هر عدد و ادعای تکمیل، بلافاصله پیش از گزارشدهی» همچنان در SKILL.md وجود دارد و قالب gates هشدار میدهد که یک عدد ارائهشده را به عنوان اثبات خود در EXPECT کپی نکنید. یک خلاصه مطمئن که بر روی یک ساخت خراب قرار گرفته، دقیقاً همان چیزی است که gates برای مقابله با آن طراحی شدهاند.
حال محدودیتها. تا تاریخ 2026-10-11 هیچ نتیجه منتشرشدهای برای ارزیابی باقی نمانده است، تنها روش و پروتکلی برای اجرای مجدد صحیح وجود دارد. آن را روی کار خود تست کنید: همان وظیفه را دو بار اجرا کنید، یک بار به صورت عادی و یک بار با یک فایل gates، سپس تعداد gatesهایی که با شواهدی که خودتان میتوانید بازتولید کنید بسته شدهاند را بشمارید. آن عدد، تنها عددی در این حوزه است که متعلق به شماست.
FAQ
درخت عمق (Depth Tree) در مهارت unlazy چیست؟
این یک روش تجزیه است. یک وظیفه تنها در مرزهای واقعی دامنه، مؤلفه یا اعتبارسنجی تقسیم میشود؛ لایه 1 همان وظیفه درخواستی است و هر برگ یک خروجی منسجم با دروازههای (gates) مخصوص به خود است. برگهای کوچک مجاور با هم ادغام میشوند و برگی که چندین نتیجه مستقل را در خود پنهان کرده باشد، دوباره تقسیم میشود. هر لایه بالاتر از برگها، یکپارچهسازی و اعتبارسنجی را انجام میدهد: فرزندان را دوباره بررسی میکند و سپس تستهای رابط، سرتاسری (end-to-end) و رگرسیون را اجرا میکند. شما هنگام فراخوانی، عمق را انتخاب میکنید، برای مثال tree 5. اگر عمقی تعیین نشود، این مهارت کوچکترین درختی را انتخاب میکند که تمام خروجیهای مستقل و نقاط یکپارچهسازی را آشکار سازد.
آیا مهارت unlazy خارج از Claude Code کار میکند؟
تا حدی. این مهارت به صورت markdown ساده است و فایل README علاوه بر Claude Code، ابزار Codex CLI را نیز مستند کرده است؛ بنابراین درخت عمق، فایل دروازهها، چکهای قابل اجرا و چهار مرحله برای هر برگ در آنجا کار میکنند. مستندات فعلی سایر محیطهای اجرا را پوشش نمیدهند. اعمال سختگیرانه (Hard enforcement) متفاوت است. قلاب Stop که پایان نوبت را در صورت عدم رعایت دروازهها مسدود میکند، یکی از ویژگیهای Claude Code است که با node <path-to-skill>/scripts/install-hooks.mjs نصب میشود. در هر جای دیگر، هیچ چیز ساختاری مانع از آن نمیشود که مدل نوبت خود را زودتر به پایان برساند، بنابراین شما کسی هستید که فایل دروازهها را میخوانید و آن را بازمیگردانید.
مهارت unlazy چقدر به هزینه توکن من اضافه میکند؟
امروز هیچکس نمیتواند رقم قابل اعتمادی به شما بدهد. نسبتهای توکن قبلی نویسندگان از شش اجرا به دست آمده که قابل بازتولید نیستند. مستندات فعلی میگویند از آنها به عنوان تضمین محصول استفاده نکنید و عمق را به عنوان یک وعده ریاضی درباره تلاش یا توکنها در نظر نگیرید. جهتگیری همچنان مشخص است. حالت Solo خروجی را در یک context واحد اضافه میکند. حالت Orchestrated یک context تازه برای هر برگ اضافه میکند که پیش از شروع کار، قرارداد و دفتر کل (ledger) آن را میخواند. قلاب Stop هیچ فراخوانی مدلی از طرف خود انجام نمیدهد، اما هر بلوک، عامل (agent) را برای کار بازمیگرداند. آن را در وظیفه خود و با توجه به صورتحساب خود اندازهگیری کنید.
آیا باید از unlazy استفاده کنم یا ponytail؟
مهارت را با خطایی که پیش رو دارید مطابقت دهید. ponytail برای عاملی است که بیش از حد مینویسد، زیرا نقش یک توسعهدهنده ارشد را بازی میکند که میپرسد آیا کد اصلاً نیاز به وجود دارد یا خیر و ابتدا به سراغ کتابخانه استاندارد میرود. unlazy برای عاملی است که بخش کمی از آنچه خواستهاید را به پایان میرساند، زیرا تجزیه را اجباری میکند و تا زمانی که مدرکی ارائه نشود، از بستن یک دروازه خودداری میکند. اگر هر دو را میخواهید، ابتدا محدوده (scope) را با ponytail مشخص کنید، سپس آن محدوده را به unlazy بسپارید تا هرگز برای کاری که باید حذف میشده، ضریب تلاش پرداخت نکنید.
چرا عامل من پس از نصب unlazy همچنان زود متوقف میشود؟
چهار مورد را بررسی کنید. اول، تأیید کنید که مهارت با ls ~/.claude/skills/unlazy/SKILL.md روی دیسک قرار دارد، زیرا کلون کردن در دایرکتوری که وجود نداشته، خطای رایجی است. دوم، تأیید کنید که فایل دروازهها پیش از شروع کار نوشته شده است، زیرا قلاب، دفتر کل نشست را اسکن میکند و نبود GATES.md باعث میشود چیزی برای مسدود کردن نداشته باشد. سوم، تأیید کنید که قلاب کجا نصب شده است: اجرای ساده install-hooks.mjs فقط در settings.local.json این پروژه مینویسد، بنابراین پروژه دیگر به --global نیاز دارد. چهارم، به یاد داشته باشید که دریچه اطمینان (release valve) طبق طراحی کار میکند. شش توقف مسدودشده متوالی بدون پیشرفت در دروازهها، عامل را آزاد میکند و یک خط ABANDON: <gate> <reason> عمداً تلاش را به عنوان یک تحویل قابل مشاهده که موفقیتآمیز نیست، پایان میدهد.