NeboAI
NeboAI
ይጀምሩ

የSKILL.md ማጣቀሻ

ይህ ገጽ Nebo የሚያነባቸውን የክህሎት ክፍሎች በሙሉ ይዘረዝራል፦ የፊት ክፍል መስኮችን፣ የሚያሰፋቸውን ተለዋዋጮች፣ ሰራተኞች ከክህሎቶች ጋር ለመሥራት የሚጠቀሙባቸውን መሣሪያዎች፣ እና ስክሪፕቶች የሚሄዱበትን አካባቢ።

የፋይል ቅርጸት

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 ብቻ ናቸው። የተሳሳተ ዓይነት ያለው መስክ ፋይሉን በሙሉ ያከሽፋል፣ ስለዚህ ክህሎቱ አይጫንም። እዚህ ያልተዘረዘሩ ቁልፎች ችላ ይባላሉ።

መስክዓይነትነባሪትርጉም
namestringግዴታመለያ። [a-z0-9-]፣ በመጀመሪያ ወይም በመጨረሻ ሰረዝ ወይም ድርብ ሰረዝ የሌለበት፣ ቢበዛ 64 ባይት። ከአቃፊው ስም ጋር ያዛምዱት።
descriptionstringግዴታክህሎቱ ምን እንደሚሠራ እና መቼ ጥቅም ላይ እንደሚውል። ቢበዛ 1,024 ባይት። በሰራተኛው የክህሎት ዝርዝር ውስጥ ይታያል፣ በfind_skillsም ነጥብ ይሰጠዋል።
versionstring"1.0.0"ሴማንቲክ ስሪት። በሌሎች ክህሎቶች የrequires ክልሎች ይፈተሻል። በትዕምርተ ጥቅስ ውስጥ ያስቀምጡት።
triggersየሕብረቁምፊዎች ዝርዝር[]ክህሎቱ መቼ እንደሚያገለግል የሚገልጹ ቃላት እና ሐረጎች። እስከ ሦስቱ በክህሎት ዝርዝሩ ውስጥ ይታያሉ፤ ሁሉም በfind_skills ውስጥ ይቆጠራሉ። ክህሎትን በራሳቸው በጭራሽ አይጭኑም።
platformየሕብረቁምፊዎች ዝርዝርሁሉምmacos፣ linux፣ windows። ክህሎቱ የሚጫነው ከእነዚህ አንዱ በሚዛመድበት ቦታ ብቻ ነው።
capabilitiesየሕብረቁምፊዎች ዝርዝር[]network እና storage የስክሪፕት ሳንድቦክሱን ያሰፋሉ። የስክሪፕት ሳንድቦክስን ይመልከቱ።
metadatamap{}secrets እና allowed_domainsን ይይዛል። ከታች ይመልከቱ።
requiresየ{name, version} ዝርዝር[]ይህ ክህሎት የሚገነባባቸው ሌሎች ክህሎቶች። name የክህሎቱ አጭር ስም ነው፤ version የsemver ክልል ነው፣ ነባሪው "*"።
pluginsየ{name, version, optional} ዝርዝር[]ይህ ክህሎት የሚጠቀምባቸው ተሰኪዎች። version በነባሪ "*"፣ optional ደግሞ false ነው።
dependenciesየሕብረቁምፊዎች ዝርዝር[]መኖር ያለባቸው የክህሎቶች አጭር ስሞች።
priorityinteger0በአስተዳደር ዝርዝሮች ውስጥ የክህሎቶችን ቅደም ተከተል ይወስናል። ሰራተኛ የትኛውን ክህሎት እንደሚመርጥ አይነካም።
authorstring""ለማሳያ ይቀመጣል።
licensestring""ለማሳያ ይቀመጣል።
compatibilitystring""ነጻ የጽሑፍ ማስታወሻ፣ ቢበዛ 500 ባይት።
tagsየሕብረቁምፊዎች ዝርዝር[]ለማሳያ ይቀመጣል።
allowed-toolsstring""በክፍተት የተለየ ሕብረቁምፊ። ይቀመጣል፤ አይተገበርም።

በ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እሴቱን ከየት ማግኘት እንደሚቻል።
requiredtrue ሲሆን እሴቱ እስኪዘጋጅ ድረስ 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_skillname, argsክህሎትን ይጭናል። የተሰፋውን አካል፣ የአቃፊውን ዱካ እና የመጀመሪያዎቹን 20 የፋይል ስሞች ይመልሳል። የተሰናከለ ክህሎትን እንደገና ያነቃል።
find_skillsqueryበስም፣ በቀስቃሽ እና በመግለጫ ተዛማጅነት የተደረደሩ እስከ 10 ክህሎቶችን ይመልሳል።
read_skill_filename, pathበክህሎቱ አቃፊ ውስጥ ያለ ፋይል ያነባል። ያለ path ፋይሎቹን እና መጠኖቻቸውን ይዘረዝራል።
save_skillname, contentየተሟላ SKILL.md ወደ የተጠቃሚ ክህሎቶች አቃፊ ይጽፋል። የገበያ ቦታ ክህሎቶች ሊገለበጡ አይችሉም።
delete_skillnameየተጠቃሚ ክህሎትን ይሰርዛል።
install_skillcodeየገበያ ቦታ ክህሎትን በSKIL- የመጫኛ ኮዱ ይጭናል።
configure_skillname, key, valueሚስጥር ያዘጋጃል። ያለ key ክህሎቱ ምን እንደሚያስፈልገው ያሳያል።
rate_skillname, rating, reviewየገበያ ቦታ ክህሎትን ከ1 እስከ 5 ይገመግማል።
read_skill_reviewsnameየገበያ ቦታ ክህሎትን ግምገማዎች ያነባል።
executeskill, script, args, timeoutከክህሎት አቃፊ ውስጥ ስክሪፕት ያሄዳል። የስክሪፕት ሳንድቦክስን ይመልከቱ።

የስክሪፕት ሳንድቦክስ

የexecute መሣሪያ ከክህሎት አቃፊ ውስጥ አንድ ስክሪፕት ያሄዳል። የአሂድ አካባቢውን ከፋይሉ ይመርጣል።

ስክሪፕትየአሂድ አካባቢ
.pyPython፣ ካለ አብሮ በመጣው የ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 ቁምፊዎች ሲበልጥ መጀመሪያ የጋራ ክህሎቶች ያጥራሉ፤ የሰራተኛ የራሱ ክህሎቶች ሙሉ ግቤታቸውን ይይዛሉ።

ወደ ገበያ ቦታ ለሚያትሟቸው ፋይሎች ያሉት ገደቦች በማተም ገጽ ላይ ይገኛሉ።