AGENT SKILL

changelog-generate

Generate CHANGELOG.md from git history in Keep a Changelog format with Added, Changed, Deprecated, Removed, Fixed, and Security categories

License 许可
MIT
最近更新
2026-10-03
Stars
★ 0
Forks
0

01 前言 Front Matter

name
changelog-generate
license
MIT
metadata
{ "audience": "maintainers", "workflow": "github" }
description
Generate CHANGELOG.md from git history in Keep a Changelog format with Added, Changed, Deprecated, Removed, Fixed, and Security categories
compatibility
opencode

03 SKILL.md 正文

What I do

  • Parse git history (commits, tags, PR titles) since the last release
  • Categorize changes into Keep a Changelog sections
  • Generate or update CHANGELOG.md with properly formatted entries
  • Link entries to commits or PRs where available
  • Determine the appropriate next version based on change types

When to use me

Use this skill when you need to:

  • Generate a changelog for an upcoming release
  • Update CHANGELOG.md after a batch of changes
  • Convert unstructured git history into a formatted changelog
  • Backfill a changelog for a project that doesn't have one

Process

  1. Find the baseline: Identify the last release tag

    git describe --tags --abbrev=0
    
  2. Collect commits: List all commits since the baseline

    git log v1.2.3..HEAD --pretty=format:"%H %s" --reverse
    
  3. Collect merged PRs (if using GitHub):

    gh pr list --state merged --search "merged:>=2024-01-01" --json number,title,labels
    
  4. Categorize: Map each commit/PR to a changelog section

    • feat: or label enhancement -> Added
    • change: or refactor: -> Changed
    • deprecate: -> Deprecated
    • remove: -> Removed
    • fix: or bug: or label bug -> Fixed
    • security: or label security -> Security
    • chore:, ci:, docs:, test: -> Omit unless significant
  5. Format: Write entries following Keep a Changelog

  6. Determine version: Based on the categories present

    • Security or breaking changes -> Major bump consideration
    • Added -> Minor bump
    • Fixed only -> Patch bump
  7. Update file: Prepend the new release section to CHANGELOG.md

Output Format

Follow Keep a Changelog format:

# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

## [1.3.0] - 2024-06-15

### Added
- User export functionality for CSV and JSON formats (#142)
- Rate limiting middleware with configurable thresholds (#138)

### Changed
- Upgraded database driver from v2 to v3 for connection pooling (#145)

### Fixed
- Race condition in concurrent session handling (#140)
- Incorrect timezone conversion for UTC-offset dates (#137)

### Security
- Updated `xml-parser` to 2.1.0 to fix CVE-2024-XXXXX (#143)

## [1.2.3] - 2024-05-01
...

Commit Message Mapping

Prefix Category Example
feat: Added feat: add CSV export
fix: Fixed fix: correct timezone handling
refactor: Changed refactor: simplify auth flow
deprecate: Deprecated deprecate: old v1 endpoint
remove: Removed remove: legacy XML support
security: Security security: patch XSS in templates
perf: Changed perf: optimize query execution
BREAKING CHANGE Changed (noted) flagged with warning

Rules

  • Follow Keep a Changelog specification exactly
  • Always include the [Unreleased] section at the top
  • Each entry should be human-readable, not a raw commit message
  • Include PR or issue numbers as links when available
  • Group related commits into a single changelog entry
  • Do not include internal chores unless they affect end users
  • Dates must use ISO 8601 format (YYYY-MM-DD)
  • Maintain reverse chronological order (newest first)

04 同仓库更多 Skills

balagnanas
balagnanas/LocalMachineAISetup

test-patterns

Generate tests following project conventions with proper patterns for unit, integration, and e2e testing

★ 0
balagnanas
balagnanas/LocalMachineAISetup

git-release

Create consistent releases with changelogs, version bumps, and release notes from git history

★ 0
balagnanas
balagnanas/LocalMachineAISetup

dependency-audit

Scan dependencies for CVEs, outdated packages, license issues, and unused deps to produce a prioritized remediation list

★ 0
balagnanas
balagnanas/LocalMachineAISetup

ci-pipeline

Generate CI/CD pipeline config for detected platform with lint, test, build, and deploy stages

★ 0
balagnanas
balagnanas/LocalMachineAISetup

list-models

List the models available from the OpenCode Zen (provider ID `opencode`, API base https://opencode.ai/zen/v1) and OpenCode Go (provider ID `opencode-go`, API base https://opencode.ai/zen/go/v1) providers. Runs `opencode models opencode` / `opencode models opencode-go` for plain id lists or `--verbose` for per-model metadata (display name, cost, context window, capabilities). Use when the user asks what models are available in OpenCode Zen or OpenCode Go, wants to browse `opencode/...` or `opencode-go/...` model ids, or needs model cost, context-size, or capability details.

★ 0
balagnanas
balagnanas/LocalMachineAISetup

list-models

List the models available from the OpenCode Zen (provider ID `opencode`, API base https://opencode.ai/zen/v1) and OpenCode Go (provider ID `opencode-go`, API base https://opencode.ai/zen/go/v1) providers. Runs `opencode models opencode` / `opencode models opencode-go` for plain id lists or `--verbose` for per-model metadata (display name, cost, context window, capabilities). Use when the user asks what models are available in OpenCode Zen or OpenCode Go, wants to browse `opencode/...` or `opencode-go/...` model ids, or needs model cost, context-size, or capability details.

★ 0