NeboAI
NeboAI
Bẹ̀rẹ̀

Ìtọ́kasí SKILL.md

Ojú ìwé yìí ṣe àkójọ gbogbo apá ọgbọ́n kan tí Nebo ń kà: àwọn àyè frontmatter, àwọn àyípadà tí ó ń fẹ̀ jáde, àwọn irinṣẹ́ tí àwọn òṣìṣẹ́ ń lò láti bá àwọn ọgbọ́n ṣiṣẹ́, àti àyíká tí àwọn script ti ń ṣiṣẹ́.

Ì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ọ̀
namestringdandanÀ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.
descriptionstringdandanOhun 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ì.
versionstring"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)gbogbomacos, 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.
metadatamap{}Ó 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à.
priorityinteger0Ó ń to àwọn ọgbọ́n lẹ́sẹẹsẹ nínú àwọn àkójọ ìṣàkóso. Kò kan ọgbọ́n tí òṣìṣẹ́ kan ń yàn.
authorstring""A ń tọ́jú rẹ̀ fún ìfihàn.
licensestring""A ń tọ́jú rẹ̀ fún ìfihàn.
compatibilitystring""Àkọsílẹ̀ ọ̀fẹ́, 500 bytes ó pọ̀jù.
tagsàkójọ àwọn ọ̀rọ̀ (strings)[]A ń tọ́jú rẹ̀ fún ìfihàn.
allowed-toolsstring""Ọ̀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ọ̀
keyOrúkọ àyípadà àyíká tí script náà ń gbà. Ó pọn dandan.
labelOrúkọ tí a ń fi hàn ẹni tó ni í.
hintIbi tí a ti lè rí iye náà.
requiredNí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_skillname, 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_skillsqueryÓ ń 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_filename, 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_skillname, 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_skillnameÓ ń pa ọgbọ́n olùmúlò kan rẹ́.
install_skillcodeÓ ń fi ọgbọ́n ọjà kan sórí ẹ̀rọ láti kóòdù ìfisórí SKIL- rẹ̀.
configure_skillname, key, valueÓ ń ṣètò àṣírí kan. Láìsí key, ó ń fi ohun tí ọgbọ́n náà nílò hàn.
rate_skillname, rating, reviewÓ ń fún ọgbọ́n ọjà kan ní ìdíyelé láti 1 sí 5.
read_skill_reviewsnameÓ ń ka àwọn àgbéyẹ̀wò ọgbọ́n ọjà kan.
executeskill, 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ṣẹ́)
.pyPython, nípasẹ̀ uv tí a dì pọ̀ mọ́ Nebo nígbà tí ó bá wà, bí bẹ́ẹ̀ kọ́ python3.
.ts, .jsBun tí a dì pọ̀ mọ́ Nebo nígbà tí ó bá wà, bí bẹ́ẹ̀ kọ́ node.
bin/<file> tàbí binaryÓ ń ṣiṣẹ́ tààrà.
.shA 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_ARGSObject args gẹ́gẹ́ bí JSON.
key àṣírí kọ̀ọ̀kanIye àṣírí tí a ti tú ìpàrokò rẹ̀.
<PLUGIN>_BINIpa ọ̀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/nebo nìkan. Agbára storage ń ṣà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_domains láà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 paFódà tí ó ní SKILL.md.disabled dípò SKILL.md.
Àkójọ ọgbọ́nA ń 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.