mcpField
K
keep-a-changelog-generator

keep-a-changelog-generator

github.com/stanfordspezi開発26117 回インストール5 週間前に更新
リポジトリ

keep-a-changelog-generator について

keep-a-changelog-generatorは、Gitの履歴から構造化された変更履歴を作成・管理するスキルです。プロジェクトのメンテナー向けに、Keep a Changelogの分類で変更を整理し、利用者向けの説明や破壊的変更の明示に対応します。

主な機能

  1. 01Git履歴から項目を生成
  2. 02変更を標準カテゴリに分類
  3. 03コミットを利用者向けに記述
  4. 04破壊的変更を明示
  5. 05CHANGELOG.md形式で出力

活用シーン

  1. 01リリース用の変更履歴を作成
  2. 02前バージョン以降の変更を記録
  3. 03プロジェクトのCHANGELOG.mdを管理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/stanfordspezi/spezivibe --skill keep-a-changelog-generator

インストール後、Claude Code で/keep-a-changelog-generatorを入力して読み込まれたか確認します。

詳細

変更履歴ジェネレーター

Keep a Changelog 形式に従って、Git の履歴から変更履歴を生成します。

使用するタイミング

次のような場合に、このスキルを使用してください。

  • リリースの変更履歴エントリーを生成する
  • 前回のバージョン以降の変更を記録する
  • プロジェクトの CHANGELOG.md ファイルを管理する

ハイライト、使用例、移行ガイドを含む、物語形式のリリース告知が必要な場合は、代わりに release-notes-generator を使用してください。このスキルは構造化された CHANGELOG.md ファイルを管理し、もう一方は単一リリースのストーリーを作成します。

変更履歴の形式

Keep a Changelog に従ってください。

# 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]

### Added
- New features

### Changed
- Changes in existing functionality

### Deprecated
- Features that will be removed

### Removed
- Removed features

### Fixed
- Bug fixes

### Security
- Security fixes

変更のカテゴリ

コミットメッセージとコードの変更に基づいて分類します。

カテゴリコミットのキーワード例
追加add, create, implement, introduce新機能、画面
変更update, change, modify, refactor, improveAPI の変更、機能強化
非推奨deprecate削除予定の機能
削除remove, delete, drop削除された機能
修正fix, resolve, correct, patchバグ修正
セキュリティsecurity, vulnerability, CVEセキュリティパッチ

Git コマンド

# Recent commits
git log --oneline -20

# Commits between tags
git log v1.0.0..HEAD --oneline

# Full commit messages
git log --format="%h %s%n%b" HEAD~10..HEAD

# Commits since a date
git log --since="2026-01-01" --oneline

執筆ガイドライン

ユーザー向けの説明

技術的なコミット内容を、ユーザーにとってのメリットに置き換えます。

  • 技術的な説明：「認証ステートマシンをリファクタリング」
  • ユーザー向けの説明：「認証状態管理の信頼性を向上」
破壊的変更

API の変更を明確に示します。

### Changed
- **BREAKING**: `login()` now returns `Promise<User>` instead of `Promise<void>`

出力例

## [1.2.0] - 2026-01-14

### Added
- New health data visualization screen
- Apple HealthKit integration for step counting
- Export health data to PDF

### Changed
- Improved task scheduling performance
- Updated questionnaire UI design

### Fixed
- Fixed race condition in account state initialization
- Resolved infinite loop when no tasks exist

ワークフロー

  1. git log を実行して、前回のリリース以降のコミットを取得します
  2. コミットをカテゴリ（追加／変更／修正など）ごとにまとめます
  3. 破壊的変更を特定します
  4. ユーザー向けの説明を作成します
  5. 利用可能な場合は PR／issue の参照を含めます
  6. Keep a Changelog の構成に従って書式を整えます

コメント

Markdown 対応