የፋይል ቅርጸት
SKILL.md የUTF-8 ጽሑፍ ነው። በሦስት ሰረዞች መስመር ይጀምራል፣ ከዚያ የYAML የፊት ክፍል፣ ከዚያም የሚዘጋ የሦስት ሰረዞች መስመር ይመጣል። ከዚያ በኋላ ያለው ሁሉ አካሉ ነው፦ ሰራተኛው ክህሎቱን ሲጭን የሚቀበላቸው የMarkdown መመሪያዎች። Nebo ፋይሉን የፊደላትን ትልቅነት ወይም ትንሽነት ሳይለይ በስሙ ያገኘዋል።
---
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 ... የፊት ክፍል መስኮች
ግዴታ የሆኑት name እና description ብቻ ናቸው። የተሳሳተ ዓይነት ያለው መስክ ፋይሉን በሙሉ ያከሽፋል፣ ስለዚህ ክህሎቱ አይጫንም። እዚህ ያልተዘረዘሩ ቁልፎች ችላ ይባላሉ።
| መስክ | ዓይነት | ነባሪ | ትርጉም |
|---|---|---|---|
name | string | ግዴታ | መለያ። [a-z0-9-]፣ በመጀመሪያ ወይም በመጨረሻ ሰረዝ ወይም ድርብ ሰረዝ የሌለበት፣ ቢበዛ 64 ባይት። ከአቃፊው ስም ጋር ያዛምዱት። |
description | string | ግዴታ | ክህሎቱ ምን እንደሚሠራ እና መቼ ጥቅም ላይ እንደሚውል። ቢበዛ 1,024 ባይት። በሰራተኛው የክህሎት ዝርዝር ውስጥ ይታያል፣ በfind_skillsም ነጥብ ይሰጠዋል። |
version | string | "1.0.0" | ሴማንቲክ ስሪት። በሌሎች ክህሎቶች የrequires ክልሎች ይፈተሻል። በትዕምርተ ጥቅስ ውስጥ ያስቀምጡት። |
triggers | የሕብረቁምፊዎች ዝርዝር | [] | ክህሎቱ መቼ እንደሚያገለግል የሚገልጹ ቃላት እና ሐረጎች። እስከ ሦስቱ በክህሎት ዝርዝሩ ውስጥ ይታያሉ፤ ሁሉም በfind_skills ውስጥ ይቆጠራሉ። ክህሎትን በራሳቸው በጭራሽ አይጭኑም። |
platform | የሕብረቁምፊዎች ዝርዝር | ሁሉም | macos፣ linux፣ windows። ክህሎቱ የሚጫነው ከእነዚህ አንዱ በሚዛመድበት ቦታ ብቻ ነው። |
capabilities | የሕብረቁምፊዎች ዝርዝር | [] | network እና storage የስክሪፕት ሳንድቦክሱን ያሰፋሉ። የስክሪፕት ሳንድቦክስን ይመልከቱ። |
metadata | map | {} | secrets እና allowed_domainsን ይይዛል። ከታች ይመልከቱ። |
requires | የ{name, version} ዝርዝር | [] | ይህ ክህሎት የሚገነባባቸው ሌሎች ክህሎቶች። name የክህሎቱ አጭር ስም ነው፤ version የsemver ክልል ነው፣ ነባሪው "*"። |
plugins | የ{name, version, optional} ዝርዝር | [] | ይህ ክህሎት የሚጠቀምባቸው ተሰኪዎች። version በነባሪ "*"፣ optional ደግሞ false ነው። |
dependencies | የሕብረቁምፊዎች ዝርዝር | [] | መኖር ያለባቸው የክህሎቶች አጭር ስሞች። |
priority | integer | 0 | በአስተዳደር ዝርዝሮች ውስጥ የክህሎቶችን ቅደም ተከተል ይወስናል። ሰራተኛ የትኛውን ክህሎት እንደሚመርጥ አይነካም። |
author | string | "" | ለማሳያ ይቀመጣል። |
license | string | "" | ለማሳያ ይቀመጣል። |
compatibility | string | "" | ነጻ የጽሑፍ ማስታወሻ፣ ቢበዛ 500 ባይት። |
tags | የሕብረቁምፊዎች ዝርዝር | [] | ለማሳያ ይቀመጣል። |
allowed-tools | string | "" | በክፍተት የተለየ ሕብረቁምፊ። ይቀመጣል፤ አይተገበርም። |
በrequires ወይም በdependencies ውስጥ የተጠቀሰ ክህሎት ሲጎድል ወይም ከክልሉ ውጭ ሲሆን፣ ወይም የሚያስፈልግ ተሰኪ ካልተጫነ፣ ክህሎቱ አሁንም ይጫናል፣ ጉድለት ያለበት ተብሎም ምልክት ይደረግበታል። ባለቤቱ ምን እንደጎደለ ያያል።
ሚስጥሮች
የክህሎት ስክሪፕቶች የሚያስፈልጓቸውን የመግቢያ መረጃዎች በmetadata.secrets ስር ያሳውቁ። ባለቤቱ እሴቶቹን ያቀርባል፣ Nebo ደግሞ ለዚያ ክህሎት አመስጥሮ ያስቀምጣቸዋል።
metadata:
secrets:
- key: EXAMPLE_API_KEY
label: Example API key
hint: Create one at https://example.com/settings/keys
required: true | ቁልፍ | ትርጉም |
|---|---|
key | ስክሪፕቱ የሚቀበለው የአካባቢ ተለዋዋጭ ስም። ግዴታ። |
label | ለባለቤቱ የሚታይ ስም። |
hint | እሴቱን ከየት ማግኘት እንደሚቻል። |
required | true ሲሆን እሴቱ እስኪዘጋጅ ድረስ execute የክህሎቱን ስክሪፕቶች ለማሄድ እምቢ ይላል። ነባሪው false ነው። |
ሰራተኛ እሴትን በconfigure_skill ያስቀምጣል። በይዘቱ ውስጥ ሚስጥርን እንደ ${secret.KEY} ማጣቀስ ይችላሉ፣ ነገር ግን ስክሪፕቶች በምትኩ የአካባቢ ተለዋዋጩን ማንበብ አለባቸው።
የአብነት ተለዋዋጮች
ሰራተኛ ክህሎቱን ሲጭን Nebo እነዚህን ተለዋዋጮች በአካሉ ውስጥ ይተካል። በሌሎች ፋይሎች ውስጥ አይተኩም፤ ስክሪፕቶች በምትኩ የአካባቢ ተለዋዋጮችን ያነባሉ።
| ተለዋዋጭ | እሴት |
|---|---|
${NEBO_SKILL_DIR} | የክህሎቱ አቃፊ ሙሉ ዱካ። |
${NEBO_DATA_DIR} | ለዚህ ክህሎት ሊጻፍበት የሚችል አቃፊ፦ <data>/appdata/skills/<name>። በመጀመሪያ አጠቃቀም ጊዜ ይፈጠራል። |
${NEBO_USER_NAME} | የባለቤቱ ስም። |
${NEBO_OS} | ስርዓተ ክወናው። |
${NEBO_ARCH} | የፕሮሰሰሩ አርክቴክቸር። |
${plugin.SLUG_BIN} | የታወጀ ተሰኪ ባይነሪ ዱካ። slugው በትልቅ ፊደላት ይጻፋል፣ ሰረዞችም በታችኛው ሰረዝ ይተካሉ፦ example-ledger ${plugin.EXAMPLE_LEDGER_BIN} ይሆናል። |
${secret.KEY} | የታወጀ ሚስጥር እሴት። |
$ARGUMENTS | ለuse_skill የተላለፉት args። አካሉ $ARGUMENTS ከሌለው ነጋሪ እሴቶቹ ከአካሉ በኋላ ይታከላሉ። |
የክህሎት መሣሪያዎች
ሰራተኞች ከክህሎቶች ጋር የሚሠሩት በእነዚህ መሣሪያዎች ነው። use_skill ሁልጊዜ ይገኛል፤ ሌሎቹ ሰራተኛው ሲያስፈልገው ይጫናሉ።
| መሣሪያ | መለኪያዎች | ምን ያደርጋል |
|---|---|---|
use_skill | name, args | ክህሎትን ይጭናል። የተሰፋውን አካል፣ የአቃፊውን ዱካ እና የመጀመሪያዎቹን 20 የፋይል ስሞች ይመልሳል። የተሰናከለ ክህሎትን እንደገና ያነቃል። |
find_skills | query | በስም፣ በቀስቃሽ እና በመግለጫ ተዛማጅነት የተደረደሩ እስከ 10 ክህሎቶችን ይመልሳል። |
read_skill_file | name, path | በክህሎቱ አቃፊ ውስጥ ያለ ፋይል ያነባል። ያለ path ፋይሎቹን እና መጠኖቻቸውን ይዘረዝራል። |
save_skill | name, content | የተሟላ SKILL.md ወደ የተጠቃሚ ክህሎቶች አቃፊ ይጽፋል። የገበያ ቦታ ክህሎቶች ሊገለበጡ አይችሉም። |
delete_skill | name | የተጠቃሚ ክህሎትን ይሰርዛል። |
install_skill | code | የገበያ ቦታ ክህሎትን በSKIL- የመጫኛ ኮዱ ይጭናል። |
configure_skill | name, key, value | ሚስጥር ያዘጋጃል። ያለ key ክህሎቱ ምን እንደሚያስፈልገው ያሳያል። |
rate_skill | name, rating, review | የገበያ ቦታ ክህሎትን ከ1 እስከ 5 ይገመግማል። |
read_skill_reviews | name | የገበያ ቦታ ክህሎትን ግምገማዎች ያነባል። |
execute | skill, script, args, timeout | ከክህሎት አቃፊ ውስጥ ስክሪፕት ያሄዳል። የስክሪፕት ሳንድቦክስን ይመልከቱ። |
የስክሪፕት ሳንድቦክስ
የexecute መሣሪያ ከክህሎት አቃፊ ውስጥ አንድ ስክሪፕት ያሄዳል። የአሂድ አካባቢውን ከፋይሉ ይመርጣል።
| ስክሪፕት | የአሂድ አካባቢ |
|---|---|
.py | Python፣ ካለ አብሮ በመጣው የNebo uv በኩል፣ አለበለዚያ python3። |
.ts, .js | ካለ አብሮ የመጣው የNebo Bun፣ አለበለዚያ node። |
bin/<file> ወይም binary | በቀጥታ ይሄዳል። |
.sh | አይደገፍም። |
እያንዳንዱ ሩጫ በባዶ አካባቢ እና በእነዚህ ተለዋዋጮች ይጀምራል፦
| ተለዋዋጭ | እሴት |
|---|---|
SKILL_ARGS | የargs ኦብጀክት በJSON። |
እያንዳንዱ የሚስጥር key | የተፈታው የሚስጥር እሴት። |
<PLUGIN>_BIN | የእያንዳንዱ የታወጀ ተሰኪ ባይነሪ ዱካ። የተሰኪ አቃፊዎችም ወደ 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", []))})) ስክሪፕቱ በክህሎት አቃፊው ጊዜያዊ ቅጂ ውስጥ ይሄዳል፣ ነባሪ የጊዜ ገደቡም 30 ሰከንዶች ነው። በmacOS እና በLinux ላይ በስርዓተ ክወናው ሳንድቦክስ ውስጥ ይሄዳል፦
- የመግቢያ መረጃ ማከማቻዎችን፣ የአሳሽ እና የkeychain ውሂብን፣ ወይም የNeboን የራሱን ቅንብሮች እና የውሂብ ጎታ ማንበብ አይችልም።
- መጻፍ የሚችለው በሥራ አቃፊው እና በ
/tmp/neboውስጥ ብቻ ነው። የstorageችሎታ የNeboን የውሂብ አቃፊ ይጨምራል። - የአውታረ መረብ መዳረሻ የለውም። የ
networkችሎታ የጥቅል መዝገቦችን እና በmetadata.allowed_domainsውስጥ የተዘረዘሩ ጎራዎችን ይፈቅዳል።
ፋይሎች እና ገደቦች
| ንጥል | ደንብ |
|---|---|
| ግብዓቶች | ከSKILL.md፣ ከmanifest.json፣ ከsignatures.json እና በነጥብ ከሚጀምሩ ፋይሎች በስተቀር እያንዳንዱ ፋይል። |
| የሚተገበሩ ፋይሎች | በscripts/ ወይም በbin/ ስር ያሉ ፋይሎች፣ እና በዋናው ደረጃ binary የተባለ ፋይል። |
| ዱካዎች | ከክህሎት አቃፊው አንጻር። .. ያላቸው ወይም ከአቃፊው የሚያመልጡ ዱካዎች ውድቅ ይደረጋሉ። |
| የተሰናከለ ክህሎት | በSKILL.md ፋንታ SKILL.md.disabled ያለበት አቃፊ። |
| የክህሎት ዝርዝር | እያንዳንዱ ግቤት በ250 ቁምፊዎች ይቆረጣል። ዝርዝሩ በሙሉ ከ8,000 ቁምፊዎች ሲበልጥ መጀመሪያ የጋራ ክህሎቶች ያጥራሉ፤ የሰራተኛ የራሱ ክህሎቶች ሙሉ ግቤታቸውን ይይዛሉ። |
ወደ ገበያ ቦታ ለሚያትሟቸው ፋይሎች ያሉት ገደቦች በማተም ገጽ ላይ ይገኛሉ።