changelog-generator

変更履歴ジェネレーター

使用する場面

• 新しいバージョンのリリースノートを準備するとき
• 週次または月次の製品アップデートの概要を作成するとき
• 顧客向けに変更内容を記録するとき
• アプリストアへの申請用に変更履歴を作成するとき
• アップデート通知を生成するとき
• 社内向けのリリース資料を作成するとき
• 公開している変更履歴／製品アップデートページを管理するとき

このスキルでできること

1. Git 履歴をスキャン：特定の期間、またはバージョン間のコミットを分析します
2. 変更を分類：コミットを論理的なカテゴリ（機能、改善、バグ修正、破壊的変更、セキュリティ）に分類します
3. 技術的な表現をユーザー向けに変換：開発者向けのコミット内容を顧客向けの表現に変換します
4. フォーマット：構造化された変更履歴を作成します
5. 不要な情報を除外：内部向けのコミット（リファクタリング、テストなど）を除外します
6. ガイドラインを適用：変更履歴の慣例とブランドのトーンに従います

使用方法

基本的な使い方

プロジェクトのリポジトリから実行します。

Create a changelog from commits since last release

Generate changelog for all commits from the past week

Create release notes for version 2.5.0

特定の日付範囲を指定する場合

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

カスタムガイドラインを指定する場合

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

例

ユーザー：「過去7日間のコミットから変更履歴を作成してください」

出力：

# 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

着想元： Lenny's Newsletter で紹介された Manik Aggarwal のユースケース

ヒント

• Git リポジトリのルートから実行します
• 対象を絞った変更履歴を作成するには、日付範囲を指定します
• 一貫したフォーマットにするには、CHANGELOG_STYLE.md を使用します
• 公開する前に、生成された変更履歴を確認して調整します
• 出力を CHANGELOG.md に直接保存します

関連するユースケース

• GitHub リリースノートの作成
• アプリストアのアップデート説明文の作成
• ユーザー向けメールアップデートの生成
• ソーシャルメディア告知投稿の作成