skills

skills آماده را ببینید و اجرا کنید؛ skills شخصی و پروژه را بشناسید؛ sync و بازگردانی skills آماده را یاد بگیرید.

skill مجموعه‌ای از دستورالعمل‌های قابل استفادهٔ مجدد است. هنگام ساخت system prompt، Akvan لیست skillهای در دسترس را به مدل می‌دهد؛ متن کامل SKILL.md زمانی بارگذاری می‌شود که مدل ابزار skill_view را فراخوانی کند یا شما با slash command آن skill را فعال کنید.

دیدن skillها

داخل گفتگو اجرا کنید:

text

/skills

برای فعال کردن یک skill، نام آن را مانند یک slash command بنویسید:

text

/skill-name درخواست شما

یادگیری skillها

Akvan می‌تواند حافظهٔ رویه‌ای (procedural memory) را به‌مرور گسترش دهد:

روش	چگونه	ذخیره در
ابزار `skill_manage`	ایجنت در طول کار معمولی skill می‌سازد یا patch می‌کند	`~/.akvan/skills/`
`/learn …`	شما صریحاً درخواست یادگیری skill می‌دهید	`~/.akvan/skills/`
Background review	پس از هر چند نوبت، fork پس‌زمینه memory و skill را به‌روز می‌کند	memory + skillها

برای فرمان /learn، مسیریابی منبع، و یادگیری از session قبلی ← learn.

skillهای ساخته‌شده با /learn متعلق به شما هستند. فقط skillهایی که background review می‌سازد به‌عنوان agent-created علامت می‌خورند و در محدودهٔ akvan skills curator برای بایگانی قرار می‌گیرند.

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

همگام‌سازی skillهای آماده

skillهای آماده (bundled) skillهایی هستند که همراه Akvan نصب می‌شوند — مثل plan یا github-pr-workflow. هنگام نصب و به‌روزرسانی، Akvan آن‌ها را به ~/.akvan/skills/<category>/<name>/ کپی می‌کند. این فرایند با فایل ردیابی ~/.akvan/skills/.bundled_manifest ویرایش‌ها و حذف‌های شما را حفظ می‌کند.

skillهای ساخته‌شده با /learn یا skill_manage و skillهای پروژه در project_root/.akvan/skills/ جدا از این فرایند هستند؛ sync فقط skillهای آماده را مدیریت می‌کند.

akvan skills sync

برای همگام‌سازی دستی پس از به‌روزرسانی Akvan:

bash

akvan skills sync

برای هر skill آماده، یکی از این وضعیت‌ها گزارش می‌شود:

وضعیت	معنی
Added	skill جدید به `~/.akvan/skills/` اضافه شد
Updated	نسخهٔ جدید upstream جایگزین شد (فقط اگر ویرایش نکرده باشید)
Skipped	skill ویرایش یا حذف شده — دست‌نخورده ماند
Unchanged	هم‌اکنون با نسخهٔ bundled یکی است

فهرست زندهٔ skillهای در دسترس را با /skills داخل گفتگو ببینید. skillهای پروژه در project_root/.akvan/skills/ توسط sync دست‌نخورده می‌مانند.

بازگرداندن یک skill آماده

اگر یک skill آماده را ویرایش، حذف یا خراب کرده‌اید و می‌خواهید نسخهٔ اصلی Akvan را برگردانید:

bash

akvan skills reset plan --restore

plan نام skill است (مقدار name: در frontmatter)، نه مسیر پوشه.
پوشهٔ محلی حذف و از منبع bundled دوباره کپی می‌شود.
ویرایش‌های شما از بین می‌رود.

akvan skills reset NAME بدون --restore ردیابی manifest را پاک می‌کند و دوباره sync می‌زند؛ برای بازگردانی عمدی، --restore را توصیه می‌کنیم.

نمونهٔ skillهای آماده فعلی:

دسته	نام‌ها
creative	`architecture-diagram`، `claude-design`، `design-md`، `popular-web-designs`
github	`github-auth`، `github-code-review`، `github-pr-workflow`
software-development	`plan`، `spike`، `systematic-debugging`، `test-driven-development`

akvan skills curator restore skill متفاوتی است — برای بازگرداندن skillهای agent-created بایگانی‌شده، نه skillهای آماده. جزئیات فرمان‌های CLI ← مرجع CLI.

برای غیرفعال کردن کامل seeding skillهای آماده، فایل ~/.akvan/.no-bundled-skills بسازید؛ پس از آن akvan skills sync کاری انجام نمی‌دهد.

نکات امنیتی

فایل SKILL.md می‌تواند دستورالعمل‌های قابل اعتماد را در اختیار agent قرار دهد. محتوای skillهای ناشناس را پیش از استفاده بخوانید. Background review ممکن است skill جدید بسازد یا skillهای agent-created را تغییر دهد.

برای غیرفعال کردن این رفتار، مقدار زیر را در ~/.akvan/config.yaml (سراسری) یا project_root/config.yaml (مخصوص پروژه) قرار دهید:

yaml

skills:
  creation_nudge_interval: 0

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