チェンジログジェネレーター
Conventional Commitsから自動グルーピング、破壊的変更検出、複数の出力形式で構造化されたCHANGELOG.mdを生成します。
このツールについて
チェンジログジェネレーターは、Conventional Commitsを整理されたCHANGELOG.md ファイルに変換する無料のブラウザベースツールです。Git履歴を手動で ソートしてリリースノートを書く代わりに、コミットメッセージを 貼り付けるだけで、公開可能なチェンジログが数秒で得られます。
ツールはConventional Commits仕様に
従って各行を解析します。feat、fix、docs、perf、
refactor、test、build、ci、choreなどのコミットタイプは
自動的に認識され、人間が読みやすいセクションにグルーピングされます。
feat(auth): add OAuth2のようなスコープ付きコミットは、
スコープが太字のプレフィックスとして保持されます。破壊的変更は
!マーカー(例:feat!:)またはBREAKING CHANGEフッターから
検出され、先頭の目立つセクションに表示されます。
3つの出力形式に対応しています。Keep a Changelogは keepachangelog.comの規約に従い、Added、 Changed、Fixed、Removedセクションで構成されます。Simpleは 元のコミットタイプラベルでグループ化したフラットなリストを出力します。 GitHub ReleasesはGitHubリリース本文に貼り付けるのに最適な マークダウンを生成します。
このツールは他のDevToolboxユーティリティとうまく連携します。2つのチェンジログバージョンを
比較するにはDiff Viewerを、生成されたマークダウンを
リアルタイムでレンダリングするにはMarkdown Previewを、
2つのタグ間のコミットを抽出するgit logコマンドを構築するには
Git Command Builderをご利用ください。
すべての処理はブラウザ内で完結します。コミットメッセージがお使いの 端末から外に出ることはなく、サーバーとのやり取り、ログ記録、 サードパーティサービスの関与はありません。プライベートリポジトリの 履歴や未リリースの機能詳細でも安全に使用できます。
使い方
- 左側のコミットメッセージテキストエリアにコミットメッセージを貼り付けます(1行に1コミット)。各行はConventional Commits形式:
type(scope): descriptionに従ってください。 - バージョン入力フィールドにリリースのバージョン番号(例:
1.2.0)を入力します。 - デートピッカーで日付を選択または調整します。デフォルトは今日の日付です。
- 出力形式を選択します:Keep a Changelog、Simple、またはGitHub Releases。
- 右パネルにCHANGELOG.md出力が自動更新されます。グループ化されたセクションと破壊的変更を確認してください。
- Previewをクリックして生マークダウンとレンダリングプレビューを切り替えます。CopyをクリックまたはCtrl+Shift+Cを押してクリップボードにコピーします。
- .mdボタンをクリックして生成されたチェンジログを
CHANGELOG.mdファイルとしてダウンロードします。Sampleでサンプルコミットを読み込み、Clearでリセットできます。
人気のチェンジログ例
よくある質問
Conventional Commits形式とは何ですか?
Conventional Commitsは標準化されたコミットメッセージを書くための仕様です。各メッセージはtype(scope): descriptionのパターンに従います。typeは変更の種類(feat、fix、docsなど)を示し、任意のscopeは影響範囲を絞り、descriptionは変更の要約です。コロンの前の感嘆符(feat!:)は破壊的変更を示します。
どのコミットタイプに対応していますか?
標準的なタイプを認識します:feat(機能)、fix(バグ修正)、docs(ドキュメント)、style(スタイル)、refactor(リファクタリング)、perf(パフォーマンス改善)、test(テスト)、build(ビルドシステム)、ci(CI/CD)、chore(雑務)、revert(差し戻し)。不明なタイプも解析され、元の名前で含まれます。
破壊的変更はどのように検出されますか?
破壊的変更は2つの方法で検出されます:(1)コロンの前の感嘆符(feat!:やfix(api)!:など)、(2)コミット行にBREAKING CHANGEまたはBREAKING-CHANGEが含まれている場合。検出された破壊的変更はチェンジログの先頭に専用セクションとしてまとめられます。
どの出力形式が利用できますか?
3つの形式が利用可能です。Keep a Changelogはkeepachangelog.comの仕様に従い、Added、Changed、Fixed、Removedセクションで構成されます。Simpleは元のコミットタイプラベル(Features、Bug Fixesなど)でグループ化したフラットなリストを生成します。GitHub ReleasesはGitHubリリース本文に貼り付けるのに適したマークダウンを生成します。
Conventional Commits形式でないコミットにも使えますか?
Conventional Commitsのパターン(type(scope): description)に一致しない行はスキップされます。下部の統計バーに解析された行数とスキップされた行数が表示されるので、非準拠のコミットを特定して修正できます。出力を生成するには少なくとも1つの有効なコミットが必要です。
データは安全ですか?
はい。すべての解析とマークダウン生成はJavaScriptを使用してブラウザ内で完全に実行されます。データがサーバーに送信されることはありません。ツール使用中にブラウザの開発者ツールのネットワークタブで確認できます。コミットメッセージとリポジトリの詳細は完全にプライベートに保たれます。
Gitリポジトリからコミットメッセージを取得するには?
ターミナルでgit log --oneline --no-decorate v1.0.0..HEADを実行して、タグからHEADまでのコミットを取得できます。git log --pretty=format:'%s'で件名行のみを取得することもできます。出力をそのままツールに貼り付けてください。本サイトのGit Command Builderツールが正確なコマンドの構築に役立ちます。
関連ツール
Gitコマンドビルダー
操作、オプション、フラグを選択してGitコマンドを視覚的に構築します。説明付き。
差分ビューア
2つのテキストを行単位・文字単位の差分ハイライトで並べて比較します。
Markdownプレビュー
GFM対応のMarkdownをリアルタイムでプレビュー。テーブル、タスクリスト、HTMLエクスポートに対応。
Conventional Commitsリンター
コミットメッセージをConventional Commits仕様に照らして検証します。type、scope、description、bodyのフォーマットをチェック。
Gitブランチ名ジェネレーター
チケット番号やタイトルからクリーンなGitブランチ名を生成します。命名規則のカスタマイズ可能。
.gitignore生成
言語、フレームワーク、IDEを選択して.gitignoreファイルを生成。複数テンプレートを即座に結合。
Gitコミットメッセージジェネレーター
ビジュアルフォームでConventional Commitsメッセージを生成します。type、scope、description、body、破壊的変更を選択。
Semantic Releaseコンフィグビルダー
semantic-releaseの設定ファイルをビジュアルに生成します。プラグイン選択、ブランチ設定、リリースルール、JSON/YAML/JSエクスポート対応。
READMEジェネレーター
シンプルなフォームからプロフェッショナルなREADME.mdファイルを生成します。テンプレート選択、バッジ追加、セクション設定、即時ダウンロード。
行動規範ジェネレーター
Contributor Covenant、Citizen、Django、カスタムテンプレートからCODE_OF_CONDUCT.mdファイルを生成します。
Issueテンプレートビルダー
GitHubおよびGitLabのIssueテンプレートをビジュアルに構築します。YAMLフォームまたはMarkdownテンプレートを生成。
リリースノートジェネレーター
バージョン情報と変更エントリからプロフェッショナルなリリースノートを生成します。
CONTRIBUTING.mdジェネレーター
オープンソースプロジェクト向けのプロフェッショナルなCONTRIBUTING.mdファイルをテンプレートから生成します。
Semverカリキュレーター
Semver範囲マッチの確認、バージョン比較、インクリメント計算、バージョンリストの一括テスト。