ફાઇલ ફોર્મેટ
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} | જાહેર કરેલા પ્લગઇનની બાઇનરીનો પાથ. સ્લગ મોટા અક્ષરોમાં, હાઇફનને અન્ડરસ્કોર બનાવીને લખાય છે: 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 અક્ષરોથી વધી જાય ત્યારે, પહેલાં શેર કરેલી સ્કિલ્સ ટૂંકી કરાય છે; કર્મચારીની પોતાની સ્કિલ્સ પોતાની પૂરી એન્ટ્રીઓ રાખે છે. |
તમે માર્કેટપ્લેસ પર પ્રકાશિત કરો તે ફાઇલોની મર્યાદાઓ પ્રકાશન પેજ પર છે.