--- name: changelog-generator description: Generate comprehensive changelogs from git history following Keep a Changelog format. Use when creating release notes or maintaining version history. --- # Changelog Generator Skill Gitコミット履歴から美しいChangelogを自動生成するスキルです。 ## 概要 Git コミットメッセージを解析し、Conventional Commits形式やKeep a Changelog形式の整理されたChangelogを生成します。 ## 主な機能 - **自動カテゴリ分類**: feat, fix, docs, refactor等 - **セマンティックバージョニング**: 変更内容からバージョン推定 - **Markdown/HTML出力**: 複数形式対応 - **リンク自動生成**: Issue, PR, コミットへのリンク - **Breaking Changes検出**: 互換性のない変更を強調 - **Contributors リスト**: 貢献者の自動抽出 - **リリースノート**: プレスリリース形式の生成 ## 使用方法 ### 基本的なChangelog生成 ``` Gitコミット履歴からChangelogを生成： 期間: v1.0.0..HEAD 形式: Keep a Changelog ``` ### 詳細設定 ``` Changelogを生成： - 期間: 2024-01-01..2024-06-30 - 形式: Conventional Commits - グループ化: タイプ別 - リンク: GitHub Issue, PR - 貢献者リスト: 含める ``` ## 出力例 ### Keep a Changelog 形式 ```markdown # 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.0.0/), and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html). ## [Unreleased] ## [2.1.0] - 2024-06-15 ### Added - User authentication with JWT tokens (#123) - Real-time notifications via WebSocket (#145) - Dark mode support (#156) - Export data to CSV feature (#167) ### Changed - Improved search algorithm performance by 60% (#134) - Updated UI design for better accessibility (#142) - Migrated from REST to GraphQL for user API (#151) ### Fixed - Fixed memory leak in file upload (#128) - Resolved CORS issues on production (#139) - Fixed pagination bug in user list (#147) ### Security - Updated dependencies with known vulnerabilities (#155) - Implemented rate limiting on API endpoints (#161) ### Deprecated - `/api/v1/users` endpoint (use `/api/v2/users` instead) (#149) ## [2.0.0] - 2024-03-20 ### Added - Complete redesign of the admin dashboard - Multi-language support (EN, JP, ES, FR) - Two-factor authentication ### Changed - **BREAKING**: Changed API response format from XML to JSON - **BREAKING**: Renamed `getUserData()` to `fetchUser()` - Minimum Node.js version is now 18.x ### Removed - **BREAKING**: Removed deprecated `/api/legacy` endpoints - Dropped support for IE11 ## [1.5.2] - 2024-01-10 ### Fixed - Critical bug in payment processing - Session timeout issues ## Contributors Thank you to all contributors who made this release possible: - @john-doe (15 commits) - @jane-smith (12 commits) - @developer123 (8 commits) [Unreleased]: https://github.com/user/repo/compare/v2.1.0...HEAD [2.1.0]: https://github.com/user/repo/compare/v2.0.0...v2.1.0 [2.0.0]: https://github.com/user/repo/compare/v1.5.2...v2.0.0 [1.5.2]: https://github.com/user/repo/releases/tag/v1.5.2 ``` ### Conventional Commits 形式 ```markdown # Release Notes - v2.1.0 **Release Date**: 2024-06-15 ## 🚀 Features - **auth**: Add JWT authentication system ([#123](https://github.com/user/repo/pull/123)) - Implement token generation and validation - Add refresh token mechanism - Session management improvements - **notifications**: Real-time WebSocket notifications ([#145](https://github.com/user/repo/pull/145)) - Push notifications for important events - Configurable notification preferences - **ui**: Dark mode support ([#156](https://github.com/user/repo/pull/156)) - Theme toggle in user settings - Persists user preference ## 🐛 Bug Fixes - **upload**: Fix memory leak in file upload handler ([#128](https://github.com/user/repo/pull/128)) - **api**: Resolve CORS configuration issues ([#139](https://github.com/user/repo/pull/139)) - **pagination**: Fix off-by-one error in user list ([#147](https://github.com/user/repo/pull/147)) ## ⚡ Performance - **search**: Improve search algorithm (60% faster) ([#134](https://github.com/user/repo/pull/134)) - **database**: Add indexes to frequently queried columns ## 📝 Documentation - **api**: Update API documentation with new endpoints - **readme**: Add contribution guidelines - **examples**: Add code examples for authentication ## 🔒 Security - **deps**: Update vulnerable dependencies ([#155](https://github.com/user/repo/pull/155)) - **api**: Implement rate limiting ([#161](https://github.com/user/repo/pull/161)) ## 🎨 Refactoring - **components**: Reorganize React components structure - **types**: Improve TypeScript type definitions ## ⚠️ Breaking Changes None in this release ## 📊 Statistics - **Commits**: 47 - **Contributors**: 8 - **Files Changed**: 156 - **Lines Added**: 3,421 - **Lines Removed**: 1,892 ## 🙏 Contributors - @john-doe - 15 commits - @jane-smith - 12 commits - @developer123 - 8 commits - @contributor456 - 6 commits - @newbie789 - 3 commits - @bugfixer - 2 commits - @docs-writer - 1 commit ``` ## Conventional Commits タイプ - `feat`: 新機能 - `fix`: バグ修正 - `docs`: ドキュメント - `style`: コードスタイル（フォーマット等） - `refactor`: リファクタリング - `perf`: パフォーマンス改善 - `test`: テスト追加・修正 - `chore`: ビルド、ツール等 - `ci`: CI設定 - `build`: ビルドシステム - `revert`: 変更の取り消し ## カスタマイズ ``` Changelogを生成： 設定: - スコープ: v2.0.0..v2.5.0 - 除外: "chore", "style" - グループ化: モジュール別 - フォーマット: HTML - テンプレート: カスタム - Breaking Changes: 別セクションで強調 - リンク先: GitHub ``` ## 統合 ### GitHub Release ``` GitHub Releaseノートを生成： タグ: v2.1.0 含める: - What's Changed - New Contributors - Full Changelog link ``` ### NPM/PyPI ``` npm/PyPI用のリリースノート生成： バージョン: 2.1.0 ハイライト: 主要な機能と修正 インストール手順含む ``` ## ベストプラクティス 1. **Conventional Commits使用**: 自動化しやすい 2. **セマンティックバージョニング**: バージョン番号に意味を持たせる 3. **定期的な更新**: リリース毎に更新 4. **ユーザー視点**: 技術的詳細より影響を記載 5. **Breaking Changes明記**: アップグレードガイド提供 ## バージョン情報 - スキルバージョン: 1.0.0 - 最終更新: 2025-01-22 --- **使用例**: ``` 最新リリースのChangelogを生成： - 形式: Keep a Changelog - 前回タグ: v2.0.0 - 現在: HEAD - GitHub リンク含む - 貢献者リスト含む ``` 完全なChangelogが生成されます！