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