write-release-notes

Generate Bytebase release notes from git commits, PR graphs, and Terraform impact.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/bytebase/team-skills --skill write-release-notes-bytebase
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: write-release-notes
Source: https://github.com/bytebase/team-skills/tree/main/skills/write-release-notes
Command: npx skills add https://github.com/bytebase/team-skills --skill write-release-notes-bytebase

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Bytebase release notes are time-consuming and error-prone. This skill automates gathering commits, PR context, Terraform impact, and customer feedback to generate accurate release notes.

Core Features & Use Cases

  • Automated release note drafting: analyzes commits, PR DAGs, and Terraform implications to produce a coherent draft.
  • Linear integration: creates and tracks issues for owner confirmations before writing.
  • Version-aware formatting: groups changes by Notable Changes, Features, Enhancements, and Bug Fixes for minor/patch releases.

Quick Start

Provide the latest release context (previous version, target version) and the command to trigger draft generation.

Frequently Asked Questions about write-release-notes

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

FAQPage Schema
How do I automate release notes from git commits and PR context?

Automating release notes from git commits involves analyzing commit history, PR dependency graphs, and Terraform impact to generate a categorized draft. The skill creates a Linear tracking issue for owner sign-off before finalizing user-ready release notes.

What is the best way to generate release notes that include Terraform impact analysis?

Generating release notes with Terraform impact analysis requires parsing git commits and PR graphs to document infrastructure changes. This approach enforces version identification and categorizes changes into Notable Changes, Features, Enhancements, and Bug Fixes.

How do I categorize changelog entries for minor and patch releases?

Categorizing changelog entries for minor and patch releases groups changes into Notable Changes, Features, Enhancements, and Bug Fixes. This version-aware formatting ensures user-ready release notes by structuring commits and PR context coherently.

Does Linear integration support release note owner confirmation workflows?

Linear integration supports release note owner confirmation by creating and tracking issues for sign-off before writing. It enforces owner validation steps after analyzing git commits, Terraform impact, and customer feedback to produce the draft.

Can I use customer feedback to draft accurate release notes automatically?

You can use customer feedback to draft release notes automatically by combining it with git commits, PR dependency graphs, and Terraform impact analysis. The process generates a coherent draft pending owner confirmation before final writing.

Why do I need to provide previous and target version context for release note generation?

Providing previous and target version context is needed for release note generation to enforce version identification and apply version-aware formatting. It determines whether to apply minor or patch release categorization to the analyzed commits and PR graphs.