release-maintainer

Coordinate Rudder releases across npm, git, and GitHub Releases.

280|30|Updated Mar 30, 2026
One-click install
npx skills add https://github.com/Undertone0809/rudder --skill release-maintainer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: release-maintainer
Source: https://github.com/Undertone0809/rudder/tree/main/.agents/skills/maintainer/release-maintainer
Command: npx skills add https://github.com/Undertone0809/rudder --skill release-maintainer

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill prevents failed or inconsistent Rudder releases by coordinating npm dist-tags, git tags, GitHub Releases, Desktop portable assets, and release verification into a single controlled workflow.

Core Features & Use Cases

  • End-to-end release orchestration: Plans and executes canary and stable release steps across npm, git, GitHub Releases, and Desktop assets while honoring authorized scope.
  • Safety-first promotion policy: Enforces rules around canary vs stable promotion, latest movement, version immutability, and verification gates (including real Desktop update drills for stable).
  • Partial failure recovery guidance: Provides targeted remediation for common breakdowns (tag/release missing, Desktop assets missing, checksums stale, dist-tag breakage) without republishing immutable artifacts.
  • Operational state discovery: Uses local and remote checks (git status/logs/tags, npm versions/dist-tags, GitHub Actions runs/releases) to build an accurate release plan.

Quick Start

Run this skill when you want to release Rudder (e.g., “现在要做什么/帮我发版”) so it produces a concrete canary or stable plan and, if authorized, executes the verified workflow steps.

Frequently Asked Questions about release-maintainer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I repair a broken npm latest dist-tag without republishing an immutable version?

To repair a broken npm latest dist-tag, you move the existing tag pointer to the correct immutable version without republishing the artifact. The workflow enforces tag repair and rollback-by-dist-tag recovery to fix dist-tag breakage safely.

What is the correct sequencing for promoting a canary release to stable across npm and GitHub?

Canary to stable promotion requires enforcing correct tag and verification sequencing across npm, git, and GitHub Releases. The workflow applies a safety-first promotion policy, ensuring latest movement and version immutability are honored before finalizing.

How to troubleshoot missing Desktop portable assets and stale checksums during a GitHub Release?

Troubleshooting missing Desktop portable assets and stale checksums involves targeted partial failure recovery guidance. The workflow identifies whether assets or checksums are missing and remediates the breakdown without republishing immutable artifacts.

How do I perform a first-time npm bootstrap for a new release workflow?

First-time npm bootstrap requires reading canonical release docs and repository workflows to build an operational state plan. The workflow uses local and remote checks with git, gh, and npm to establish a deterministic release plan before user-authorized publishing.

How do I run smoke testing and real Desktop update drills before a stable release?

Smoke testing and real Desktop update drills act as verification gates before stable promotion. The workflow enforces these safety-first policies, running deterministic release scripts to verify the update path works before authorizing the final publish.

What should I do if a git tag is missing but the GitHub Release was already created?

If a git tag is missing after a GitHub Release is created, you must follow partial failure recovery guidance to synchronize state. The workflow performs live state checks with git and gh to build an accurate release plan and remediate the missing tag.