version-release

Automates GitHub release workflows for minor, patch, hotfix, and DB migration releases.

74|11|Updated Jul 4, 2024
One-click install
npx skills add https://github.com/OpenSourceAGI/qwksearch-research-agent --skill version-release-opensourceagi
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: version-release
Source: https://github.com/OpenSourceAGI/qwksearch-research-agent/tree/main/apps/qwk-in-lobe/.agents/skills/version-release
Command: npx skills add https://github.com/OpenSourceAGI/qwksearch-research-agent --skill version-release-opensourceagi

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Coordinating software releases across canary and main branches involves strict PR title formats, CI trigger rules, and error-prone changelog writing where hallucinated PR numbers and wrong compare bases are common failure modes. This Skill routes each release type to the correct procedure and enforces git-derived facts for release notes. ## Core Features & Use Cases - Release Routing: Directs minor releases, weekly patch releases, hotfixes, model launches, and DB migrations to the correct step-by-step reference workflow. - CI Trigger Rules: Documents exactly which PR title prefixes and branch names trigger the auto-tag-release workflow, and which do not. - Verified Release Notes: Enforces hard rules requiring every PR reference, metric, and contributor handle to be computed from git and gh commands, with a mandatory pre-publish verification diff. - Use Case: When asked to ship the weekly release, the agent branches from canary, computes the previous semver tag from main, derives all PR refs from commit subjects, writes the changelog per the style guide, and creates the PR with the correct title format. ## Quick Start Ask the agent to prepare a weekly patch release from canary to main with verified release notes.

Frequently Asked Questions about version-release

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

FAQPage Schema
How do I create a minor release PR that triggers auto-tagging?

Create a release branch from canary, then open a PR to main with the exact title format "🚀 release: v{x.y.z}". The CI workflow parses this title to bump package.json, create the tag, and publish the GitHub Release automatically.

How do I write GitHub release notes without wrong PR numbers?

Compute the previous semver tag with git describe on origin/main, extract PR refs from commit subjects in that range, and verify every cited PR against that canonical set before publishing. Never infer PR numbers from memory or feature descriptions.

Which PR title prefixes trigger an automatic patch release?

Titles starting with style, feat, fix, refactor, hotfix, or build (with their gitmoji variants) trigger auto patch +1 after merging to main. Branches named hotfix/* or release/* trigger directly regardless of title. Docs, chore, ci, and test PRs do not trigger releases.

Should a hotfix branch be created from canary or main?

Hotfix branches must be created from main, since they ship emergency fixes directly. Only weekly release branches are created from canary. Verify the base with git merge-base --is-ancestor before proceeding.

What is the difference between hotfix and weekly release notes?

Hotfix notes are short-form: a scope line, one thesis quote, 1-3 fix bullets, upgrade notes, and a single owner. Weekly releases use the long-form structure with highlights, domain sections, metrics, and a contributor list.