Hermes Agent дағдылары: өз дағдыңызды орнату және жасау

Дағды — агентке арналған сақталған нұсқау: тапсырманы қалай орындау керегін бір рет сипаттайсыз, содан кейін Hermes сіз /skill-name командасын шақырғанда, қайта-қайта түсіндіруді қажет етпей, сол нұсқауды қолданады. Дайын дағдыны бір командамен орнатуға болады, ал өз дағдыңызды екі тәсілмен жасай аласыз: SKILL.md файлын қолмен жазу немесе /learn командасын пайдалану.

Егер Hermes әлі орнатылмаған болса, алдымен бұл агенттің не екенін және оны қалай орнату керегін оқып, содан кейін дағдыларға өтіңіз.

Hermes Agent жүйесіндегі дағды дегеніміз не?#

Сіз агентке хабарламада сұрау мәтінін жазасыз. Ал дағды бөлек файлда сақталады, сондықтан Hermes сол нұсқауды кейінгі тапсырмаларда да қолдана алады. Агент атаулар мен сипаттамалардың тізімін көреді де, тапсырмаға сәйкес келген кезде дағдының толық мәтінін жүктейді. Бұл контекстегі орынды үнемдейді: барлық нұсқаулар бірден жүктелмейді.

Дағдының өзі агентке жаңа құралдар не қолжетімділік бермейді; ол бар құралдарды қалай қолдану керегін сипаттайды. Сыртқы қызметпен жаңа интеграция қажет болса, ол бөлек тақырып болып саналатын MCP арқылы іске асады. Тапсырмаға нақты бағдарламалық логика, арнайы рұқсат немесе оқиғалар ағынын өңдеу қажет болса, агент құралдары керек; мұндайда дағдының өзі жеткіліксіз.

Нұсқаулары сай келетін әрі дереккөзі тексерілген болса, стандартты тапсырма үшін дайын дағдыны таңдаңыз. Өзіңіздің әрекеттер ретін, шектеулеріңізді және шығыс пішімін сақтау қажет болса, дағдыны өзіңіз жазыңыз. Материалдарыңыз дайын болса немесе үдерісті аяқтап, файлды қолмен жазғыңыз келмесе, /learn командасын пайдаланыңыз.

Пішім ашық және Agent Skills спецификациясымен үйлесімді, сондықтан басқа каталогтардағы дағдылар әдетте Hermes жүйесінде пішімін өзгертуді қажет етпей жұмыс істейді. Алайда нақты бір дағдыға өз құралдары немесе кілттері қажет болуы мүмкін. Қаласаңыз, өз дағдыңызды басқалармен де бөлісе аласыз.

Қандай дағдылар орнатылған және олар қайда сақталады?#

Қалтаның құрылымы мынадай:

~/.hermes/skills/
├── research/
│   └── arxiv/
│       ├── SKILL.md
│       └── scripts/
├── productivity/
│   └── pdf/
│       ├── SKILL.md
│       └── references/
└── .hub/

Міндетті жалғыз файл — SKILL.md. Қалғанының бәрі қажетіне қарай қосылады: ауқымды материалдарға references/, көмекші бағдарламаларға scripts/, ал үлгілер мен файлдарға templates/ және assets/ қалталары қолданылады.

Кіріктірілген каталогта күнделікті тапсырмаларға арналған дағдылар бар: GIF табу, PDF файлдарымен, электрондық кестелермен, YouTube-пен, GitHub-пен және жазбалармен жұмыс істеу. Сипаттамалары бар толық тізім кіріктірілген дағдылар каталогы бетінде берілген. Әрбір hermes update командасы кезінде Hermes сіз енгізген өзгерістерді сақтай отырып, кіріктірілген дағдыларды да жаңартады.

Каталогтан дайын дағдыны қалай орнатуға болады?#

1. Каталогтан іздеу

   hermes skills search pdf
   

   Іздеу барлық қосылған дереккөздерден жүргізіледі. Сүзгісіз толық каталогты көру үшін hermes skills browse командасын орындаңыз.

2. Дағды карточкасын қарау

   hermes skills inspect skills-sh/anthropics/skills/pdf
   

   Карточкада сипаттама, дереккөз және сенімділік деңгейі көрсетіледі. Басқа біреудің дағдысын карточкасын оқымай орнатпаңыз.

3. Орнату

   hermes skills install skills-sh/anthropics/skills/pdf
   

   Hermes SKILL.md файлын және оған қосымша файлдарды жүктеп, қауіпсіздік тексеруін жүргізеді де, барлығын ~/.hermes/skills/ қалтасына орналастырады. Дағды бірден /pdf командасы ретінде қолжетімді болады. Егер дағдыға қосымша құралдар немесе кілттер керек болса, олар SKILL.md файлында көрсетіледі, ал Hermes орнату кезінде сізге хабарлайды.

Қауіпсіздік тексеруі деректерді сыртқа жіберу әрекеттерін, агентке енгізілген нұсқауларды және файлдарды жоюы немесе зақымдауы мүмкін командаларды іздейді. Дереккөздердің сенімділік деңгейлері әртүрлі:

Тексеру ескерту шығарса, --force жалаушасымен орнатуды жалғастыра аласыз, бірақ алдымен қандай қауіп анықталғанын оқып шығыңыз. «Қауіпті» деген қорытындыны айналып өту мүмкін емес. Тексерудің өзі қауіпсіздікке кепілдік бермейді: басқа біреудің дағдысын алғаш рет іске қоспас бұрын оның нұсқаулары мен қосымша командаларын оқып шығыңыз.

GitHub немесе сілтеме арқылы дағдыны қалай орнатуға болады?#

Орнатудың үш жолы бар:

# 1. GitHub репозиторийінен нақты бір дағдыны орнату (репозиторий ішіндегі жол оның атауынан кейін беріледі)
hermes skills install anthropics/skills/skills/pdf

# 2. Кез келген сайттағы SKILL.md файлына тікелей сілтеме (дағдыны чатта бөлісіңіз)
hermes skills install '<OFFICIAL_URL>'

# 3. Бүкіл репозиторийді дереккөз ретінде қосу (өз иеңіз бен репозиторийіңізді көрсетіңіз)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

Тікелей сілтеме берілсе, Hermes SKILL.md файлын және онда қызметтің ішкі қалталарынан аталған файлдарды ғана жүктейді; сайттағы қатысы жоқ файлдарды жүктемейді. Сілтеме дереккөз ретінде сақталады, сондықтан кейін hermes skills update командасы дағдыны сол мекенжайдан жаңарта алады.

GitHub-тан бөлек, сыртқы дағдылар каталогтарын да қосуға болады. Олардан дағдыларды сол hermes skills search командасымен тауып, дереккөзді көрсетуге болады.

Орнатқаннан кейін дағдыны қалай пайдалануға болады?#

hermes ... командаларын терминалда, ал /skill-name шақыруларын агентпен чатта (сол терминалда, веб-интерфейсте немесе мессенджерде) енгізіңіз:

/gif-search funny cats
/github-pr-workflow create a PR for the authorization rewrite

Егер тапсырмасыз /skill-name деп енгізсеңіз, Hermes нұсқауларды жүктеп, не істеу керегін сұрайды. Бір жолда беске дейін дағды шақыруға болады; қалған мәтін тапсырма ретінде беріледі:

/github-pr-workflow /test-driven-development close issue 123 and open a PR

Үнемі қолданатын тіркестерге Hermes терминологиясында bundle деп аталатын дағды топтамалары бар: hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development бірнеше дағдыны бір қысқа /backend-dev командасына біріктіреді. Мұндай топтама бүркеншік ат ретінде жұмыс істейді; оның ішіндегі дағдылар алдын ала орнатылуы керек.

Gateway қосылған болса, слэш-командалар Telegram-да да жұмыс істейді; баптау Hermes Agent-ті Telegram-ға қалай қосу керегін түсіндіретін нұсқаулықта берілген. Бұл — телефоннан дағдыларды іске қосудың ыңғайлы жолы.

Өз дағдыңызды қалай жасауға болады: SKILL.md файлына не жазылады?#

Осы дағдыны көшіріп алып, өзіңізге бейімдей аласыз:

---
name: weekly-review
description: Апталық шолу: не орындалды, не кідірді, келесі аптаның жоспары
version: 1.0.0
metadata:
  hermes:
    tags: [planning, review]
---

# Апталық шолу

## Қолдану уақыты
Пайдаланушы аптаны шолуды немесе келесі аптаға жоспар құруды сұрағанда.

## Рәсім
1. Пайдаланушы берген файлдан апталық тапсырмалар тізімін алыңыз немесе одан сұраңыз.
2. Тапсырмаларды үш топқа бөліңіз: орындалған, кідірген және жаңа.
3. Келесі аптаға арналған үш басымдықты атаңыз.

## Жиі қателер
- Бастапқы тізімде жоқ тапсырмаларды ойдан қоспаңыз.

## Тексеру
Пайдаланушыдан тапсырмалардың «орындалған», «кідірген» және «жаңа» топтарына дұрыс бөлінгенін растауын сұраңыз.

Үш сызықшаның арасындағы тақырып — метадеректер. Негізгі өрістер: name (латын әріптерімен, дефис арқылы бөлініп жазылады және дағдыны команда ретінде шақыруға қолданылады) және description. Агент ағымдағы тапсырмаға сәйкес келетін-келмейтінін және жүктелуі керегін анықтау үшін сипаттама өрісін пайдаланады. Сипаттама түсініксіз болса, дағды қажет кезде жүктелмеуі мүмкін.

Тақырыптан кейін нұсқаулар бөлімдері келеді. When to Use дағдыны қашан жүктеу керегін түсіндіреді. Procedure қадамдарды береді. Pitfalls агент жиі жіберетін қателерді және олардан қалай сақтану керегін сипаттайды. Verification нәтижені қалай тексеру керегін түсіндіреді. Нұсқаулар ұзақ болса, негізгі мазмұнды references/ ішіндегі файлдарға көшіріңіз; олар тек қажет болған кезде жүктеледі, ал көмекші бағдарламаларды scripts/ ішіне орналастырыңыз.

Егер дағдыға API кілті қажет болса, кілттің өзін файлға жазбай, тақырыпта required_environment_variables өрісін көрсетіңіз; тек айнымалының атауын жариялаңыз. Hermes жергілікті терминалда алғаш шақырғанда мәнді бір рет сұрайды, содан кейін оны автоматты түрде береді (мессенджерлерде кілтті жергілікті жерде баптауды ұсынады). platforms, config, blueprint және басқа өрістер Creating Skills ресми құжаттама бетінде сипатталған.

Файл дайын болғанда, мына қадамдарды орындаңыз:

1. Дағдының бумасын жасау

   mkdir -p ~/.hermes/skills/weekly-review
   

   Бума атауы тақырыптағы name өрісіне сәйкес келеді.

2. SKILL.md файлын сақтау

   Нұсқауларыңызды бума ішіндегі SKILL.md атты файлға сақтаңыз; жоғарыдағы мысалды алып, тапсырмаңызға сай қайта жаза аласыз.

3. Дағдыны шақырып, тексеру

   /weekly-review деп енгізіп, агенттен аптаңызды шолуды сұраңыз. Егер ол нұсқауларыңыздағы қадамдарды орындаса, дағды дұрыс жұмыс істейді.

Бар материалдардан /learn көмегімен дағдыны қалай жасауға болады?#

/learn құжаттама: ~/projects/example-docs ішіндегі демонстрациялық API, әсіресе аутентификация бөлімі
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn жаңа ғана сайтты хостингке қалай жариялағаным

Егер агентпен күрделі үдерісті жаңа ғана аяқтасаңыз, барлық қадам әлі әңгімеде тұрғанда оны дағды ретінде сақтауды /learn командасынан сұраңыз. Келесі жолы Hermes дайын нұсқауларды пайдаланып, осы рәсімді қайталайды.

Кітап, спецификация немесе құжаттар архиві сияқты үлкен дереккөзді бір файлға сыйғызу мүмкін емес. Hermes тақырыптар картасы бар ықшам SKILL.md файлын жасап, егжей-тегжейлерді references/ ішіне көшіреді. Агент сұраққа жауап беру үшін оларды жүктегенге дейін бұл файлдар контекстегі орынды алмайды. Бір тақырып бойынша /learn командасын қайта шақырсаңыз, ол қайталама файл жасамай, бар дағдыны толықтырады.

Дағдының жұмыс істейтінін қалай тексеруге болады?#

hermes chat --toolsets skills -q "аптама шолу жаса, weekly-review дағдысын пайдаланып: орындалды - есеп пен қоңыраулар, кідірді - хостинг төлемі"

Бұл — құжаттамада ұсынылған тексеру тәсілі: дағдыны іске қосып, агенттің нұсқауларды орындайтынын тексеріңіз. Олай болмаса, үш ықтимал себепті қараңыз. Біріншіден, бума атауы немесе тақырыптағы name мәні шақыратын атаумен сәйкес келмеуі мүмкін. Екіншіден, сипаттамада дағдыны қашан қолдану керегі анық жазылмауы мүмкін; оны тапсырманың өзінде кездесетін сөздермен қайта жазыңыз. Үшіншіден, бума ~/.hermes/skills/ ішінде болмауы мүмкін, сондықтан Hermes оны көрмейді. --toolsets skills жалаушасы тексеру үшін қолжетімді құралдар жиынын шектейтінін ескеріңіз: ол агенттің нұсқаумен хэр жұмыс істейтінін көрсетеді, бірақ сыртқы бағдарламалар сияқты дағдының тәуелділіктерін тексермейді.

Терминалда орындалған hermes skills list командасы орнатылған дағдыларды дәл көрсетеді.

Дағдыларды қалай жаңартып, жоюға болады?#

hermes skills check      # дереккөздерде не өзгерді
hermes skills update     # жаңа нұсқаларды жүктеу
hermes skills uninstall pdf   # дағдыны hub-тен жою

Қолмен жасаған дағдыны жою үшін ~/.hermes/skills/ ішіндегі бумасын өшіріңіз. Басқа біреудің дағдысын өзгертсеңіз, update оны қозғамайды: Hermes хэштерді салыстырып, жұмысыңызды қайта жазып кетпеу үшін өзгертілген файлдарды өткізіп жібереді. Hub-тен алынған дағдының бастапқы нұсқасын қайтару үшін hermes skills update name --force, ал кіріктірілген дағды үшін hermes skills reset name --restore командасын қолданыңыз. Екі команда да өзгерістеріңіздің үстінен жазады, сондықтан алдымен өз нұсқаңызды сақтап қойыңыз.

Кіріктірілген дағдылар қажет болмаса және тізімді толтырып тұрса, hermes skills opt-out командасы оларды жаңартулар кезінде қосуды өшіреді. opt-out --remove командасы өзгертілмеген дағдыларды да жояды.

Дағды орнатылмаса немесе жұмыс істемесе не істеу керек?#

Hermes Git репозиторийінің ішіндегі .hermes/skills/ және .agents/skills/ қалталарынан дағдыларды табады. Оларды жүктемес бұрын репозиторийді сенімді деп белгілеу қажет: бұл файлдарда агент орындайтын нұсқаулар бар. Осыдан кейін репозиторийдегі дағдылар тек соның ішінде жұмыс істейді және дәл сондай қауіпсіздік тексеруінен өтеді. Репозиторийді сенімді деп бір рет белгілеу жеткілікті.

Алдымен не істеу керек?#

Осы тақырып бойынша келесі нұсқаулықтар: дағдыларды телефоннан шақыру үшін Hermes Agent-ті Telegram-ға қалай қосу керек және жоспарланған дағдылар қажет болса, агентті серверде тәулік бойы қалай іске қосу керек. Агент таңдап жүрсеңіз, OpenClaw немесе Hermes Agent салыстыруын қараңыз.