Curadoria

Ver como MarkdownA mesma página em texto puroAbrir no ChatGPTPerguntar sobre esta páginaAbrir no ClaudePerguntar sobre esta página

Como o conteúdo vendorizado é renovado, e o que um candidato precisa ser para ganhar lugar no catálogo.

Esta página cobre as duas perguntas que decidem o que o overpower carrega: como o conteúdo vindo de fora é renovado sem derivar, e o que um candidato tem de ser antes de ganhar lugar no catálogo.

Antes de começar

O ambiente de desenvolvimento montado, e a referência nova lá de cima em mãos. Renovar o catálogo é algo que uma pessoa faz à mão, de propósito, e não um job agendado.

Os passos

1. Ler o manifesto de lá em cima, na referência nova

   Para o mattpocock/skills, é o array skills de .claude-plugin/plugin.json, e especificamente nunca o campo version ao lado dele, que foi medido parado enquanto o array se movia.

   git -C ../skills show <ref>:.claude-plugin/plugin.json

2. Trocar a árvore e atualizar a atribuição

   Se o que aterrissa não é a árvore versionada verbatim, a transformação acontece na curadoria e o que é vendorizado é a saída dela. Atualize o NOTICE, com a referência e o commit por origem, e o licenses/ se o arquivo de licença lá em cima mudou de lugar.

   uv run pytest tests/test_content.py

3. Rodar os quatro comandos, mais o teste de rede

   O teste que toca o GitHub de verdade é passo de curadoria, e não portão.

   OVERPOWER_NETWORK_TESTS=1 uv run pytest -m network

4. Subir a versão

   A versão do overpower é a versão do catálogo que ele embute, então uma renovação que ninguém consegue instalar não é renovação.

   uv version --bump minor

Verificação

Confirme que o item novo aparece no catálogo e abre por inteiro:

uvx overpower@latest list

uvx overpower@latest list --skill <nome>

O list nu imprime o catálogo em quatro blocos, e o item novo tem de estar no bloco da classe dele. Com o seletor, a saída traz o tamanho, a contagem de arquivos e a descrição por inteiro, nunca truncada, mais a linha que instala o item.

Um portão bloqueia o que este repositório controla. O que depende de terceiro é verificado aqui, à mão, porque automatizar uma conferência contra o repositório de outra pessoa poria a disponibilidade e a estabilidade de um terceiro dentro da CI deste projeto, o que foi medido instável e recusado exatamente por isso.

Este último passo deixou de ser algo a lembrar. O src/overpower/content/ está dentro da wheel, então o release-ready recusa o pull request até que a subida aconteça.