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}அறிவிக்கப்பட்ட ரகசியத்தின் மதிப்பு.
$ARGUMENTSuse_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, .jsNebo-வுடன் தொகுக்கப்பட்ட Bun இருந்தால் அது, இல்லையெனில் node.
bin/<file> அல்லது binaryநேரடியாக இயக்கப்படும்.
.shஆதரிக்கப்படவில்லை.

ஒவ்வொரு இயக்கமும் காலியான சூழலுடனும் இந்த மாறிகளுடனும் தொடங்குகிறது:

மாறிமதிப்பு
SKILL_ARGSJSON ஆக args ஆப்ஜெக்ட்.
ஒவ்வொரு ரகசிய 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-இல் அது இயக்க முறைமைச் சாண்ட்பாக்ஸில் இயங்குகிறது:

  • அது சான்றுச் சேமிப்பகங்கள், உலாவி மற்றும் கீசெயின் தரவு, அல்லது 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 எழுத்துகளைத் தாண்டும்போது, பகிரப்பட்ட திறன்கள் முதலில் சுருக்கப்படுகின்றன; பணியாளரின் சொந்தத் திறன்கள் முழுப் பதிவுகளையும் வைத்திருக்கின்றன.

சந்தையில் நீங்கள் வெளியிடும் கோப்புகளுக்கான வரம்புகள் வெளியிடுதல் பக்கத்தில் உள்ளன.