metyatech/skill-release-publish

Fluxo de release e publicação

Metadados do repositório público

• Para um repositório público, o agente DEVE definir os campos Descrição, Tópicos e Homepage do GitHub.
• Um repositório público DEVE conter: .github/workflows/ci.yml, templates de issue, um template de PR, SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md e CHANGELOG.md.
• A CI DEVE executar os comandos padrão de lint, teste e construção do repositório.

Versionamento e fluxo de release

• O agente DEVE atualizar os metadados de versão quando o conteúdo da release mudar e DEVE manter a versão do pacote e a tag Git consistentes.
• Quando solicitado a escolher uma versão, o agente DEVE decidir por si próprio.
• Ao incrementar uma versão, o agente DEVE criar a GitHub Release e publicar o pacote na mesma atualização.
• Para publicação npm em pacotes de propriedade da metyatech, o agente DEVE executar npm publish diretamente. Um token de automação está configurado.
• Para outros pacotes, o agente DEVE pedir ao usuário que execute npm publish.
• Antes de publicar, o agente DEVE executar os comandos de preparação necessários (npm install, npm test, npm pack --dry-run, etc.) e DEVE prosseguir somente quando estiver pronto.
• Se a autenticação falhar durante a publicação, o agente DEVE pedir ao usuário que conclua a etapa de publicação.
• O agente DEVE executar verificações de segurança de dependências antes da release, DEVE tratar problemas críticos e DEVE relatar os resultados.

Verificação pós-publicação

Após publicar, o agente DEVE atualizar qualquer cópia instalada localmente para a release recém-publicada e DEVE verificar a versão resolvida. O agente NÃO DEVE relatar "concluído" até que esta verificação seja concluída (ou o usuário recuse explicitamente).

O agente DEVE expressar a verificação como critérios de aceitação explícitos com resultados (PASS / FAIL / N/A) e evidências:

• AC1 (registro) — verificar se a versão publicada existe no registro (por exemplo, npm view <pkg> version).
• AC2 (instalação limpa) — verificar se o pacote mais recente resolve e executa (por exemplo, npx <pkg>@latest --version).
• AC3 (atualização global, se aplicável) — se o pacote estiver instalado globalmente, atualizá-lo para a versão publicada e verificar (por exemplo, npm ls -g <pkg> --depth=0, npm i -g <pkg>@latest, depois <cmd> --version). Se AC3 não for aplicável, o agente DEVE marcá-lo como N/A e declarar o motivo explicitamente.

Para CLIs npm:

• Se instalado globalmente: verificar npm ls -g <pkg> --depth=0, atualizar via npm i -g <pkg>@latest, depois verificar com <pkg> --version.
• Se não estiver instalado globalmente: pular a atualização global e verificar a disponibilidade via npx <pkg>@latest --version (ou o equivalente do ecossistema).

Tópicos padrão do repositório

O agente DEVE atribuir tópicos do conjunto padrão abaixo. Cada repositório DEVE ter pelo menos um tópico padrão quando aplicável. Um repositório que não corresponda a nenhum tópico padrão DEVE usar tópicos descritivos relevantes ao seu domínio.

• agent-skill — repositório contém um SKILL.md (uma habilidade de agente instalável).
• agent-tool — ferramenta CLI ou servidor MCP usado por agentes (por exemplo, task-tracker, agents-mcp, compose-agentsmd).
• agent-rule — fonte de regra ou repositório de conjunto de regras (por exemplo, agent-rules).
• unreal-engine — plugin do Unreal Engine ou projeto de exemplo.
• qti — ferramenta ou biblioteca do ecossistema de avaliação QTI.
• education — conteúdo de curso, materiais de ensino ou plataforma voltada para estudantes.
• docusaurus — plugin ou extensão do Docusaurus.

Tópicos descritivos adicionais (linguagem, framework, palavras-chave de domínio) PODEM ser adicionados livremente junto dos tópicos padrão. O agente DEVE revisar e atualizar o conjunto de tópicos padrão quando a paisagem do repositório mudar materialmente. O agente DEVE verificar se os tópicos estão definidos como parte da verificação de conformidade de novo repositório.

Requisitos do artefato publicado

• O agente DEVE preencher os metadados do pacote (name, description, repository, issues, homepage, engines).
• O agente DEVE validar pontos de entrada executáveis e shebangs necessários para que os comandos instalados funcionem.
• Se um repositório representar uma única ferramenta ou produto, o agente DEVE publicar um único pacote (agrupando scripts relacionados).