ਸਕਿੱਲ ਕੀ ਹੈ
ਸਕਿੱਲ ਇੱਕ ਫੋਲਡਰ ਹੈ ਜਿਸ ਦਾ ਨਾਮ ਸਕਿੱਲ ਦੇ name ਨਾਲ ਮੇਲ ਖਾਂਦਾ ਹੈ। ਫੋਲਡਰ ਵਿੱਚ ਇੱਕ SKILL.md ਫ਼ਾਈਲ ਹੁੰਦੀ ਹੈ ਅਤੇ, ਚਾਹੋ ਤਾਂ, ਕੋਈ ਵੀ ਹੋਰ ਫ਼ਾਈਲਾਂ ਜਿਹਨਾਂ ਦਾ ਹਿਦਾਇਤਾਂ ਵਿੱਚ ਜ਼ਿਕਰ ਹੈ: ਹਵਾਲਾ ਦਸਤਾਵੇਜ਼, ਟੈਮਪਲੇਟ, ਜਾਂ ਸਕ੍ਰਿਪਟਾਂ।
SKILL.md ਦੇ ਦੋ ਹਿੱਸੇ ਹਨ। --- ਲਾਈਨਾਂ ਵਿਚਕਾਰ YAML ਫ਼੍ਰੰਟਮੈਟਰ ਨਾਮ ਅਤੇ ਵੇਰਵਾ ਰੱਖਦਾ ਹੈ। ਇਸ ਤੋਂ ਬਾਅਦ ਦੀ Markdown ਬਾਡੀ ਵਿੱਚ ਹਿਦਾਇਤਾਂ ਹੁੰਦੀਆਂ ਹਨ।
ਕਰਮਚਾਰੀ ਸਕਿੱਲ ਕਿਵੇਂ ਵਰਤਦੇ ਹਨ
ਕਰਮਚਾਰੀ ਤਿੰਨ ਕਦਮਾਂ ਵਿੱਚ ਸਕਿੱਲ ਨਾਲ ਕੰਮ ਕਰਦਾ ਹੈ।
- ਚੁਣੋ। ਹਰ ਵਾਰੀ ’ਤੇ ਕਰਮਚਾਰੀ ਨੂੰ ਉਸ ਲਈ ਉਪਲਬਧ ਸਕਿੱਲਾਂ ਦੀ ਸੂਚੀ ਦਿਸਦੀ ਹੈ: ਹਰ ਸਕਿੱਲ ਦਾ ਨਾਮ, ਉਸ ਦਾ ਵੇਰਵਾ, ਅਤੇ ਉਸ ਦੇ ਵੱਧ ਤੋਂ ਵੱਧ ਤਿੰਨ ਟ੍ਰਿਗਰ। ਫ਼ੈਸਲਾ ਕਰਨ ਲਈ ਕਰਮਚਾਰੀ ਵੇਰਵਾ ਹੀ ਪੜ੍ਹਦਾ ਹੈ, ਇਸ ਲਈ ਇਸ ਵਿੱਚ ਲਿਖੋ ਕਿ ਸਕਿੱਲ ਕੀ ਕਰਦਾ ਹੈ ਅਤੇ ਕਦੋਂ ਵਰਤਣਾ ਹੈ।
- ਲੋਡ ਕਰੋ। ਕਰਮਚਾਰੀ ਸਕਿੱਲ ਦੇ ਨਾਮ ਨਾਲ
use_skillਟੂਲ ਕਾਲ ਕਰਦਾ ਹੈ। ਟੂਲ ਹਿਦਾਇਤਾਂ, ਸਕਿੱਲ ਦੇ ਫੋਲਡਰ ਦਾ ਪਾਥ, ਅਤੇ ਇਸ ਦੀਆਂ ਫ਼ਾਈਲਾਂ ਦੇ ਨਾਮ ਵਾਪਸ ਕਰਦਾ ਹੈ। ਕਰਮਚਾਰੀ ਲਈ ਸਕਿੱਲ ਪੜ੍ਹਨ ਦਾ ਇਹੀ ਇੱਕੋ-ਇੱਕ ਤਰੀਕਾ ਹੈ। - ਕੰਮ ਕਰੋ। ਕਰਮਚਾਰੀ ਹਿਦਾਇਤਾਂ ਦੀ ਪਾਲਣਾ ਕਰਦਾ ਹੈ। ਇਹ ਸਹਾਇਕ ਫ਼ਾਈਲਾਂ
read_skill_fileਨਾਲ ਪੜ੍ਹਦਾ ਹੈ ਅਤੇ ਬੰਡਲ ਕੀਤੀਆਂ ਸਕ੍ਰਿਪਟਾਂexecuteਨਾਲ ਚਲਾਉਂਦਾ ਹੈ।
ਟ੍ਰਿਗਰ ਕਦੇ ਆਪਣੇ ਆਪ ਸਕਿੱਲ ਲੋਡ ਨਹੀਂ ਕਰਦੇ। ਚੋਣ ਹਮੇਸ਼ਾ ਕਰਮਚਾਰੀ ਕਰਦਾ ਹੈ। ਜਦੋਂ ਸੂਚੀ ਲੰਮੀ ਹੋ ਜਾਂਦੀ ਹੈ, ਕਰਮਚਾਰੀ find_skills ਨਾਲ ਇਸ ਵਿੱਚ ਖੋਜ ਕਰ ਸਕਦਾ ਹੈ।
ਆਪਣਾ ਪਹਿਲਾ ਸਕਿੱਲ ਲਿਖੋ
ਸਕਿੱਲ ਦੇ ਨਾਮ ਵਾਲਾ ਇੱਕ ਫੋਲਡਰ ਬਣਾਓ, ਜਿਸ ਵਿੱਚ ਇੱਕ ਫ਼ਾਈਲ ਹੋਵੇ।
meeting-notes/ └── SKILL.md
--- name: meeting-notes description: Turn a meeting transcript into decisions, action items with owners, and open questions. Use when someone shares meeting notes or a transcript. --- # Meeting notes 1. List the decisions that were made. 2. List action items as "owner — task — due date". 3. List open questions that need a follow-up. Keep each list short. If the transcript names no owner for an item, write "unassigned".
ਫੋਲਡਰ ਨੂੰ ਬੋਟ ਦੀ ਯੂਜ਼ਰ ਸਕਿੱਲ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਰੱਖੋ (ਸਕਿੱਲ ਕਿੱਥੇ ਰਹਿੰਦੇ ਹਨ ਦੇਖੋ)। Nebo ਲਗਭਗ ਇੱਕ ਸਕਿੰਟ ਵਿੱਚ ਨਵਾਂ ਫੋਲਡਰ ਦੇਖ ਲੈਂਦਾ ਹੈ, ਅਤੇ ਉਸ ਬੋਟ ’ਤੇ ਹਰ ਕਰਮਚਾਰੀ ਸਕਿੱਲ ਵਰਤ ਸਕਦਾ ਹੈ।
ਕੋਈ ਕਰਮਚਾਰੀ ਤੁਹਾਡੇ ਲਈ ਸਕਿੱਲ ਲਿਖ ਵੀ ਸਕਦਾ ਹੈ। ਉਸ ਨੂੰ ਇੱਕ ਸੰਭਾਲਣ ਲਈ ਕਹੋ, ਅਤੇ ਉਹ save_skill ਕਾਲ ਕਰਦਾ ਹੈ, ਜੋ ਫੋਲਡਰ ਨੂੰ ਉਸੇ ਯੂਜ਼ਰ ਸਕਿੱਲ ਡਾਇਰੈਕਟਰੀ ਵਿੱਚ ਲਿਖਦਾ ਹੈ।
ਲੋਡਰ ਵੱਲੋਂ ਲਾਗੂ ਕੀਤੇ ਨਿਯਮ
ਜੋ ਸਕਿੱਲ ਇਹਨਾਂ ਵਿੱਚੋਂ ਕੋਈ ਨਿਯਮ ਤੋੜਦਾ ਹੈ ਉਹ ਲੋਡ ਨਹੀਂ ਹੁੰਦਾ। Nebo ਚੇਤਾਵਨੀ ਲੌਗ ਕਰਦਾ ਹੈ ਅਤੇ ਉਸ ਨੂੰ ਛੱਡ ਦਿੰਦਾ ਹੈ।
| ਨਿਯਮ | ਵੇਰਵਾ |
|---|---|
ਫ਼ਾਈਲ --- ਨਾਲ ਸ਼ੁਰੂ ਹੁੰਦੀ ਹੈ | ਫ਼੍ਰੰਟਮੈਟਰ ਫ਼ਾਈਲ ਵਿੱਚ ਸਭ ਤੋਂ ਪਹਿਲਾਂ ਹੋਣਾ ਚਾਹੀਦਾ ਹੈ। ਫ਼ਾਈਲ UTF-8 ਹੋਣੀ ਚਾਹੀਦੀ ਹੈ। |
name ਲਾਜ਼ਮੀ ਹੈ | ਸਿਰਫ਼ ਛੋਟੇ ਅੱਖਰ, ਅੰਕ ਅਤੇ ਹਾਈਫ਼ਨ; ਸ਼ੁਰੂ ਜਾਂ ਅੰਤ ਵਿੱਚ ਹਾਈਫ਼ਨ ਨਹੀਂ; ਦੋਹਰਾ ਹਾਈਫ਼ਨ ਨਹੀਂ; ਵੱਧ ਤੋਂ ਵੱਧ 64 ਬਾਈਟ। |
description ਲਾਜ਼ਮੀ ਹੈ | ਵੱਧ ਤੋਂ ਵੱਧ 1,024 ਬਾਈਟ। |
| ਫ਼ੀਲਡਾਂ ਦੀ ਕਿਸਮ ਸਹੀ ਹੈ | ਗ਼ਲਤ YAML ਕਿਸਮ ਵਾਲੀ ਫ਼ੀਲਡ ਪੂਰੀ ਫ਼ਾਈਲ ਨੂੰ ਫ਼ੇਲ੍ਹ ਕਰ ਦਿੰਦੀ ਹੈ। ਵਰਜਨਾਂ ਨੂੰ ਕੋਟਸ ਵਿੱਚ ਲਿਖੋ, ਜਿਵੇਂ "1.0.0"। |
platform ਮੇਲ ਖਾਂਦਾ ਹੈ | ਜੇ ਮੌਜੂਦ ਹੋਵੇ, ਤਾਂ ਸਕਿੱਲ ਸਿਰਫ਼ ਦਰਜ ਓਪਰੇਟਿੰਗ ਸਿਸਟਮਾਂ ’ਤੇ ਲੋਡ ਹੁੰਦਾ ਹੈ। |
ਜਿਹਨਾਂ ਫ਼੍ਰੰਟਮੈਟਰ ਕੁੰਜੀਆਂ ਨੂੰ Nebo ਨਹੀਂ ਪਛਾਣਦਾ ਉਹ ਨਜ਼ਰਅੰਦਾਜ਼ ਹੁੰਦੀਆਂ ਹਨ। ਬਾਡੀ ਦੀ ਕੋਈ ਆਕਾਰ ਸੀਮਾ ਨਹੀਂ, ਪਰ ਛੋਟੀਆਂ ਹਿਦਾਇਤਾਂ ਕੰਮ ਲਈ ਵਧੇਰੇ ਥਾਂ ਛੱਡਦੀਆਂ ਹਨ। ਲੰਮੀ ਸਮੱਗਰੀ ਨੂੰ ਫ਼ਾਈਲਾਂ ਵਿੱਚ ਰੱਖੋ ਜੋ ਕਰਮਚਾਰੀ ਲੋੜ ਪੈਣ ’ਤੇ ਪੜ੍ਹਦਾ ਹੈ।
ਫ਼ਾਈਲਾਂ ਜੋੜੋ
ਫੋਲਡਰ ਵਿੱਚ SKILL.md ਅਤੇ ਡੌਟਫ਼ਾਈਲਾਂ ਤੋਂ ਇਲਾਵਾ ਹਰ ਫ਼ਾਈਲ ਕਰਮਚਾਰੀ ਲਈ ਉਪਲਬਧ ਹੈ। ਫੋਲਡਰਾਂ ਦੇ ਨਾਮ ਤੁਸੀਂ ਆਪ ਚੁਣਦੇ ਹੋ; Nebo references/ ਜਾਂ assets/ ਨੂੰ ਕੋਈ ਖ਼ਾਸ ਅਰਥ ਨਹੀਂ ਦਿੰਦਾ। scripts/ ਜਾਂ bin/ ਹੇਠਲੀਆਂ ਫ਼ਾਈਲਾਂ ਚਲਾਈਆਂ ਜਾ ਸਕਦੀਆਂ ਹਨ।
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute ਫ਼ਾਈਲਾਂ ਦਾ ਹਵਾਲਾ ਫੋਲਡਰ ਅੰਦਰਲੇ ਉਹਨਾਂ ਦੇ ਪਾਥ ਨਾਲ ਦਿਓ, ਜਿਵੇਂ references/policy.md। ਕਰਮਚਾਰੀ ਇਹਨਾਂ ਨੂੰ read_skill_file ਨਾਲ ਪੜ੍ਹਦਾ ਹੈ, ਜੋ ਫੋਲਡਰ ਤੋਂ ਬਾਹਰ ਜਾਣ ਵਾਲਾ ਹਰ ਪਾਥ ਰੱਦ ਕਰਦਾ ਹੈ। ਸਕ੍ਰਿਪਟਾਂ execute ਟੂਲ ਨਾਲ ਸੈਂਡਬਾਕਸ ਵਿੱਚ ਚੱਲਦੀਆਂ ਹਨ। SKILL.md ਹਵਾਲਾ ਰਨਟਾਈਮ, ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ, ਸੀਕ੍ਰੇਟ ਅਤੇ ਨੈੱਟਵਰਕ ਪਹੁੰਚ ਬਾਰੇ ਦੱਸਦਾ ਹੈ।
ਸਕਿੱਲ ਕਿੱਥੇ ਰਹਿੰਦੇ ਹਨ
ਬੋਟ ਕਈ ਥਾਵਾਂ ਤੋਂ ਸਕਿੱਲ ਇਕੱਠੇ ਕਰਦਾ ਹੈ। ਜਦੋਂ ਦੋ ਸਰੋਤ ਇੱਕੋ ਨਾਮ ਵਾਲਾ ਸਕਿੱਲ ਦਿੰਦੇ ਹਨ, ਤਾਂ ਇਸ ਸੂਚੀ ਵਿੱਚ ਬਾਅਦ ਵਾਲਾ ਸਰੋਤ ਲਾਗੂ ਹੁੰਦਾ ਹੈ।
| ਸਰੋਤ | ਟਿਕਾਣਾ | ਕੌਣ ਵਰਤ ਸਕਦਾ ਹੈ |
|---|---|---|
| ਬਿਲਟ-ਇਨ | Nebo ਵਿੱਚ ਕੰਪਾਇਲ ਕੀਤਾ | ਹਰ ਕਰਮਚਾਰੀ |
| ਮਾਰਕੀਟਪਲੇਸ | <data>/nebo/skills/<slug>/<version>/ | ਹਰ ਕਰਮਚਾਰੀ |
| ਪਲੱਗਇਨ | ਇੰਸਟਾਲ ਕੀਤੇ ਪਲੱਗਇਨ ਦਾ skills/ ਫੋਲਡਰ | ਹਰ ਕਰਮਚਾਰੀ |
| ਯੂਜ਼ਰ | <data>/user/skills/<name>/ | ਹਰ ਕਰਮਚਾਰੀ |
| ਕਰਮਚਾਰੀ ਪੈਕੇਜ | ਇੰਸਟਾਲ ਕੀਤੇ ਕਰਮਚਾਰੀ ਪੈਕੇਜ ਅੰਦਰ skills/ | ਸਿਰਫ਼ ਉਹੀ ਕਰਮਚਾਰੀ |
| ਸਿੱਖਿਆ ਹੋਇਆ | <data>/learned/skills/<employee>/<name>/ | ਸਿਰਫ਼ ਉਹੀ ਕਰਮਚਾਰੀ |
<data> macOS ’ਤੇ ~/Library/Application Support/Nebo, Windows ’ਤੇ %APPDATA%\Nebo, ਅਤੇ Linux ’ਤੇ ~/.local/share/nebo ਹੈ। NEBO_HOME ਵਾਤਾਵਰਣ ਵੇਰੀਏਬਲ ਇਸ ਦੀ ਥਾਂ ਲੈਂਦਾ ਹੈ। ਜਦੋਂ ਕਿਸੇ ਕਰਮਚਾਰੀ ਕੋਲ ਆਪਣਾ ਸਕਿੱਲ ਅਤੇ ਉਸੇ ਨਾਮ ਦਾ ਸਾਂਝਾ ਸਕਿੱਲ ਹੋਵੇ, ਤਾਂ ਉਸ ਦਾ ਆਪਣਾ ਸਕਿੱਲ ਲਾਗੂ ਹੁੰਦਾ ਹੈ।
Nebo ਇਹਨਾਂ ਫੋਲਡਰਾਂ ’ਤੇ ਨਜ਼ਰ ਰੱਖਦਾ ਹੈ ਅਤੇ ਬਦਲੇ ਹੋਏ ਸਕਿੱਲ ਨੂੰ ਇੱਕ ਸਕਿੰਟ ਬਾਅਦ ਮੁੜ ਲੋਡ ਕਰਦਾ ਹੈ। ਕਿਸੇ ਸਕਿੱਲ ਨੂੰ ਮਿਟਾਏ ਬਿਨਾਂ ਬੰਦ ਕਰਨ ਲਈ, ਇਸ ਦੀ ਫ਼ਾਈਲ ਦਾ ਨਾਮ ਬਦਲ ਕੇ SKILL.md.disabled ਕਰੋ।
ਸਕਿੱਲ ਕੰਮ ਦਾ ਵੇਰਵਾ ਦਿੰਦੇ ਹਨ, ਟੂਲਾਂ ਦਾ ਨਹੀਂ। ਸਕਿੱਲ ਨੂੰ ਕਿਸੇ ਜ਼ਿੰਮੇਵਾਰੀ ਦੁਆਲੇ ਲਿਖੋ, ਜਿਵੇਂ ਰਸੀਦਾਂ ਦਾ ਮਿਲਾਨ, ਅਤੇ ਕਰਮਚਾਰੀ ਨੂੰ ਮਾਲਕ ਵੱਲੋਂ ਦਿੱਤਾ ਜੋ ਵੀ ਕਨੈਕਸ਼ਨ ਹੈ ਉਹ ਵਰਤਣ ਦਿਓ। ਜਦੋਂ ਕਿਸੇ ਸਕਿੱਲ ਨੂੰ ਸੱਚਮੁੱਚ ਪਲੱਗਇਨ ਦੀ ਲੋੜ ਹੋਵੇ, ਤਾਂ plugins ਫ਼ੀਲਡ ਨਾਲ ਉਸ ਦਾ ਐਲਾਨ ਕਰੋ।
ਅੱਗੇ
- SKILL.md ਹਵਾਲਾ: ਹਰ ਫ਼ੀਲਡ, ਟੂਲ ਅਤੇ ਵੇਰੀਏਬਲ।
- ਉਦਾਹਰਣਾਂ: ਕਾਪੀ ਕਰਨ ਲਈ ਪੂਰੇ ਸਕਿੱਲ।
- ਪ੍ਰਕਾਸ਼ਨ: ਸਕਿੱਲ ਨੂੰ ਮਾਰਕੀਟਪਲੇਸ ’ਤੇ ਪਾਓ।