Ụdị faịlụ
SKILL.md bụ ederede UTF-8. Ọ na-amalite site n'ahịrị nwere hyphen atọ, wee frontmatter YAML, wee ahịrị mmechi nwere hyphen atọ. Ihe niile na-esote ya bụ ahụ: ntuziaka Markdown onye ọrụ na-anata mgbe o bulitere nka ahụ. Nebo na-achọta faịlụ ahụ site n'aha ya n'eleghị mkpụrụedemede ukwu ma ọ bụ nta anya.
---
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 ... Mpaghara frontmatter
Ọ bụ naanị name na description ka a chọrọ. Mpaghara nwere ụdị na-ezighị ezi na-eme ka faịlụ ahụ dum daa, ya mere nka ahụ anaghị ebulite. A na-eleghara igodo na-adịghị ebe a anya.
| Mpaghara | Ụdị | Ndabara | Ihe ọ pụtara |
|---|---|---|---|
name | string | a chọrọ ya | Njirimara. [a-z0-9-], enweghị hyphen na mmalite, na njedebe ma ọ bụ hyphen abụọ, ọ karịghị bytes 64. Mee ka o dabara n'aha folda ahụ. |
description | string | a chọrọ ya | Ihe nka ahụ na-eme na mgbe a ga-eji ya. Ọ karịghị bytes 1,024. A na-egosi ya na ndepụta nka onye ọrụ ma find_skills na-enye ya akara. |
version | string | "1.0.0" | Ụdị semantic. Oke requires nke nka ndị ọzọ na-enyocha ya. Tinye ya n'ime akara nkwuputa. |
triggers | ndepụta eriri okwu | [] | Okwu na nkebi ahịrịokwu na-akọwa mgbe nka ahụ dabara. Ruo atọ na-apụta na ndepụta nka; ha niile na-agụ na find_skills. Ha anaghị ebulite nka n'onwe ha. |
platform | ndepụta eriri okwu | niile | macos, linux, windows. Nka ahụ na-ebulite naanị ebe otu dabara. |
capabilities | ndepụta eriri okwu | [] | network na storage na-agbasa sandbox script. Lee Sandbox script. |
metadata | map | {} | Na-ejide secrets na allowed_domains. Lee n'okpuru. |
requires | ndepụta {name, version} | [] | Nka ndị ọzọ nka a na-ewulite na ha. name bụ aha mkpirikpi nka ahụ; version bụ oke semver, ndabara "*". |
plugins | ndepụta {name, version, optional} | [] | Plugin nka a na-eji. version na-adị "*" site na ndabara, optional na-adị false. |
dependencies | ndepụta eriri okwu | [] | Aha mkpirikpi nke nka ndị ga-adịrịrị. |
priority | integer | 0 | Na-ahazi usoro nka na ndepụta njikwa. Ọ naghị emetụta nka onye ọrụ na-ahọrọ. |
author | string | "" | A na-echekwa ya maka ngosi. |
license | string | "" | A na-echekwa ya maka ngosi. |
compatibility | string | "" | Ndetu ederede efu, ọ karịghị bytes 500. |
tags | ndepụta eriri okwu | [] | A na-echekwa ya maka ngosi. |
allowed-tools | string | "" | Eriri okwu e ji oghere kewaa. A na-echekwa ya; a naghị amanye ya. |
Mgbe nka a kpọrọ aha na requires ma ọ bụ dependencies na-efu ma ọ bụ nọ n'èzí oke ahụ, ma ọ bụ e wụnyeghị plugin a chọrọ, nka ahụ ka na-ebulite ma e kaa ya akara dị ka nke na-ezughị oke. Onye nwe ya na-ahụ ihe na-efu.
Ihe nzuzo
Kwupụta nzere script nka chọrọ n'okpuru metadata.secrets. Onye nwe ya na-enye uru ndị ahụ, Nebo na-echekwakwa ha n'ezoro ezo maka nka ahụ.
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | Igodo | Ihe ọ pụtara |
|---|---|
key | Aha mgbanwe gburugburu script ahụ na-anata. A chọrọ ya. |
label | Aha a na-egosi onye nwe ya. |
hint | Ebe a ga-esi nweta uru ahụ. |
required | Mgbe ọ bụ true, execute na-ajụ ịgba script nka ahụ ruo mgbe e tinyere uru ahụ. Ndabara bụ false. |
Onye ọrụ na-edebe uru site na configure_skill. Ị nwere ike ịkpọ ihe nzuzo n'ime ahụ dịka ${secret.KEY}, mana script kwesịrị ịgụ environment variable kama.
Mgbanwe ndebiri
Nebo na-edochi mgbanwe ndị a n'ime ahụ mgbe onye ọrụ bulitere nka ahụ. A naghị edochi ha n'ime faịlụ ndị ọzọ; script na-agụ mgbanwe gburugburu kama.
| Mgbanwe | Uru |
|---|---|
${NEBO_SKILL_DIR} | Ụzọ zuru ezu nke folda nka ahụ. |
${NEBO_DATA_DIR} | Folda enwere ike ide ihe na ya maka nka a: <data>/appdata/skills/<name>. A na-emepụta ya mgbe mbụ e ji ya. |
${NEBO_USER_NAME} | Aha onye nwe ya. |
${NEBO_OS} | Sistemụ arụmọrụ. |
${NEBO_ARCH} | Ụkpụrụ processor. |
${plugin.SLUG_BIN} | Ụzọ binary nke plugin e kwupụtara. A na-ede slug ahụ na mkpụrụedemede ukwu, ebe hyphen ghọrọ underscore: example-ledger na-aghọ ${plugin.EXAMPLE_LEDGER_BIN}. |
${secret.KEY} | Uru nke ihe nzuzo e kwupụtara. |
$ARGUMENTS | args e nyefere use_skill. Mgbe ahụ ahụ enweghị $ARGUMENTS, a na-agbakwunye arụmụka ndị ahụ mgbe ya gachara. |
Ngwaọrụ nka
Ndị ọrụ na-eji ngwaọrụ ndị a arụ ọrụ na nka. use_skill na-adị mgbe niile; ndị ọzọ na-ebulite mgbe onye ọrụ chọrọ ha.
| Ngwaọrụ | Paramita | Ihe ọ na-eme |
|---|---|---|
use_skill | name, args | Na-ebulite nka. Na-eweghachi ahụ a gbasara agbasa, ụzọ folda, na aha faịlụ 20 mbụ. Na-agbanyeghachi nka a gbanyụrụ agbanyụ. |
find_skills | query | Na-eweghachi nka ruo 10 e debere n'usoro site n'ndakọrịta aha, ihe mkpalite na nkọwa. |
read_skill_file | name, path | Na-agụ faịlụ dị na folda nka ahụ. Na-enweghị path, ọ na-edepụta faịlụ ndị ahụ na nha ha. |
save_skill | name, content | Na-ede SKILL.md zuru ezu na folda nka onye ọrụ. Enweghị ike ide n'elu nka ahịa. |
delete_skill | name | Na-ehichapụ nka onye ọrụ. |
install_skill | code | Na-awụnye nka ahịa site na koodu nwụnye SKIL- ya. |
configure_skill | name, key, value | Na-etinye ihe nzuzo. Na-enweghị key, ọ na-egosi ihe nka ahụ chọrọ. |
rate_skill | name, rating, review | Na-enye nka ahịa akara site na 1 ruo 5. |
read_skill_reviews | name | Na-agụ nyocha nka ahịa. |
execute | skill, script, args, timeout | Na-agba script site na folda nka. Lee Sandbox script. |
Sandbox script
Ngwaọrụ execute na-agba otu script site na folda nka. Ọ na-ahọrọ runtime site na faịlụ ahụ.
| Script | Runtime |
|---|---|
.py | Python, site na uv e kechiri ọnụ na Nebo mgbe ọ dị, ma ọ bụghị ya python3. |
.ts, .js | Bun e kechiri ọnụ na Nebo mgbe ọ dị, ma ọ bụghị ya node. |
bin/<file> ma ọ bụ binary | Gbaa ya ozugbo. |
.sh | A naghị akwado ya. |
Ọgba ọ bụla na-amalite site na gburugburu efu na mgbanwe ndị a:
| Mgbanwe | Uru |
|---|---|
SKILL_ARGS | Ihe args dị ka JSON. |
key ihe nzuzo ọ bụla | Uru ihe nzuzo e mepere emepe. |
<PLUGIN>_BIN | Ụzọ binary nke plugin ọ bụla e kwupụtara. A na-agbakwunyekwa folda plugin na 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", []))})) Script ahụ na-agba n'otu oyiri nwa oge nke folda nka ahụ, nwere oge njedebe ndabara nke sekọnd 30. Na macOS na Linux, ọ na-agba n'ime sandbox sistemụ arụmọrụ:
- Ọ nweghị ike ịgụ ebe nchekwa nzere, data ihe nchọgharị na keychain, ma ọ bụ ntọala na ọdụ data nke Nebo n'onwe ya.
- Ọ nwere ike ide naanị na folda ọrụ ya na
/tmp/nebo. Ikikestoragena-agbakwunye folda data nke Nebo. - O nweghị ịnweta netwọk. Ikike
networkna-ekwe ndekọ ngwugwu na ngalaba e depụtara nametadata.allowed_domains.
Faịlụ na oke
| Ihe | Iwu |
|---|---|
| Akụrụngwa | Faịlụ ọ bụla ma e wepụ SKILL.md, manifest.json, signatures.json na dotfiles. |
| Ihe a na-agba | Faịlụ dị n'okpuru scripts/ ma ọ bụ bin/, na faịlụ mgbọrọgwụ a kpọrọ binary. |
| Ụzọ | Ọ dabere na folda nka ahụ. A na-ajụ ụzọ nwere .. ma ọ bụ ndị na-agbapụ n'èzí folda ahụ. |
| Nka a gbanyụrụ agbanyụ | Folda nwere SKILL.md.disabled kama SKILL.md. |
| Ndepụta nka | A na-ebipụ ndenye ọ bụla na mkpụrụedemede 250. Mgbe ndepụta ahụ dum karịrị mkpụrụedemede 8,000, a na-ebu ụzọ mee ka nka a na-ekerịta dị mkpụmkpụ; nka onye ọrụ n'onwe ya na-edebe ndenye ha zuru ezu. |
Oke maka faịlụ ị na-ebipụta n'ahịa dị na ibe Mbipụta.