AgentSkillsCN

create-changelog

从Git提交中自动生成非技术性的变更日志。

SKILL.md
--- frontmatter
name: create-changelog
description: Creates non-technical changelogs from git commits.

Changelog Generator

This skill transforms technical git commits and pull requests into polished, user-friendly changelogs that users and non-technical team-members will understand and appreciate.

Rules

  • Ensure no internal-only changes are mentioned
  • Language should be non-technical, clear and concise
  • Provide only the final answer as markdown, without additional commentary or explanation
  • Do not publish or tag releases automatically.

What This Skill Does

  1. Scans Git History: Analyzes commits from a specific time period or between versions
  2. Categorizes Changes: Groups commits into logical categories (features, improvements, bug fixes, breaking changes, security)
  3. Translates Technical → User-Friendly: Converts developer commits into customer language
  4. Formats Professionally: Creates clean, structured changelog entries
  5. Filters Noise: Excludes internal commits (refactoring, tests, etc.)
  6. Follows Best Practices: Applies changelog guidelines and your brand voice

How to Use

Basic Usage

From your project repository:

code
Create a changelog from commits since last release
code
Generate changelog for all commits from the past week
code
Create release notes for version 2.5.0

With Specific Date Range

code
Create a changelog for all commits between March 1 and March 15

With Custom Guidelines

code
Create a changelog for commits since v2.4.0, using my changelog
guidelines from CHANGELOG_STYLE.md

Example Output

User: "Create a changelog for commits from the past 7 days"

Output:

markdown
# Updates - Week of March 10, 2024

## ✨ New Features

- **Team Workspaces**: Create separate workspaces for different
  projects. Invite team members and keep everything organized.

- **Keyboard Shortcuts**: Press ? to see all available shortcuts.
  Navigate faster without touching your mouse.

## 🔧 Improvements

- **Faster Sync**: Files now sync 2x faster across devices
- **Better Search**: Search now includes file contents, not just titles

## 🐛 Fixes

- Fixed issue where large images wouldn't upload
- Resolved timezone confusion in scheduled posts
- Corrected notification badge count

Related Use Cases

  • Creating GitHub release notes
  • Writing app store update descriptions
  • Generating email updates for users
  • Creating social media announcement posts