metyatech/skill-release-publish

Flujo de trabajo de lanzamiento y publicación

Metadatos del repositorio público

• Para un repositorio público, el agente DEBE configurar la Descripción, Temas y el campo Página de inicio de GitHub.
• Un repositorio público DEBE contener: .github/workflows/ci.yml, plantillas de issues, una plantilla de PR, SECURITY.md, CONTRIBUTING.md, CODE_OF_CONDUCT.md y CHANGELOG.md.
• La CI DEBE ejecutar los comandos estándar de lint, prueba y compilación del repositorio.

Control de versiones y flujo de lanzamiento

• El agente DEBE actualizar los metadatos de versión cuando el contenido del lanzamiento cambie y DEBE mantener la versión del paquete y la etiqueta Git consistentes.
• Cuando se le pida elegir una versión, el agente DEBE decidirla por sí mismo.
• Al incrementar una versión, el agente DEBE crear el GitHub Release y publicar el paquete en la misma actualización.
• Para publicaciones npm en paquetes propiedad de metyatech, el agente DEBE ejecutar npm publish directamente. Hay un token de automatización configurado.
• Para otros paquetes, el agente DEBE pedir al usuario que ejecute npm publish.
• Antes de publicar, el agente DEBE ejecutar los comandos previos requeridos (npm install, npm test, npm pack --dry-run, etc.) y DEBE proceder solo cuando esté listo.
• Si la autenticación falla durante la publicación, el agente DEBE pedir al usuario que complete el paso de publicación.
• El agente DEBE ejecutar comprobaciones de seguridad de dependencias antes del lanzamiento, DEBE abordar problemas críticos y DEBE informar los resultados.

Verificación posterior a la publicación

Después de publicar, el agente DEBE actualizar cualquier copia instalada localmente a la versión recién publicada y DEBE verificar la versión resuelta. El agente NO DEBE informar "hecho" hasta que esta verificación se complete (o el usuario decline explícitamente).

El agente DEBE expresar la verificación como criterios de aceptación explícitos con resultados (PASS / FAIL / N/A) y evidencia:

• AC1 (registro) — verificar que la versión publicada existe en el registro (ej., npm view <pkg> version).
• AC2 (instalación limpia) — verificar que el último paquete se resuelve y se ejecuta (ej., npx <pkg>@latest --version).
• AC3 (actualización global, si aplica) — si el paquete está instalado globalmente, actualizarlo a la versión publicada y verificar (ej., npm ls -g <pkg> --depth=0, npm i -g <pkg>@latest, luego <cmd> --version). Si AC3 no aplica, el agente DEBE marcarlo como N/A y declarar la razón explícitamente.

Para CLI de npm:

• Si está instalado globalmente: comprobar npm ls -g <pkg> --depth=0, actualizar mediante npm i -g <pkg>@latest, luego verificar con <pkg> --version.
• Si no está instalado globalmente: omitir la actualización global y verificar la disponibilidad mediante npx <pkg>@latest --version (o el equivalente del ecosistema).

Temas estándar del repositorio

El agente DEBE asignar temas del conjunto estándar a continuación. Cada repositorio DEBE tener al menos un tema estándar cuando sea aplicable. Un repositorio que no coincida con ningún tema estándar DEBE usar temas descriptivos relevantes para su dominio.

• agent-skill — el repositorio contiene un SKILL.md (una habilidad de agente instalable).
• agent-tool — herramienta CLI o servidor MCP utilizado por agentes (ej., task-tracker, agents-mcp, compose-agentsmd).
• agent-rule — fuente de reglas o repositorio de conjuntos de reglas (ej., agent-rules).
• unreal-engine — plugin de Unreal Engine o proyecto de ejemplo.
• qti — herramienta o biblioteca del ecosistema de evaluación QTI.
• education — contenido de cursos, materiales educativos o plataforma orientada a estudiantes.
• docusaurus — plugin o extensión de Docusaurus.

Se PUEDEN agregar libremente temas descriptivos adicionales (idioma, framework, palabras clave de dominio) junto a los temas estándar. El agente DEBE revisar y actualizar el conjunto de temas estándar cuando el panorama del repositorio cambie materialmente. El agente DEBE verificar que los temas se establezcan como parte del control de cumplimiento del nuevo repositorio.

Requisitos del artefacto publicado

• El agente DEBE completar los metadatos del paquete (nombre, descripción, repositorio, issues, página de inicio, engines).
• El agente DEBE validar los puntos de entrada ejecutables y los shebangs requeridos para que los comandos instalados funcionen.
• Si un repositorio representa una sola herramienta o producto, el agente DEBE publicar un único paquete (agrupando scripts relacionados).