learn

workflow را با `/learn` به skill تبدیل کنید؛ مسیریابی منبع از session، وب، و فایل را بشناسید.

با /learn می‌توانید workflow انجام‌شده را به یک skill قابل استفادهٔ مجدد تبدیل کنید. skillهای ساخته‌شده با /learn متعلق به شما هستند و در ~/.akvan/skills/ ذخیره می‌شوند.

Akvan می‌تواند skillها را از سه مسیر بسازد: ابزار skill_manage در کار معمولی، فرمان /learn (کاربر-محور)، و background review (خودکار). فقط skillهایی که background review می‌سازد به‌عنوان agent-created علامت می‌خورند. برای دیدن و اجرای skillها ← skills.

مسیریابی منبع

Akvan هر درخواست /learn را دسته‌بندی می‌کند و قوانین سخت‌گیرانه‌ای برای منبع داده اعمال می‌کند:

ورودی	منبع
`/learn` (بدون آرگومان)	فقط session جاری؛ اگر خالی باشد متوقف می‌شود
`/learn … همین الان انجام دادیم / این گفتگو`	پس از گفتگو یا انجام کار واقعی در session جاری
`/learn … from my last session`	`session_search` روی sessions قبلی
`/learn A/B testing` / موضوعات عمومی	`web_search` + `web_extract`
`/learn our deploy pipeline` / workflow پروژه	session جاری، سپس `session_search` اگر کم باشد
`/learn kubernetes` (مبهم)	می‌پرسد: session، وب، یا هر دو؟

برای اشاره به session قبلی، عبارت‌هایی مثل last session، previous conversation یا session قبلی را بنویسید. اگر عبارت فارسی تشخیص داده نشد، از معادل انگلیسی استفاده کنید.

نمونه‌ها:

text

/learn
/learn the workflow we just did
/learn deploy workflow from my last session
/learn A/B testing
/learn ~/project/scripts/deploy.sh
/learn https://docs.example.com/api

یادگیری از session قبلی

برای یادگیری workflow از گفتگوی قبلی:

/learn … from my last session به‌طور خودکار session_search را فراخوانی می‌کند.
روش جایگزین: /resume N و سپس /learn — transcript همان session به session جاری تبدیل می‌شود.
/learn بدون آرگومان sessions قدیمی را به‌طور خودکار جست‌وجو نمی‌کند.

جزئیات /sessions و /resume ← memory و sessions.

session خالی

/learn بدون آرگومان در یک session تازه و خالی به‌طور خودکار sessions قدیمی را جست‌وجو نمی‌کند. اگر هنوز گفتگویی در این session نبوده، ایجنت skill اختراع نمی‌کند و به شما پیشنهاد می‌دهد:

ابتدا کار را در همین گفتگو انجام دهید و دوباره /learn بزنید؛
با /resume یک session ذخیره‌شده را بارگذاری کنید؛
مسیر فایل یا URL را در /learn … بنویسید؛
بگویید «from my last session» تا گفتگوهای قبلی جست‌وجو شوند؛
یا یک موضوع عمومی بپرسید (مثلاً /learn A/B testing).

پیش‌نیازها و خطاها

/learn با اشاره به session قبلی به ~/.akvan/state.db و ابزار session_search نیاز دارد. اگر persistence فعال نباشد، CLI خطا می‌دهد — از /resume یا مسیر/URL استفاده کنید. جزئیات session persistence ← memory و sessions.
/learn برای موضوعات عمومی به web tools نیاز دارد (akvan tools). جزئیات ← مرجع تنظیمات.
برای موضوعات مبهم (مثل kubernetes یا docker)، ایجنت پیش از ساخت skill می‌پرسد منبع را از session، وب، یا هر دو بگیرد.

skillهای شخصی در ~/.akvan/skills/<category>/<name>/SKILL.md قرار می‌گیرند. skillهای پروژه با همین ساختار زیر project_root/.akvan/skills/ قرار می‌گیرند. اگر دو skill هم‌نام باشند، skill پروژه در اولویت است.

گزارش مشکل مستندات