Ìrísí fáìlì
SKILL.md jẹ́ ọ̀rọ̀ UTF-8. Ó ń bẹ̀rẹ̀ pẹ̀lú ìlà hyphen mẹ́ta, lẹ́yìn náà frontmatter YAML, lẹ́yìn náà ìlà ìparí hyphen mẹ́ta. Gbogbo ohun tí ó tẹ̀lé e ni ara rẹ̀: àwọn ìtọ́ni Markdown tí òṣìṣẹ́ náà ń gbà nígbà tí ó bá gbé ọgbọ́n náà wọlé. Nebo ń rí fáìlì náà nípa orúkọ láìka lẹ́tà ńlá tàbí kékeré sí.
---
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 ... Àwọn àyè frontmatter
name àti description nìkan ló pọn dandan. Àyè tí ó ní irú tí kò tọ́ ń mú kí gbogbo fáìlì kùnà, nítorí náà ọgbọ́n náà kò ní wọlé. A kò ka àwọn kọ́kọ́rọ́ tí a kò kọ síbí sí.
| Àyè | Irú | Àtilẹ̀wá | Ìtumọ̀ |
|---|---|---|---|
name | string | dandan | Àmì ìdánimọ̀. [a-z0-9-], kò sí hyphen ní ìbẹ̀rẹ̀, ní òpin tàbí méjì papọ̀, 64 bytes ó pọ̀jù. Bá orúkọ fódà mu. |
description | string | dandan | Ohun tí ọgbọ́n náà ń ṣe àti ìgbà tí a ó lò ó. 1,024 bytes ó pọ̀jù. A ń fi hàn nínú àkójọ ọgbọ́n òṣìṣẹ́ náà, find_skills sì ń fún un ní máàkì. |
version | string | "1.0.0" | Ẹ̀yà oní-ìtumọ̀. Àwọn ìwọ̀n requires ti àwọn ọgbọ́n mìíràn ń ṣàyẹ̀wò rẹ̀. Fi àmì ìtọ́ka yí i ká. |
triggers | àkójọ àwọn ọ̀rọ̀ (strings) | [] | Àwọn ọ̀rọ̀ àti gbólóhùn tí ń ṣàpèjúwe ìgbà tí ọgbọ́n náà wúlò. Títí dé mẹ́ta ń farahàn nínú àkójọ ọgbọ́n; gbogbo wọn ló ń kà nínú find_skills. Wọn kì í gbé ọgbọ́n wọlé fúnra wọn láé. |
platform | àkójọ àwọn ọ̀rọ̀ (strings) | gbogbo | macos, linux, windows. Ọgbọ́n náà ń wọlé níbi tí ọ̀kan bá ti bá a mu nìkan. |
capabilities | àkójọ àwọn ọ̀rọ̀ (strings) | [] | network àti storage ń fẹ àyè àdádó script lójú. Wo Àyè àdádó script. |
metadata | map | {} | Ó ní secrets àti allowed_domains. Wo nísàlẹ̀. |
requires | àkójọ {name, version} | [] | Àwọn ọgbọ́n mìíràn tí ọgbọ́n yìí kọ́ lé lórí. name ni orúkọ kúkúrú ọgbọ́n náà; version jẹ́ ìwọ̀n semver, àtilẹ̀wá "*". |
plugins | àkójọ {name, version, optional} | [] | Àwọn plugin tí ọgbọ́n yìí ń lò. version ń lọ sí "*" ní àtilẹ̀wá, optional sí false. |
dependencies | àkójọ àwọn ọ̀rọ̀ (strings) | [] | Orúkọ kúkúrú àwọn ọgbọ́n tí ó gbọ́dọ̀ wà. |
priority | integer | 0 | Ó ń to àwọn ọgbọ́n lẹ́sẹẹsẹ nínú àwọn àkójọ ìṣàkóso. Kò kan ọgbọ́n tí òṣìṣẹ́ kan ń yàn. |
author | string | "" | A ń tọ́jú rẹ̀ fún ìfihàn. |
license | string | "" | A ń tọ́jú rẹ̀ fún ìfihàn. |
compatibility | string | "" | Àkọsílẹ̀ ọ̀fẹ́, 500 bytes ó pọ̀jù. |
tags | àkójọ àwọn ọ̀rọ̀ (strings) | [] | A ń tọ́jú rẹ̀ fún ìfihàn. |
allowed-tools | string | "" | Ọ̀rọ̀ tí a fi àlàfo yà sọ́tọ̀. A ń tọ́jú rẹ̀; a kò fi múni. |
Nígbà tí ọgbọ́n tí a dárúkọ nínú requires tàbí dependencies kò bá sí tàbí tí ó wà níta ìwọ̀n náà, tàbí tí a kò fi plugin tí ó pọn dandan sórí ẹ̀rọ, ọgbọ́n náà ṣì ń wọlé, a sì sàmì sí i pé kò pé. Ẹni tó ni í ń rí ohun tí ó kù.
Àwọn àṣírí
Kéde àwọn ìwé ẹ̀rí tí àwọn script ọgbọ́n kan nílò lábẹ́ metadata.secrets. Ẹni tó ni í ń pèsè àwọn iye náà, Nebo sì ń tọ́jú wọn ní ìpàrokò fún ọgbọ́n náà.
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | Kọ́kọ́rọ́ | Ìtumọ̀ |
|---|---|
key | Orúkọ àyípadà àyíká tí script náà ń gbà. Ó pọn dandan. |
label | Orúkọ tí a ń fi hàn ẹni tó ni í. |
hint | Ibi tí a ti lè rí iye náà. |
required | Nígbà tí ó bá jẹ́ true, execute kò ní ṣiṣẹ́ àwọn script ọgbọ́n náà títí a ó fi ṣètò iye náà. Àtilẹ̀wá false. |
Òṣìṣẹ́ kan máa ń ṣètò iye kan pẹ̀lú configure_skill. O lè tọ́ka sí àṣírí kan nínú ara ìwé gẹ́gẹ́ bí ${secret.KEY}, ṣùgbọ́n ó yẹ kí àwọn ìwé-àfọwọ́kọ ka environment variable dípò.
Àwọn àyípadà àwòṣe
Nebo ń rọ́pò àwọn àyípadà wọ̀nyí nínú ara rẹ̀ nígbà tí òṣìṣẹ́ kan bá gbé ọgbọ́n náà wọlé. A kì í rọ́pò wọn nínú àwọn fáìlì mìíràn; àwọn script ń ka àwọn àyípadà àyíká dípò bẹ́ẹ̀.
| Àyípadà | Iye |
|---|---|
${NEBO_SKILL_DIR} | Ipa ọ̀nà pípé fódà ọgbọ́n náà. |
${NEBO_DATA_DIR} | Fódà tí a lè kọ sí fún ọgbọ́n yìí: <data>/appdata/skills/<name>. A ń ṣẹ̀dá rẹ̀ nígbà ìlò àkọ́kọ́. |
${NEBO_USER_NAME} | Orúkọ ẹni tó ni í. |
${NEBO_OS} | Ẹ̀rọ ìṣiṣẹ́ (operating system). |
${NEBO_ARCH} | Ìgbékalẹ̀ ẹ̀rọ ìṣiṣẹ́ (processor architecture). |
${plugin.SLUG_BIN} | Ipa ọ̀nà binary plugin tí a kéde. A ń kọ slug ní lẹ́tà ńlá, a sì ń fi underscore rọ́pò hyphen: example-ledger ń di ${plugin.EXAMPLE_LEDGER_BIN}. |
${secret.KEY} | Iye àṣírí tí a kéde. |
$ARGUMENTS | Àwọn args tí a fi ránṣẹ́ sí use_skill. Nígbà tí ara rẹ̀ kò bá ní $ARGUMENTS, a ń so àwọn àríyànjiyàn mọ́ ẹ̀yìn rẹ̀. |
Àwọn irinṣẹ́ ọgbọ́n
Àwọn òṣìṣẹ́ ń bá àwọn ọgbọ́n ṣiṣẹ́ nípasẹ̀ àwọn irinṣẹ́ wọ̀nyí. use_skill wà nígbà gbogbo; àwọn yòókù ń wọlé nígbà tí òṣìṣẹ́ kan bá nílò wọn.
| Irinṣẹ́ | Àwọn pàrámítà | Ohun tí ó ń ṣe |
|---|---|---|
use_skill | name, args | Ó ń gbé ọgbọ́n kan wọlé. Ó ń dá ara tí a ti fẹ̀ jáde padà, ipa ọ̀nà fódà, àti orúkọ fáìlì 20 àkọ́kọ́. Ó ń tan ọgbọ́n tí a ti pa padà. |
find_skills | query | Ó ń dá ọgbọ́n tí ó tó 10 padà, tí a tò lẹ́sẹẹsẹ nípa ìbámu orúkọ, ohun ìbẹ̀rẹ̀ àti àpèjúwe. |
read_skill_file | name, path | Ó ń ka fáìlì kan nínú fódà ọgbọ́n náà. Láìsí path, ó ń ṣe àkójọ àwọn fáìlì àti ìwọ̀n wọn. |
save_skill | name, content | Ó ń kọ SKILL.md pípé sínú fódà ọgbọ́n olùmúlò. A kò lè kọ lé àwọn ọgbọ́n ọjà lórí. |
delete_skill | name | Ó ń pa ọgbọ́n olùmúlò kan rẹ́. |
install_skill | code | Ó ń fi ọgbọ́n ọjà kan sórí ẹ̀rọ láti kóòdù ìfisórí SKIL- rẹ̀. |
configure_skill | name, key, value | Ó ń ṣètò àṣírí kan. Láìsí key, ó ń fi ohun tí ọgbọ́n náà nílò hàn. |
rate_skill | name, rating, review | Ó ń fún ọgbọ́n ọjà kan ní ìdíyelé láti 1 sí 5. |
read_skill_reviews | name | Ó ń ka àwọn àgbéyẹ̀wò ọgbọ́n ọjà kan. |
execute | skill, script, args, timeout | Ó ń ṣiṣẹ́ script kan láti inú fódà ọgbọ́n kan. Wo Àyè àdádó script. |
Àyè àdádó script
Irinṣẹ́ execute ń ṣiṣẹ́ script kan láti inú fódà ọgbọ́n kan. Ó ń yan runtime láti inú fáìlì náà.
| Script (àfọwọ́kọ àṣẹ) | Runtime (ẹ̀rọ ìṣiṣẹ́) |
|---|---|
.py | Python, nípasẹ̀ uv tí a dì pọ̀ mọ́ Nebo nígbà tí ó bá wà, bí bẹ́ẹ̀ kọ́ python3. |
.ts, .js | Bun tí a dì pọ̀ mọ́ Nebo nígbà tí ó bá wà, bí bẹ́ẹ̀ kọ́ node. |
bin/<file> tàbí binary | Ó ń ṣiṣẹ́ tààrà. |
.sh | A kò ṣàtìlẹ́yìn fún un. |
Ìṣiṣẹ́ kọ̀ọ̀kan ń bẹ̀rẹ̀ pẹ̀lú àyíká òfo àti àwọn àyípadà wọ̀nyí:
| Àyípadà | Iye |
|---|---|
SKILL_ARGS | Object args gẹ́gẹ́ bí JSON. |
key àṣírí kọ̀ọ̀kan | Iye àṣírí tí a ti tú ìpàrokò rẹ̀. |
<PLUGIN>_BIN | Ipa ọ̀nà binary plugin kọ̀ọ̀kan tí a kéde. A tún ń ṣàfikún àwọn fódà plugin sí 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 náà ń ṣiṣẹ́ nínú ẹ̀dà fódà ọgbọ́n náà fún ìgbà díẹ̀, pẹ̀lú àkókò ìdúró àtilẹ̀wá ìṣẹ́jú-àáyá 30. Lórí macOS àti Linux, ó ń ṣiṣẹ́ nínú àyè àdádó ẹ̀rọ ìṣiṣẹ́:
- Kò lè ka àwọn ibi ìpamọ́ ìwé ẹ̀rí, dátà aṣàwákiri àti keychain, tàbí ètò àti ibi ìpamọ́ dátà tirẹ̀ Nebo.
- Ó lè kọ sí fódà iṣẹ́ rẹ̀ àti
/tmp/nebonìkan. Agbárastorageń ṣàfikún fódà dátà Nebo. - Kò ní ìwọlé nẹ́tíwọ́ọ̀kì. Agbára
networkń gba àwọn ibi ìpamọ́ àpò àti àwọn domain tí a kọ sínúmetadata.allowed_domainsláàyè.
Àwọn fáìlì àti ààlà
| Ohun | Òfin |
|---|---|
| Àwọn ohun èlò | Gbogbo fáìlì yàtọ̀ sí SKILL.md, manifest.json, signatures.json àti dotfiles. |
| Àwọn ohun tí ó ṣeé ṣiṣẹ́ | Àwọn fáìlì lábẹ́ scripts/ tàbí bin/, àti fáìlì gbòǹgbò kan tí a ń pè ní binary. |
| Àwọn ipa ọ̀nà | Ní ìbámu pẹ̀lú fódà ọgbọ́n náà. A ń kọ àwọn ipa ọ̀nà tí ó ní .. tàbí tí ó sá jáde kúrò nínú fódà náà. |
| Ọgbọ́n tí a ti pa | Fódà tí ó ní SKILL.md.disabled dípò SKILL.md. |
| Àkójọ ọgbọ́n | A ń gé ìtọ́kasí kọ̀ọ̀kan ní ohun-kíkọ 250. Nígbà tí gbogbo àkójọ náà bá ju ohun-kíkọ 8,000 lọ, a ń kọ́kọ́ ké àwọn ọgbọ́n tí a ń pín kúrú; àwọn ọgbọ́n tirẹ̀ òṣìṣẹ́ kan ń wà ní kíkún. |
Àwọn ààlà fún àwọn fáìlì tí o tẹ̀jáde sí ọjà wà lójú ìwé Ìtẹ̀jáde.