O que é uma skill
Uma skill é uma pasta cujo nome corresponde ao name da skill. A pasta contém um ficheiro SKILL.md e, opcionalmente, quaisquer outros ficheiros a que as instruções se refiram: documentos de referência, modelos ou scripts.
O SKILL.md tem duas partes. O frontmatter YAML entre linhas --- contém o nome e uma descrição. O corpo em Markdown que se segue contém as instruções.
Como os funcionários usam as skills
Um funcionário trabalha com uma skill em três passos.
- Escolher. Em cada turno, o funcionário vê uma lista das skills de que dispõe: o nome de cada skill, a sua descrição e até três dos seus acionadores. A descrição é o que o funcionário lê para decidir, por isso escreva-a de forma a dizer o que a skill faz e quando a usar.
- Carregar. O funcionário chama a ferramenta
use_skillcom o nome da skill. A ferramenta devolve as instruções, o caminho da pasta da skill e os nomes dos seus ficheiros. É a única forma de um funcionário ler uma skill. - Trabalhar. O funcionário segue as instruções. Lê os ficheiros de apoio com
read_skill_filee executa os scripts incluídos comexecute.
Os acionadores nunca carregam uma skill por si só. A escolha é sempre do funcionário. Quando a lista fica longa, o funcionário pode pesquisá-la com find_skills.
Escreva a sua primeira skill
Crie uma pasta com o nome da skill e um ficheiro lá dentro.
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".
Coloque a pasta na pasta de skills do utilizador de um bot (consulte Onde ficam as skills). O Nebo deteta a nova pasta em cerca de um segundo, e todos os funcionários desse bot podem usar a skill.
Um funcionário também pode escrever uma skill por si. Peça-lhe que guarde uma e ele chama save_skill, que escreve a pasta na mesma pasta de skills do utilizador.
Regras que o carregador impõe
Uma skill que viole uma destas regras não é carregada. O Nebo regista um aviso e ignora-a.
| Regra | Pormenor |
|---|---|
O ficheiro começa por --- | O frontmatter tem de ser a primeira coisa no ficheiro. O ficheiro tem de estar em UTF-8. |
name é obrigatório | Só letras minúsculas, dígitos e hífenes; sem hífen inicial ou final; sem hífen duplo; no máximo 64 bytes. |
description é obrigatório | No máximo 1024 bytes. |
| Os campos têm o tipo certo | Um campo com o tipo YAML errado faz falhar o ficheiro inteiro. Ponha as versões entre aspas, como "1.0.0". |
platform corresponde | Se existir, a skill só é carregada nos sistemas operativos indicados. |
As chaves do frontmatter que o Nebo não reconhece são ignoradas. O corpo não tem limite de tamanho, mas instruções mais curtas deixam mais espaço para o trabalho. Passe o material longo para ficheiros que o funcionário lê quando precisar.
Acrescentar ficheiros
Qualquer ficheiro da pasta além do SKILL.md e dos ficheiros ocultos fica disponível para o funcionário. Os nomes das pastas ficam ao seu critério; o Nebo não dá nenhum significado especial a references/ nem a assets/. Os ficheiros em scripts/ ou bin/ podem ser executados.
invoice-check/
├── SKILL.md # required
├── references/
│ └── policy.md # read with read_skill_file
└── scripts/
└── totals.py # run with execute Refira-se aos ficheiros pelo caminho dentro da pasta, como references/policy.md. O funcionário lê-os com read_skill_file, que rejeita qualquer caminho que saia da pasta. Os scripts correm com a ferramenta execute numa sandbox. A referência do SKILL.md aborda runtimes, variáveis de ambiente, segredos e acesso à rede.
Onde ficam as skills
Um bot reúne skills de vários sítios. Quando duas fontes disponibilizam uma skill com o mesmo nome, prevalece a fonte que aparece mais abaixo nesta lista.
| Fonte | Localização | Quem a pode usar |
|---|---|---|
| Incorporada | Compilada no Nebo | Todos os funcionários |
| Loja | <data>/nebo/skills/<slug>/<version>/ | Todos os funcionários |
| Plugin | A pasta skills/ de um plugin instalado | Todos os funcionários |
| Utilizador | <data>/user/skills/<name>/ | Todos os funcionários |
| Pacote de funcionário | skills/ dentro de um pacote de funcionário instalado | Só esse funcionário |
| Aprendida | <data>/learned/skills/<employee>/<name>/ | Só esse funcionário |
<data> é ~/Library/Application Support/Nebo no macOS, %APPDATA%\Nebo no Windows e ~/.local/share/nebo no Linux. A variável de ambiente NEBO_HOME substitui-o. Quando um funcionário tem uma skill própria e uma skill partilhada com o mesmo nome, prevalece a sua.
O Nebo vigia estas pastas e recarrega uma skill alterada ao fim de um segundo. Para desligar uma skill sem a eliminar, mude o nome do ficheiro para SKILL.md.disabled.
As skills descrevem trabalho, não ferramentas. Escreva uma skill em torno de uma responsabilidade, como reconciliar recibos, e deixe o funcionário usar a ligação que o proprietário disponibilizou. Quando uma skill precisa mesmo de um plugin, declare-o com o campo plugins.
A seguir
- Referência do SKILL.md: todos os campos, ferramentas e variáveis.
- Exemplos: skills completas para copiar.
- Publicação: coloque uma skill na loja.