makuco skill | agent | prompt add

Disponível a partir da versão 3.1.0

Estes três comandos não existem em versões anteriores — a CLI sai com erro de comando desconhecido. Confira com makuco --version. Eles dependem do Makuco Hub.

makuco skill  add <unidade>/<nome>[@versão] [-r <caminho>] [-p <política>]
makuco agent  add <unidade>/<nome>[@versão] [-r <caminho>] [-p <política>]
makuco prompt add <unidade>/<nome>[@versão] [-r <caminho>] [-p <política>]

Instalam um item avulso de qualquer unidade — não só da unidade configurada no projeto. O item entra no inventário e passa a ser atualizado pelo makuco unit sync, igual ao que veio no pacote da unidade.

Flag	O que faz
`-r, --root <caminho>`	Raiz do projeto (padrão: diretório atual).
`-p, --policy <política>`	Decide sem perguntar no item que divergiu: `keep` \| `accept` \| `skip`.

Códigos de saída: 0 sucesso · 1 falha · 2 pendências não resolvidas.

O endereço

A forma é <unidade>/<nome>[@versão]:

# Última versão publicada — acompanha o Hub a cada unit sync.
makuco skill add lughy/lughy-code-review
 
# Versão fixada — não sai do 1.2.0 até você mandar.
makuco skill add lughy/lughy-code-review@1.2.0

A unidade é o que vem antes da primeira barra. O resto é o nome, que pode conter barra (lughy/review/backend é a skill review/backend da unidade lughy).
A versão é o que vem depois do último @. Nome que contenha @ continua sendo nome.

Fixar ou acompanhar

Forma	Comportamento no `unit sync`
`unidade/nome`	Acompanha a última versão publicada.
`unidade/nome@1.2.0`	Fica fixado em `1.2.0`. O `unit sync` resolve a versão registrada e não desafixa.

O que pode dar errado

Situação	O que a CLI faz
Endereço fora da forma `<unidade>/<nome>[@versão]`	Recusa, mostrando a forma esperada e um exemplo.
Nenhuma ferramenta de IA detectada	Recusa e manda rodar o `makuco init` primeiro.
O Hub não resolve o endereço	Recusa: pode não existir, não estar publicado, ou ter sido apagado — confira no catálogo do Hub.
O item não se aplica a nenhuma ferramenta de IA configurada	Recusa nomeando o que o item declara. Nada é instalado.
O arquivo de destino já pertence a outro item	Recusa por colisão — dois itens não gravam no mesmo caminho.
O arquivo já existe e diverge	Abre decisão (ou aplica o `--policy`). Cópia de segurança antes de substituir.

Instalou, ou só ficou como estava?

Quando o arquivo já existe e a decisão é keep ou skip, a CLI imprime "foi mantido como você deixou no projeto" e sai com 2 — não com 0. Em CI isso é o que distingue "instalei" de "não mexi em nada".

Conteúdo executável

Antes de gravar, a CLI avisa quando o item executa código na sua máquina. Ele vem do Hub e roda com as suas permissões — confira a origem antes de usar.