Hermes Agent įgūdžiai: kaip įdiegti ir susikurti savo įgūdį

Įgūdis – tai išsaugota instrukcija agentui: vieną kartą aprašote, kaip atlikti užduotį, o vėliau Hermes ją taiko, kai iškviečiate /skill-name, ir nebereikia visko aiškinti iš naujo. Paruoštą įgūdį galima įdiegti viena komanda, o savą galite susikurti dviem būdais: parašyti SKILL.md rankiniu būdu arba naudoti /learn.

Jei dar neįdiegėte Hermes, pradėkite nuo vadovo kas yra šis agentas ir kaip jį įdiegti, o tada pereikite prie įgūdžių.

Kas yra Hermes Agent įgūdis?#

Agentui parašote promptą žinutėje. Įgūdis saugomas atskirame faile, o Hermes gali naudoti šią instrukciją atliekant būsimas užduotis. Agentas turi pavadinimų ir aprašymų sąrašą, o visą įgūdžio tekstą įkelia tada, kai jis aktualus užduočiai. Taip taupoma konteksto vieta: ne visos instrukcijos įkeliamos iš karto.

Pats įgūdis nesuteikia agentui naujų įrankių ar prieigos; jis aprašo, kaip naudoti jau turimus įrankius. Nauja integracija su išorine paslauga įgyvendinama per MCP – tai atskira tema. Jei užduočiai reikia tikslios programos logikos, specialaus leidimo ar įvykių srauto apdorojimo, reikia agento įrankių; vien įgūdžio nepakanka.

Standartinei užduočiai rinkitės paruoštą įgūdį, jei jo instrukcijos tinka ir patikrinote jo šaltinį. Susikurkite savą, kai reikia išsaugoti jums būdingą veiksmų seką, apribojimus ir išvesties formatą. Naudokite /learn, jei jau turite medžiagos arba baigėte procesą ir nenorite failo rašyti rankiniu būdu.

Formatas yra atviras ir suderinamas su Agent Skills specifikacija, todėl kitų katalogų įgūdžiai paprastai veikia Hermes sistemoje nekeičiant formato, nors konkrečiam įgūdžiui gali reikėti nuosavų įrankių ar raktų. Jei norite, galite pasidalyti ir savo įgūdžiu.

Kokie įgūdžiai jau įdiegti ir kur jie saugomi?#

Aplankas sutvarkytas taip:

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

SKILL.md yra vienintelis privalomas failas. Visa kita pridedama pagal poreikį: references/ ilgesnei medžiagai, scripts/ pagalbinėms programoms, o templates/ ir assets/ – šablonams ir failams.

Integruotame kataloge yra kasdienių užduočių įgūdžių: GIF paieškai, darbui su PDF, skaičiuoklėmis, YouTube, GitHub ir užrašais. Visą sąrašą su aprašymais rasite integruotų įgūdžių katalogo puslapyje. Kiekvieną kartą vykdant hermes update, Hermes atnaujina ir integruotus įgūdžius, išsaugodamas jūsų pakeitimus.

Kaip įdiegti paruoštą įgūdį iš katalogo?#

1. Ieškokite kataloge

   hermes skills search pdf
   

   Paieška vykdoma visuose prijungtuose šaltiniuose. Jei norite matyti visą katalogą be filtro, paleiskite hermes skills browse.

2. Peržiūrėkite įgūdžio kortelę

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

   Kortelėje rodomas aprašymas, šaltinis ir patikimumo lygis. Nediekite kito asmens įgūdžio neperskaitę jo kortelės.

3. Įdiekite jį

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

   Hermes atsisiunčia SKILL.md ir papildomus failus, atlieka saugumo patikrą ir viską įdeda į ~/.hermes/skills/. Įgūdį iškart galima naudoti kaip komandą /pdf. Jei įgūdžiui reikia papildomų įrankių ar raktų, jie nurodyti jo SKILL.md, o Hermes apie tai praneš diegiant.

Saugumo patikra ieško bandymų siųsti duomenis išorėn, agentui įterptų instrukcijų ir komandų, kurios galėtų ištrinti ar sugadinti failus. Šaltiniai turi skirtingus patikimumo lygius:

Jei patikra pateikia įspėjimą, diegimą galite tęsti naudodami vėliavėlę --force, tačiau pirmiausia perskaitykite, kokią riziką ji aptiko. Verdikto „dangerous“ apeiti negalima. Pati patikra negarantuoja saugumo: prieš pirmą kartą paleisdami kito asmens įgūdį perskaitykite jo instrukcijas ir papildomas komandas.

Kaip įdiegti įgūdį iš GitHub arba nuorodos?#

Trys diegimo būdai:

# 1. Konkretus įgūdis iš GitHub saugyklos (kelias saugyklos viduje nurodomas po jos pavadinimo)
hermes skills install anthropics/skills/skills/pdf

# 2. Tiesioginė nuoroda į SKILL.md bet kurioje svetainėje (pasidalykite šiuo įgūdžiu pokalbyje)
hermes skills install '<OFFICIAL_URL>'

# 3. Prijunkite visą saugyklą kaip šaltinį (pakeiskite savo savininku ir saugykla)
hermes skills tap add myorg/skills-repo
hermes skills install myorg/skills-repo/deploy-runbook

Naudodamas tiesioginę nuorodą, Hermes atsisiunčia SKILL.md ir tik tuos paslaugos poaplankiuose esančius failus, kurie jame nurodyti; nesusijusių svetainės failų jis neatsisiunčia. Nuoroda įsimenama kaip šaltinis, o vėliau hermes skills update atnaujins įgūdį iš to paties adreso.

Be GitHub, galima prijungti išorinius įgūdžių katalogus. Įgūdžių iš jų galite ieškoti ta pačia komanda hermes skills search, nurodydami šaltinį.

Kaip naudoti įgūdį jį įdiegus?#

hermes ... komandas įveskite terminale, o /skill-name iškvietimus – pokalbyje su agentu (tame pačiame terminale, žiniatinklio sąsajoje arba susirašinėjimo programoje):

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

Jei įvesite /skill-name nenurodę užduoties, Hermes įkels instrukcijas ir paklaus, ką norite, kad jis atliktų. Vienoje eilutėje galite iškviesti kelis įgūdžius, iki penkių; likęs tekstas taps užduotimi:

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

Dažnai naudojamiems deriniams yra įgūdžių paketai, Hermes terminologijoje vadinami bundles: komanda hermes bundles create backend-dev --skill github-pr-workflow --skill test-driven-development sugrupuoja kelis įgūdžius į vieną trumpą /backend-dev komandą. Toks paketas veikia kaip slapyvardis; jame esantys įgūdžiai turi būti įdiegti iš anksto.

Pasviruoju brūkšniu prasidedančios komandos veikia ir Telegram, jei prijungtas šliuzas; sąranka aprašyta vadove kaip prijungti Hermes Agent prie Telegram. Taip patogu paleisti įgūdžius telefonu.

Kaip susikurti įgūdį: ką įrašyti į SKILL.md?#

Galite nukopijuoti šį įgūdį ir pritaikyti sau:

---
name: weekly-review
description: Weekly review: what got done, what stalled, plan for next week
version: 1.0.0
metadata:
  hermes:
    tags: [planning, review]
---

# Weekly review

## When to Use
When the user asks to review the week or put together a plan for the next one.

## Procedure
1. Get the week's task list from the file the user provided, or ask them for it.
2. Sort the tasks into three groups: done, stalled, and new.
3. Name three priorities for the coming week.

## Pitfalls
- Don't invent tasks that aren't in the original list.

## Verification
Ask the user to confirm that the tasks are correctly sorted into “done,” “stalled,” and “new.”

Tarp trijų brūkšnių esanti antraštė yra metaduomenys. Pagrindiniai laukai yra name (rašomas lotyniškomis raidėmis, žodžiai atskiriami brūkšneliais ir naudojamas iškviesti įgūdį kaip komandą) ir description. Agentas naudoja aprašo lauką spręsdamas, ar įgūdis tinka dabartinei užduočiai ir ar jį reikia įkelti. Jei aprašas neaiškus, prireikus įgūdis gali būti neįkeltas.

Po antraštės eina instrukcijų skiltys. When to Use nurodo, kada įkelti įgūdį. Procedure pateikia veiksmus. Pitfalls aprašo, kur agentas dažnai klysta ir kaip to išvengti. Verification paaiškina, kaip patikrinti rezultatą. Jei instrukcijos ilgos, perkelkite pagrindinį turinį į failus aplanke references/; jie bus įkeliami tik tada, kai jų prireiks, o pagalbines programas sudėkite į scripts/.

Jei įgūdžiui reikia API rakto, nurodykite jį antraštėje naudodami required_environment_variables; paties rakto į failą nedėkite, nurodykite tik kintamojo pavadinimą. Hermes paprašys reikšmės vieną kartą – pirmą kartą iškvietus vietiniame terminale – o vėliau pateiks ją automatiškai (susirašinėjimo programose paragins raktą sukonfigūruoti vietoje). Laukai platforms, config, blueprint ir kiti aprašyti oficialios dokumentacijos puslapyje Creating Skills.

Kai failas paruoštas, atlikite šiuos veiksmus:

1. Sukurkite įgūdžio aplanką

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

   Aplanko pavadinimas sutampa su antraštės lauko name reikšme.

2. Išsaugokite SKILL.md

   Į aplanką įdėkite failą SKILL.md su savo instrukcijomis; galite naudoti pirmiau pateiktą pavyzdį ir perrašyti jį savo užduočiai.

3. Iškvieskite įgūdį ir patikrinkite jį

   Įveskite /weekly-review ir paprašykite agento apžvelgti jūsų savaitę. Jei jis laikosi instrukcijų žingsnių, įgūdis veikia.

Kaip sukurti įgūdį iš turimos medžiagos naudojant /learn?#

/learn dokumentacija apie demonstracinę API aplanke ~/projects/example-docs, ypač autentifikavimo skiltis
/learn https://hermes-agent.nousresearch.com/docs/user-guide/features/skills
/learn kaip ką tik paskelbiau svetainę prieglobos paslaugoje

Jei ką tik su agentu atlikote sudėtingą procesą, paprašykite /learn išsaugoti jį kaip įgūdį, kol visi veiksmai dar yra pokalbyje. Kitą kartą Hermes pakartos procesą pagal paruoštas instrukcijas.

Didelė šaltinio medžiaga, pavyzdžiui, knyga, specifikacija ar dokumentų archyvas, netilps į vieną failą. Hermes sukurs glaustą SKILL.md su temų žemėlapiu, o išsamią informaciją perkels į references/. Šie failai neužima konteksto vietos, kol agentas jų neįkelia atsakydamas į klausimą. Pakartotinai iškvietus /learn ta pačia tema, medžiaga bus pridėta prie esamo įgūdžio, o ne sukurtas jo dublikatas.

Kaip patikrinti, ar įgūdis veikia?#

hermes chat --toolsets skills -q "apžvelk mano savaitę naudodamas weekly-review įgūdį: atlikta – ataskaita ir skambučiai, įstrigo – mokėjimas už prieglobą"

Tai dokumentacijoje rekomenduojamas testas: paleiskite įgūdį ir patikrinkite, ar agentas laikosi jūsų instrukcijų. Jei nesilaiko, patikrinkite tris galimas priežastis. Pirma, aplanko pavadinimas arba antraštės name gali nesutapti su iškviečiamu pavadinimu. Antra, aprašas gali būti suformuluotas taip, kad neaišku, kada įgūdį naudoti; perrašykite aprašą vartodami pačios užduoties žodžius. Trečia, aplankas gali būti ne ~/.hermes/skills/, todėl Hermes jo nemato. Atminkite, kad vėliavėlė --toolsets skills apriboja testui prieinamų įrankių rinkinį: ji parodo, kaip agentas dirba su instrukcija, bet nepatikrina įgūdžio priklausomybių, pavyzdžiui, išorinių programų.

Komanda hermes skills list terminale tiksliai parodo, kas įdiegta.

Įgūdžiai yra DI klono dalis: tai būdas vieną kartą užfiksuoti, kaip atliekate užduotį, kad agentas galėtų ją pakartoti be priminimų. Derinys apima DI kloną + Antrąsias smegenis + Konteksto inžineriją. Jis padeda perduoti agentui jūsų darbo logiką ir užduoties kontekstą.

Kaip atnaujinti ir pašalinti įgūdžius?#

hermes skills check      # kas pasikeitė šaltiniuose
hermes skills update     # atsisiųsti naujas versijas
hermes skills uninstall pdf   # pašalinti įgūdį iš hub

Norėdami pašalinti rankiniu būdu sukurtą įgūdį, ištrinkite jo aplanką iš ~/.hermes/skills/. Jei pritaikėte kito asmens įgūdį, update jo nelies: Hermes palygina maišas ir praleidžia pakeistus failus, kad neperrašytų jūsų darbo. Norėdami atkurti pradinę hub įgūdžio versiją, naudokite hermes skills update name --force, o integruotam įgūdžiui – hermes skills reset name --restore. Abi komandos perrašo jūsų pakeitimus, todėl pirmiausia išsaugokite savo versiją.

Jei integruotų įgūdžių nereikia ir jie užgriozdina sąrašą, hermes skills opt-out išjungs jų pridėjimą atnaujinant. Komanda opt-out --remove taip pat pašalins tuos, kurių nepakeitėte.

Ką daryti, jei įgūdžio nepavyksta įdiegti arba jis neveikia?#

Hermes ieško įgūdžių git saugyklos aplankuose .hermes/skills/ ir .agents/skills/. Prieš juos įkeldami turite pažymėti saugyklą kaip patikimą: šiuose failuose yra instrukcijos, kurių agentas laikysis. Po to saugyklos įgūdžiai veikia tik joje ir pereina tą pačią saugumo patikrą. Saugyklą kaip patikimą pažymėti reikia tik vieną kartą.

Ką daryti pirmiausia?#

Toliau šia tema: kaip prijungti Hermes Agent prie Telegram, kad galėtumėte iškviesti įgūdžius telefonu, ir kaip užtikrinti, kad agentas serveryje veiktų visą parą, jei norite suplanuotų įgūdžių. Jei renkatės agentą, žr. palyginimą OpenClaw ar Hermes Agent.