NeboAI
NeboAI
ចាប់ផ្ដើម

ឯកសារយោង SKILL.md

ទំព័រនេះរាយរាល់ផ្នែកនៃជំនាញដែល Nebo អាន៖ វាល frontmatter អថេរដែលវាពង្រីក ឧបករណ៍ដែលបុគ្គលិកប្រើដើម្បីធ្វើការជាមួយជំនាញ និងបរិស្ថានដែលស្គ្រីបដំណើរការ។

ទម្រង់ឯកសារ

SKILL.md គឺជាអត្ថបទ UTF-8។ វាចាប់ផ្ដើមដោយបន្ទាត់សញ្ញាដកបី បន្ទាប់មក YAML frontmatter បន្ទាប់មកបន្ទាត់បិទនៃសញ្ញាដកបី។ អ្វីៗទាំងអស់បន្ទាប់ពីនោះគឺជាតួអត្ថបទ៖ ការណែនាំ 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 ...

វាល Frontmatter

មានតែ name និង description ទេដែលចាំបាច់។ វាលដែលមានប្រភេទខុសធ្វើឱ្យឯកសារទាំងមូលបរាជ័យ ដូច្នេះជំនាញមិនផ្ទុកទេ។ Key ដែលមិនបានរាយនៅទីនេះត្រូវបានមិនអើពើ។

វាលប្រភេទលំនាំដើមអត្ថន័យ
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 ពង្រីក sandbox ស្គ្រីប។ សូមមើល Sandbox ស្គ្រីប។
metadatamap{}ផ្ទុក secrets និង allowed_domains។ សូមមើលខាងក្រោម។
requiresបញ្ជីនៃ {name, version}[]ជំនាញផ្សេងទៀតដែលជំនាញនេះផ្អែកលើ។ name គឺជាឈ្មោះខ្លីនៃជំនាញ; version គឺជាជួរ semver លំនាំដើម "*"។
pluginsបញ្ជីនៃ {name, version, optional}[]Plugin ដែលជំនាញនេះប្រើ។ version លំនាំដើមជា "*", optional លំនាំដើមជា false។
dependenciesបញ្ជីនៃខ្សែអក្សរ[]ឈ្មោះខ្លីនៃជំនាញដែលត្រូវតែមាន។
priorityinteger0រៀបលំដាប់ជំនាញនៅក្នុងបញ្ជីគ្រប់គ្រង។ វាមិនប៉ះពាល់ដល់ជំនាញដែលបុគ្គលិកជ្រើសរើសទេ។
authorstring""រក្សាទុកសម្រាប់បង្ហាញ។
licensestring""រក្សាទុកសម្រាប់បង្ហាញ។
compatibilitystring""កំណត់ចំណាំអត្ថបទសេរី យ៉ាងច្រើន 500 បៃ។
tagsបញ្ជីនៃខ្សែអក្សរ[]រក្សាទុកសម្រាប់បង្ហាញ។
allowed-toolsstring""ខ្សែអក្សរដែលបំបែកដោយដកឃ្លា។ រក្សាទុក; មិនអនុវត្តជាកំហិតទេ។

នៅពេលជំនាញដែលដាក់ឈ្មោះក្នុង requires ឬ dependencies បាត់ ឬនៅក្រៅជួរ ឬ Plugin ដែលចាំបាច់មិនត្រូវបានដំឡើង ជំនាញនៅតែផ្ទុក ហើយត្រូវបានសម្គាល់ថាថយចុះ។ ម្ចាស់មើលឃើញអ្វីដែលខ្វះ។

អាថ៌កំបាំង

ប្រកាសព័ត៌មានសម្ងាត់ដែលស្គ្រីបរបស់ជំនាញត្រូវការនៅក្រោម 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អត្ថន័យ
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}ផ្លូវនៃ binary របស់ Plugin ដែលបានប្រកាស។ Slug ត្រូវបានប្ដូរជាអក្សរធំ ដោយប្ដូរសញ្ញាដកទៅជាសញ្ញាគូសក្រោម៖ example-ledger ក្លាយជា ${plugin.EXAMPLE_LEDGER_BIN}។
${secret.KEY}តម្លៃនៃអាថ៌កំបាំងដែលបានប្រកាស។
$ARGUMENTSargs ដែលបានបញ្ជូនទៅ use_skill។ នៅពេលតួអត្ថបទគ្មាន $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ដំណើរការស្គ្រីបពីថតរបស់ជំនាញ។ សូមមើល Sandbox ស្គ្រីប។

Sandbox ស្គ្រីប

ឧបករណ៍ execute ដំណើរការស្គ្រីបមួយពីថតរបស់ជំនាញ។ វាជ្រើសរើស runtime ពីឯកសារ។

ស្គ្រីបបរិស្ថានដំណើរការ
.pyPython តាមរយៈ uv ដែលភ្ជាប់មកជាមួយ Nebo នៅពេលមាន បើមិនដូច្នោះទេ python3។
.ts, .jsBun ដែលភ្ជាប់មកជាមួយ Nebo នៅពេលមាន បើមិនដូច្នោះទេ node។
bin/<file> ឬ binaryដំណើរការដោយផ្ទាល់។
.shមិនគាំទ្រទេ។

ការដំណើរការនីមួយៗចាប់ផ្ដើមជាមួយបរិស្ថានទទេ និងអថេរទាំងនេះ៖

អថេរតម្លៃ
SKILL_ARGSObject args ជា JSON។
key អាថ៌កំបាំងនីមួយៗតម្លៃអាថ៌កំបាំងដែលបានឌិគ្រីប។
<PLUGIN>_BINផ្លូវនៃ binary របស់ Plugin នីមួយៗដែលបានប្រកាស។ ថត Plugin ក៏ត្រូវបានបន្ថែមទៅក្នុង 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 វាដំណើរការនៅក្នុង sandbox របស់ប្រព័ន្ធប្រតិបត្តិការ៖

  • វាមិនអាចអានឃ្លាំងព័ត៌មានសម្ងាត់ ទិន្នន័យកម្មវិធីរុករក និង keychain ឬការកំណត់ និងមូលដ្ឋានទិន្នន័យផ្ទាល់ខ្លួនរបស់ Nebo បានទេ។
  • វាអាចសរសេរបានតែទៅកាន់ថតធ្វើការរបស់វា និង /tmp/nebo ប៉ុណ្ណោះ។ សមត្ថភាព storage បន្ថែមថតទិន្នន័យរបស់ Nebo។
  • វាមិនមានការចូលប្រើបណ្ដាញទេ។ សមត្ថភាព network អនុញ្ញាតបញ្ជីកញ្ចប់ និងដែនដែលបានរាយក្នុង metadata.allowed_domains។

ឯកសារ និងដែនកំណត់

ធាតុច្បាប់
ធនធានរាល់ឯកសារ លើកលែងតែ SKILL.md, manifest.json, signatures.json និង dotfile។
កម្មវិធីដំណើរការឯកសារនៅក្រោម scripts/ ឬ bin/ និងឯកសារនៅថតឫសដែលមានឈ្មោះ binary។
ផ្លូវទាក់ទងនឹងថតជំនាញ។ ផ្លូវដែលមាន .. ឬដែលចេញក្រៅថតត្រូវបានបដិសេធ។
ជំនាញដែលបានបិទថតដែលមាន SKILL.md.disabled ជំនួសឱ្យ SKILL.md។
បញ្ជីជំនាញធាតុនីមួយៗត្រូវបានកាត់ត្រឹម 250 តួអក្សរ។ នៅពេលបញ្ជីទាំងមូលលើសពី 8,000 តួអក្សរ ជំនាញរួមត្រូវបានបង្រួមមុនគេ; ជំនាញផ្ទាល់ខ្លួនរបស់បុគ្គលិករក្សាធាតុពេញលេញរបស់វា។

ដែនកំណត់សម្រាប់ឯកសារដែលអ្នកបោះផ្សាយទៅទីផ្សារ មាននៅលើទំព័រ ការបោះផ្សាយ។