Muundo wa faili
SKILL.md ni maandishi ya UTF-8. Huanza na mstari wa vistari vitatu, kisha frontmatter ya YAML, kisha mstari wa kufunga wa vistari vitatu. Kila kitu baada ya hapo ni kiini: maagizo ya Markdown ambayo mfanyakazi hupokea anapopakia ujuzi. Nebo hupata faili kwa jina bila kujali herufi kubwa au ndogo.
---
name: expense-review
description: Check submitted expenses against the company policy and flag anything that needs a receipt or an approval. Use when someone asks to review expenses or a reimbursement request.
version: "1.2.0"
author: Example Co
license: MIT
tags: [finance, expenses]
triggers: [reimbursement, expense report]
platform: [macos, linux, windows]
capabilities: [network]
metadata:
allowed_domains: [api.example.com]
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true
requires:
- name: receipt-capture
version: ">=1.0.0"
plugins:
- name: example-ledger
version: ">=2.0.0"
optional: true
---
# Expense review
Follow the policy in references/policy.md ... Sehemu za frontmatter
name na description pekee ndizo zinazohitajika. Sehemu yenye aina isiyo sahihi huharibu faili zima, kwa hiyo ujuzi haupakiwi. Funguo zisizoorodheshwa hapa hupuuzwa.
| Sehemu | Aina | Chaguo-msingi | Maana |
|---|---|---|---|
name | string | inahitajika | Kitambulisho. [a-z0-9-], bila kistari mwanzoni, mwishoni wala mara mbili, baiti 64 kwa zaidi. Lilinganishe na jina la folda. |
description | string | inahitajika | Ujuzi unafanya nini na wakati wa kuutumia. Baiti 1,024 kwa zaidi. Huonyeshwa katika orodha ya ujuzi ya mfanyakazi na hupimwa na find_skills. |
version | string | "1.0.0" | Toleo la kisemantiki. Hukaguliwa na masafa ya requires ya ujuzi mwingine. Liweke katika alama za nukuu. |
triggers | orodha ya maandishi | [] | Maneno na vifungu vinavyoeleza wakati ujuzi unatumika. Hadi vitatu huonekana kwenye orodha ya ujuzi; vyote huhesabiwa katika find_skills. Kamwe havipakii ujuzi vyenyewe. |
platform | orodha ya maandishi | yote | macos, linux, windows. Ujuzi hupakiwa tu pale moja inapolingana. |
capabilities | orodha ya maandishi | [] | network na storage hupanua sandbox ya hati. Tazama Sandbox ya hati. |
metadata | map | {} | Hushikilia secrets na allowed_domains. Tazama hapa chini. |
requires | orodha ya {name, version} | [] | Ujuzi mwingine ambao ujuzi huu hujengwa juu yake. name ni jina fupi la ujuzi; version ni masafa ya semver, chaguo-msingi "*". |
plugins | orodha ya {name, version, optional} | [] | Programu-jalizi ambazo ujuzi huu hutumia. version kwa chaguo-msingi ni "*", optional ni false. |
dependencies | orodha ya maandishi | [] | Majina mafupi ya ujuzi ambao lazima uwepo. |
priority | integer | 0 | Hupanga ujuzi katika orodha za usimamizi. Haiathiri ujuzi ambao mfanyakazi huchagua. |
author | string | "" | Huhifadhiwa kwa ajili ya kuonyeshwa. |
license | string | "" | Huhifadhiwa kwa ajili ya kuonyeshwa. |
compatibility | string | "" | Dokezo huria, baiti 500 kwa zaidi. |
tags | orodha ya maandishi | [] | Huhifadhiwa kwa ajili ya kuonyeshwa. |
allowed-tools | string | "" | Maandishi yaliyotenganishwa kwa nafasi. Huhifadhiwa; hayalazimishwi. |
Ujuzi uliotajwa katika requires au dependencies unapokosekana au kuwa nje ya masafa, au programu-jalizi inayohitajika haijasakinishwa, ujuzi bado hupakiwa na huwekwa alama ya kupungukiwa. Mmiliki huona kinachokosekana.
Siri
Tangaza vitambulisho ambavyo hati za ujuzi zinahitaji chini ya metadata.secrets. Mmiliki hutoa thamani, na Nebo huzihifadhi zikiwa zimesimbwa kwa ajili ya ujuzi huo.
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | Ufunguo | Maana |
|---|---|
key | Jina la kigezo cha mazingira ambacho hati hupokea. Inahitajika. |
label | Jina linaloonyeshwa kwa mmiliki. |
hint | Mahali pa kupata thamani. |
required | Ikiwa true, execute hukataa kuendesha hati za ujuzi hadi thamani iwekwe. Chaguo-msingi ni false. |
Mfanyakazi huweka thamani kwa configure_skill. Unaweza kurejelea siri katika maudhui kama ${secret.KEY}, ingawa hati za programu zinapaswa kusoma kigezo cha mazingira badala yake.
Vigezo vya violezo
Nebo hubadilisha vigezo hivi katika kiini mfanyakazi anapopakia ujuzi. Havibadilishwi ndani ya faili nyingine; hati husoma vigezo vya mazingira badala yake.
| Kigezo | Thamani |
|---|---|
${NEBO_SKILL_DIR} | Njia kamili ya folda ya ujuzi. |
${NEBO_DATA_DIR} | Folda inayoweza kuandikwa kwa ajili ya ujuzi huu: <data>/appdata/skills/<name>. Huundwa inapotumika mara ya kwanza. |
${NEBO_USER_NAME} | Jina la mmiliki. |
${NEBO_OS} | Mfumo wa uendeshaji. |
${NEBO_ARCH} | Usanifu wa kichakataji. |
${plugin.SLUG_BIN} | Njia ya faili tekelezi ya programu-jalizi iliyotangazwa. Slug huandikwa kwa herufi kubwa, na vistari vikiwa mistari ya chini: example-ledger huwa ${plugin.EXAMPLE_LEDGER_BIN}. |
${secret.KEY} | Thamani ya siri iliyotangazwa. |
$ARGUMENTS | args zinazopitishwa kwa use_skill. Kiini kisipokuwa na $ARGUMENTS, hoja huongezwa baada yake. |
Zana za ujuzi
Wafanyakazi hufanya kazi na ujuzi kupitia zana hizi. use_skill inapatikana kila mara; nyingine hupakiwa mfanyakazi anapozihitaji.
| Zana | Paramita | Inafanya nini |
|---|---|---|
use_skill | name, args | Hupakia ujuzi. Hurudisha kiini kilichopanuliwa, njia ya folda, na majina 20 ya kwanza ya faili. Huwasha upya ujuzi uliozimwa. |
find_skills | query | Hurudisha hadi ujuzi 10 uliopangwa kwa kulingana kwa jina, kichochezi na maelezo. |
read_skill_file | name, path | Husoma faili katika folda ya ujuzi. Bila path, huorodhesha faili na ukubwa wake. |
save_skill | name, content | Huandika SKILL.md kamili kwenye folda ya ujuzi wa mtumiaji. Ujuzi wa sokoni hauwezi kuandikwa juu yake. |
delete_skill | name | Hufuta ujuzi wa mtumiaji. |
install_skill | code | Husakinisha ujuzi wa sokoni kutoka kwa msimbo wake wa kusakinisha wa SKIL-. |
configure_skill | name, key, value | Huweka siri. Bila key, huonyesha kile ujuzi unahitaji. |
rate_skill | name, rating, review | Hukadiria ujuzi wa sokoni kutoka 1 hadi 5. |
read_skill_reviews | name | Husoma maoni ya ujuzi wa sokoni. |
execute | skill, script, args, timeout | Huendesha hati kutoka kwenye folda ya ujuzi. Tazama Sandbox ya hati. |
Sandbox ya hati
Zana ya execute huendesha hati moja kutoka kwenye folda ya ujuzi. Huchagua mazingira ya kuendesha kutokana na faili.
| Hati | Mazingira ya kuendesha |
|---|---|
.py | Python, kupitia uv iliyojumuishwa na Nebo ikiwepo, vinginevyo python3. |
.ts, .js | Bun iliyojumuishwa na Nebo ikiwepo, vinginevyo node. |
bin/<file> au binary | Huendeshwa moja kwa moja. |
.sh | Haitumiki. |
Kila uendeshaji huanza na mazingira matupu na vigezo hivi:
| Kigezo | Thamani |
|---|---|
SKILL_ARGS | Kitu cha args kama JSON. |
Kila key ya siri | Thamani ya siri iliyosimbuliwa. |
<PLUGIN>_BIN | Njia ya faili tekelezi ya kila programu-jalizi iliyotangazwa. Folda za programu-jalizi pia huongezwa kwenye PATH. |
import json, os
args = json.loads(os.environ.get("SKILL_ARGS", "{}"))
api_key = os.environ["EXAMPLE_API_KEY"]
print(json.dumps({"checked": len(args.get("items", []))})) Hati huendeshwa katika nakala ya muda ya folda ya ujuzi, na kikomo cha muda cha chaguo-msingi cha sekunde 30. Kwenye macOS na Linux huendeshwa ndani ya sandbox ya mfumo wa uendeshaji:
- Haiwezi kusoma hifadhi za vitambulisho, data ya kivinjari na keychain, wala mipangilio na hifadhidata ya Nebo yenyewe.
- Inaweza kuandika tu kwenye folda yake ya kazi na
/tmp/nebo. Uwezo wastoragehuongeza folda ya data ya Nebo. - Haina ufikiaji wa mtandao. Uwezo wa
networkhuruhusu sajili za vifurushi na vikoa vilivyoorodheshwa katikametadata.allowed_domains.
Faili na vikomo
| Kipengee | Kanuni |
|---|---|
| Rasilimali | Kila faili isipokuwa SKILL.md, manifest.json, signatures.json na faili zinazoanza kwa nukta. |
| Faili tekelezi | Faili zilizo chini ya scripts/ au bin/, na faili la mzizi linaloitwa binary. |
| Njia | Kulingana na folda ya ujuzi. Njia zenye .. au zinazotoka nje ya folda hukataliwa. |
| Ujuzi uliozimwa | Folda yenye SKILL.md.disabled badala ya SKILL.md. |
| Orodha ya ujuzi | Kila kipengee hukatwa kwenye herufi 250. Orodha nzima inapozidi herufi 8,000, ujuzi wa pamoja hufupishwa kwanza; ujuzi wa mfanyakazi mwenyewe huhifadhi vipengee vyake kamili. |
Vikomo vya faili unazochapisha sokoni viko kwenye ukurasa wa Kuchapisha.