ទម្រង់ឯកសារ
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 ដែលមិនបានរាយនៅទីនេះត្រូវបានមិនអើពើ។
| វាល | ប្រភេទ | លំនាំដើម | អត្ថន័យ |
|---|---|---|---|
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 ពង្រីក sandbox ស្គ្រីប។ សូមមើល Sandbox ស្គ្រីប។ |
metadata | map | {} | ផ្ទុក secrets និង allowed_domains។ សូមមើលខាងក្រោម។ |
requires | បញ្ជីនៃ {name, version} | [] | ជំនាញផ្សេងទៀតដែលជំនាញនេះផ្អែកលើ។ name គឺជាឈ្មោះខ្លីនៃជំនាញ; version គឺជាជួរ semver លំនាំដើម "*"។ |
plugins | បញ្ជីនៃ {name, version, optional} | [] | Plugin ដែលជំនាញនេះប្រើ។ version លំនាំដើមជា "*", optional លំនាំដើមជា false។ |
dependencies | បញ្ជីនៃខ្សែអក្សរ | [] | ឈ្មោះខ្លីនៃជំនាញដែលត្រូវតែមាន។ |
priority | integer | 0 | រៀបលំដាប់ជំនាញនៅក្នុងបញ្ជីគ្រប់គ្រង។ វាមិនប៉ះពាល់ដល់ជំនាញដែលបុគ្គលិកជ្រើសរើសទេ។ |
author | string | "" | រក្សាទុកសម្រាប់បង្ហាញ។ |
license | string | "" | រក្សាទុកសម្រាប់បង្ហាញ។ |
compatibility | string | "" | កំណត់ចំណាំអត្ថបទសេរី យ៉ាងច្រើន 500 បៃ។ |
tags | បញ្ជីនៃខ្សែអក្សរ | [] | រក្សាទុកសម្រាប់បង្ហាញ។ |
allowed-tools | string | "" | ខ្សែអក្សរដែលបំបែកដោយដកឃ្លា។ រក្សាទុក; មិនអនុវត្តជាកំហិតទេ។ |
នៅពេលជំនាញដែលដាក់ឈ្មោះក្នុង 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} | តម្លៃនៃអាថ៌កំបាំងដែលបានប្រកាស។ |
$ARGUMENTS | args ដែលបានបញ្ជូនទៅ use_skill។ នៅពេលតួអត្ថបទគ្មាន $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 | ដំណើរការស្គ្រីបពីថតរបស់ជំនាញ។ សូមមើល Sandbox ស្គ្រីប។ |
Sandbox ស្គ្រីប
ឧបករណ៍ execute ដំណើរការស្គ្រីបមួយពីថតរបស់ជំនាញ។ វាជ្រើសរើស runtime ពីឯកសារ។
| ស្គ្រីប | បរិស្ថានដំណើរការ |
|---|---|
.py | Python តាមរយៈ uv ដែលភ្ជាប់មកជាមួយ Nebo នៅពេលមាន បើមិនដូច្នោះទេ python3។ |
.ts, .js | Bun ដែលភ្ជាប់មកជាមួយ Nebo នៅពេលមាន បើមិនដូច្នោះទេ node។ |
bin/<file> ឬ binary | ដំណើរការដោយផ្ទាល់។ |
.sh | មិនគាំទ្រទេ។ |
ការដំណើរការនីមួយៗចាប់ផ្ដើមជាមួយបរិស្ថានទទេ និងអថេរទាំងនេះ៖
| អថេរ | តម្លៃ |
|---|---|
SKILL_ARGS | Object 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 តួអក្សរ ជំនាញរួមត្រូវបានបង្រួមមុនគេ; ជំនាញផ្ទាល់ខ្លួនរបស់បុគ្គលិករក្សាធាតុពេញលេញរបស់វា។ |
ដែនកំណត់សម្រាប់ឯកសារដែលអ្នកបោះផ្សាយទៅទីផ្សារ មាននៅលើទំព័រ ការបោះផ្សាយ។