Pular para o conteúdo
Veritas
  • Nada com esse termo. Tente o nome de uma lib ou de uma stack.

Títulos, descrições e seções de todas as skills.

Atualiza o Veritas para a última versão publicada e informa em um relatório único o que deu certo, o que falhou e o que falta. Só roda quando a pessoa chama.

Atualizar o Veritas

Instruções para você, o agente. A pessoa chamou /veritas:atualizar, ou aceitou o aviso de versão nova.

Regra de saída, acima de tudo: não narre os passos enquanto executa. Execute em silêncio e termine com um único relatório, no formato da última seção. Uma vez só. Sem "vou verificar…", sem "agora vou baixar…", sem repetir o relatório depois de uma pergunta.

0. Teste a capacidade, não o ambiente

Isto decide tudo o que vem depois, e errar aqui produz um relatório mentiroso.

Não tente adivinhar em que ambiente você está. Teste diretamente a única coisa que importa — se você consegue falar com o GitHub:

gh release view --repo Caiorhcp/veritas --json tagName 2>&1 | head -3

Respondeu com a tag — siga o fluxo normal, passos 1 a 4.

Não respondeu — gh ausente, sem autenticação ou sem rede. Você não consegue consultar a Release nem instalar nada daqui. Emita o relatório com estado não verificável aqui e entregue os comandos para ela rodar no próprio terminal.

Não diga falhou, e não diga que ela precisa instalar o gh. Você não tem como saber se o gh falta na máquina dela ou só no lugar de onde você executa. Se faltar mesmo, ela descobre no primeiro comando que rodar, e a mensagem do próprio gh é mais clara que o seu palpite.

Por que não adivinhar o ambiente. A versão anterior desta skill decidia por alcance ao disco (ls ~/.claude, ls ~/workspace) e chamava de sandbox tudo que não os encontrasse. Existe um terceiro caso que essa conta não previa, e é onde o Cowork cai: alcança o disco da pessoa por um caminho montado, mas não tem gh nem credencial. A resposta saía certa por coincidência. Capacidade se testa usando, não deduzindo.

Se o gh responde, ainda falta uma pergunta

Funcionar não basta: o arquivo precisa cair onde ela alcança. Antes de reportar baixado, confira onde o download parou:

pwd && ls -la *.plugin

Se o caminho não é um que ela reconhece e consegue abrir, o arquivo caiu num isolamento e some. Nesse caso o estado é não verificável aqui, não baixado — reportar sucesso de um arquivo que ninguém vai encontrar é a pior saída possível.

1. Levante o estado

gh release view --repo Caiorhcp/veritas --json tagName,publishedAt,body

Versão instalada: campo version de .claude-plugin/plugin.json do plugin.

Se já estiver na última, emita o relatório com estado já atualizado e pare.

2. Antes de tocar em nada, cheque edição local

Se a pessoa tem o repositório clonado:

cd ~/workspace/veritas && git status --short plugin/

Se houver mudança não commitada em plugin/skills/, pare. Não atualize. Emita o relatório com estado bloqueado e liste os arquivos — instalar por cima apaga aquilo em silêncio, e trabalho perdido sem aviso é pior que ficar desatualizado.

3. Atualize

Depende de como o plugin foi instalado. Descubra usando: claude plugin marketplace list mostra a marketplace veritas e a origem dela.

Claude Code, marketplace do GitHub (Source: GitHub):

claude plugin marketplace update veritas
claude plugin update veritas@veritas

Claude Code, marketplace de pasta local (Source: Directory): o git pull sozinho não basta, porque o plugin instalado é uma cópia.

cd ~/workspace/veritas && git pull
claude plugin marketplace update veritas
claude plugin update veritas@veritas

Nos dois casos, a versão nova só vale depois de reiniciar o Claude Code: isso vai em falta você fazer.

Cowork, ou sem claude no PATH:

gh release download --repo Caiorhcp/veritas --pattern "*.plugin" --clobber

O download entrega o arquivo; quem instala é a pessoa, arrastando para uma conversa. Isso conta como falta você fazer, não como falha.

4. Emita o relatório

Um bloco, no formato abaixo. Preencha só as seções que se aplicam.

VERITAS — atualização

  Antes     v0.1.0
  Agora     v0.2.0
  Estado    atualizado

  Novidades
    · menu /veritas:ajuda
    · skill atomic-design

  Falta você fazer
    1. Reiniciar o Claude — plugins carregam na abertura da sessão

Estados possíveis: atualizado, já atualizado, baixado, bloqueado, não verificável aqui, falhou.

Modelo do estado não verificável aqui:

VERITAS — atualização

  Instalada   v0.2.0
  Publicada   não consegui consultar
  Estado      não verificável aqui — o gh não respondeu de onde eu executo

  Falta você fazer
    1. No seu terminal:
       gh release view --repo Caiorhcp/veritas
    2. Se houver versão mais nova:
       gh release download --repo Caiorhcp/veritas --pattern "*.plugin"
    3. Arrastar o .plugin para uma conversa e instalar por cima

Diga o que falhou e o que a pessoa faz agora. Nunca só "deu erro".

O que aconteceu Escreva em "Falta você fazer"
gh não respondeu no passo 0 Não é falha — estado não verificável aqui. Entregue os comandos para ela rodar no terminal dela, e o link: https://github.com/Caiorhcp/veritas/releases/latest. Não mande instalar o gh: você não sabe se ele falta lá
gh respondeu, mas pede autenticação Rodar gh auth login, depois /veritas:atualizar de novo
Nenhuma release publicada Nada a fazer — use a instalação pela marketplace (claude plugin marketplace add Caiorhcp/veritas)
Sem rede Tentar de novo quando houver conexão
git pull com conflito Resolver o conflito, ou git stash se a mudança local não importa — links não ajudam aqui, mostre os arquivos em conflito
Mudança local não commitada Transformar em PR antes: git checkout -b minha-regra, commit, gh pr create

Exemplo de relatório de falha:

VERITAS — atualização

  Antes     v0.1.0
  Agora     v0.1.0 (sem mudança)
  Estado    falhou — gh não encontrado no PATH

  Falta você fazer
    1. Baixar: https://github.com/Caiorhcp/veritas/releases/latest
    2. Arrastar o .plugin para uma conversa e instalar por cima
    3. Reiniciar o Claude

Publicar, do outro lado

Se quem chamou é a pessoa que cuida do banco e quer publicar:

# na pasta plugin/; 1. subir o version em .claude-plugin/plugin.json
uv run pytest tests/ -v
uv run python tools/empacotar.py
gh release create v0.3.0 dist/veritas.plugin --notes "o que mudou"

Origem

Banco de skills do Veritas, skill atualizar. Correções vão por PR no repositório, não editando a cópia local.

Ver no GitHub →