زمینهٔ مخزن

ایندکس، ignore، قوانین، مهارت‌ها و AGENTS.md چطور مشخص می‌کنند ایجنت چه می‌بیند.

زمینه، خود محصول است. ایجنت آن را با خواندن ساخت‌یافتهٔ فایل، grep/glob، ویرایش پچ‌محور و جستجوی معنایی/codebase روی ایندکس فضای کاری جمع می‌کند.

جستجو و ایندکس

ایبان ایندکس‌هایی نگه می‌دارد که پشتیبانی می‌کنند از:

  • جستجوی معنایی / codebase برای پرسش مفهومی
  • جستجوی متنی شبیه grep برای رشته و الگوی دقیق

اگر درخت خیلی عوض شد و نتایج کهنه به نظر می‌رسد، پوشه را دوباره باز کنید یا تازه کنید.

فایل‌های ignore

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

  • .eyebanignore برای حذف‌های مخصوص ایبان
  • الگوهای استاندارد .gitignore (در کنار ignore ایبان رعایت می‌شود)

ignoreهای داخلی معمولاً درخت‌های پرسر‌و‌صدا یا حساس مثل node_modules، فایل‌های .env و پوشه‌های رایج build / خروجی را پوشش می‌دهند. برای دارایی تولیدشده و vendor بزرگ، الگوی پروژه اضافه کنید.

قوانین (rules)

دستورهای پایدار را در .eyeban/rules/*.mdc بگذارید. قوانین سبک، محدودیت معماری و قراردادهای پروژه را برای اجرای ایجنت هدایت می‌کنند. وقتی کل تیم باید همان راهنما را داشته باشد، rules را در مخزن چک‌این کنید.

فایل‌های راهنمای قدیمی اختیاری که بعضی ویرایشگرها استفاده می‌کنند ممکن است در مخزن باشد؛ ترجیح دهید مسیرهای .eyeban/ منبع اصلی حقیقت باشند.

مهارت‌ها (skills)

مهارت‌ها زیر .eyeban/skills هستند و رویه‌های تکرارپذیر برای ایجنت را بسته‌بندی می‌کنند. متن skill را مشخص و قابل‌اجرا نگه دارید.

AGENTS.md

اگر AGENTS.md در ریشهٔ پروژه باشد، راهنمای سطح‌بالای مخصوص ایجنت را می‌دهد. آن را مستند تیمی بدانید، نه محل رازها.