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

APX قوانین AGENTS.md را تنها هنگام عبور عامل از مرز پوشه بارگذاری می‌کند

·۱ آبان ۱۴۰۵۳ دقیقه مطالعه
راهنما
اشتراک‌گذاری
واقعاً چه چیز جدید است؟

نخستین رانتایم که AGENTS.md را به‌صورت لبه‌محور (edge-triggered) بارگذاری می‌کند، نه به‌صورت انبوه در آغاز جلسه. این تغییرِ ساختاری است، نه تنها یک بهینه‌سازی پرامپت.

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

عامل‌های هوش مصنوعی (agent) — هم‌مانند کارآموزی که تمام راهنمای شرکت را حفظ کرده اما برای هر تسک کوچک کل دفترچه را باز می‌کند — تا کنون مجبور بودند تمام قوانین پروژه را در یک پرامپت ریشه (root prompt) هضم کنند. همان‌طور که در تحلیل قبلی ما درباره‌ی مدیریت بستر در عامل‌های کدنگری اشاره کردیم، این رویکرد نسبت سیگنال به نویز را درست در لحظه دقت‌طلبی سقوط می‌دهد. به گزارش مستندات APX، اکثر مخازن هر قاعده‌ای را در پرامپت واحد می‌ریزند؛ قاعده‌ی اپلیکیشن موبایل یک ویرایش مستندات را شلوغ می‌کند و محدودیت استقرار یک تغییر فرانت‌اند را منحرف می‌سازد.

راه‌حل بستر را به دو لایه تقسیم می‌کند:

  • AGENTS.md ریشه: واقعاً حقایق مشترک — دستورات تست، ممنوعیت اعتبارنامه، گردش کار انتشار.
  • AGENTS.md تو در تو در هر زیرپوشه (api/، web/، infra/): دغدغه‌های بومی — ترتیب مهاجرت، قراردادهای کامپوننت، سوئیت تست مرورگر.
    یک قاعده تنها زمانی در یک پوشه جای دارد که حوزه‌ی آن واقعاً از آنجا آغاز شود.

APX این ساختار را عملیاتی می‌کند. در آغاز نوبت، فایل ریشه و نقشه‌ی زیرپوشه‌های دارای AGENTS.md فراهم می‌شود. وقتی ابزاری برای نخستین بار در یک پوشه فعال می‌شود، APX قوانین آن پوشه را به نتیجه الحاق می‌کند. عامل راهنمای بومی را دقیقاً در لحظه‌ای دریافت می‌کند که اثر کار به آن ناحیه رسیده است. طبق بررسی کد منبع، این مکانیزم بستر را یک مسئله‌ی مرزی می‌داند، نه یک مسئله‌ی حجمی.

تصور کنید درخواستی برای به‌روزرسانی تیتر لندینگ پیج داریم. عامل تنها با قوانین ریشه آغاز می‌کند — هیچ هشدار مهاجرت دیتابیس. بعداً، اگر همان تسک اسکیمای API را تغییر دهد، api/AGENTS.md به‌صورت خودکار بارگذاری می‌شود. بستر با مسیر واقعی کار رشد می‌کند، نه به‌صورت یک راهنمای بی‌فیلتر.

APC قرارداد قابل‌انتقال را تأمین می‌کند: فایل‌های AGENTS.md متعهد شده با مخزن سفر می‌کنند و بازبینی کد را می‌گذرند. APX رانتایم روزانه است که بستر مرتبط را انتخاب می‌کند در حالی که مکالمات و حالت خصوصی محلی باقی می‌مانند. این دو هم‌اکنون یک عادت ساده را پشتیبانی می‌کنند — قوانین ریشه برای کل پروژه، قوانین تو در تو برای مرزهای واقعی، و رانتایم راهنما را وقتی تسک خط را می‌گذرد آشکار می‌کند.

این رویکرد مدیریت بستر را از مهندسی پرامپت استاتیک به تشخیص دامنه پویا می‌کشاند. تیم‌ها دیگر حدس نمی‌زنند که کدام قانون را پیش‌بارگذاری کنند؛ ساختار پوشه خودِ دستورالعمل است. انحراف سیاست هم پیش‌گیری می‌شود: ممنوعیت راز در ریشه بماند، هشدار خرابکاری در کنار فیچر مربوطه بماند. حوزه کار مرزِ کار را پیروی می‌کند، نه میل نویسنده به کوتاه نگه داشتن فایل‌ها.

گام بعدی شما

  • یک AGENTS.md بومی در پوشه فیچر بعدی‌تان بسازید و ببینید APX آن را فقط هنگام ورود عامل بارگذاری می‌کند.
  • قوانین ریشه را به موارد واقعاً سراسری محدود کنید — تست، امنیت، انتشار.
  • برای مهاجرتی که ترتیب دقیق می‌خواهد، هشدار را در AGENTS.md همان ماژول قرار دهید، نه در پرامپت عمومی.
    این الگو تنها آغاز است؛ اثر آن بر هماهنگی چندعاملی در مخازن بزرگ را در گزارش آینده بررسی خواهیم کرد.
چرا این موضوع مهم است؟

این رویکرد هزینه استنتاج را با حذف توکن‌های بی‌ربط کاهش می‌دهد و دقت عامل را در تسک‌های مرزی بالا می‌برد — تجربه‌ی استقرار در مخازن تولیدی این را تأیید می‌کند. توسعه‌دهندگانِ فریم‌ورک عامل اکنون یک قرارداد قابل‌انتقال برای مدیریت بستر پویا دارند.

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

APX متن‌باز است و بدون API خارجی اجرا می‌شود؛ تیم‌های ایرانی می‌توانند بلافاصله در مخازن داخلی ادغام کنند. هزینه توکن کاهش‌یافته مستقیماً بر بودجه محاسبات تأثیر می‌گذارد. دسترسی بدون تحریم مزیت عملیاتی است.

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

APX نشان می‌دهد که «بستر هوشمند» به معنای بارگذاری همه‌چیز نیست، بلکه بارگذاریِ درست در موقع درست است. این الگو می‌تواند پایه‌ی پروتکل‌های جدید هماهنگی عامل-به‌عامل شود که در آن هر عامل تنها قوانین حوزه‌ی خود را می‌بیند. اگر استاندارد شود، پرامپت‌های ریشه‌ی انبوه جای خود را به قراردادهای مرزی مختصر می‌دهند.

منابع

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

گفتگو

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

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

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

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

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

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

دات‌هوش

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

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