mcpField

Changelog Sync After Ship

おすすめ手動実行
ドキュメント最大 3 ラウンド

Changelog Sync After Ship について

リリース完了後に手動で開始し、CHANGELOG.md を実際の変更内容と一致させるループです。各ラウンドで前回タグ以降のコミットを一覧し、[Unreleased] がユーザーに見える変更をすべて網羅しているかを確認します。最大 3 ラウンドです。

主な機能

  1. 01直近のタグを起点にコミットを比較
  2. 02タグがない場合は直近 20 コミットで代用
  3. 03毎ラウンド git log -5 --oneline で確認
  4. 04手動トリガー、最大 3 ラウンド

活用シーン

  1. 01リリース後の変更履歴の作成
  2. 02複数機能のマージ後の記載漏れチェック
  3. 03リリースノート作成前の変更範囲の確認
目標
CHANGELOG.md の [Unreleased] に、今回のリリースの変更が正確に記載されていること。
終了条件
変更履歴がユーザーに見えるすべての変更を網羅した時点で停止します。
各ラウンドの間に実行
git log -5 --oneline

起動プロンプト

Claude Code に貼り付けて実行すると、終了条件を満たすまでエージェントが以下の手順を繰り返します。

prompt.md
「Changelog Sync After Ship」ループを開始します。
目標：CHANGELOG.md の [Unreleased] に、今回のリリースの変更が正確に記載されていること。
最大ラウンド数：3。
ステップ 1：タグ以降のコミットを一覧 — 差分コマンドを実行し、前回タグ（なければ HEAD~20）から HEAD までのコミットを取得します。これがリリースの変更範囲になります。 `git log $(git describe --tags --abbrev=0 2>/dev/null || echo HEAD~20)..HEAD --oneline`
ステップ 2：既存の記載と照合 — 各コミットを CHANGELOG.md の [Unreleased] と突き合わせ、不足・古い・不正確な項目を洗い出します。
ステップ 3：変更履歴を更新 — ユーザーに見える変更のみ項目を追加・修正し、内部的なリファクタリングは含めません。
ステップ 4：直近のコミットを確認 — git log -5 --oneline で、記録されていない最近の変更がないか確認します。漏れがあれば次のラウンドに進みます。
各ラウンドの間に実行：`git log -5 --oneline`
終了条件：変更履歴がユーザーに見えるすべての変更を網羅した時点で停止します。

手順

各ラウンドは順番に実行され、終了条件を満たさなければ次のラウンドへ進みます（最大 3 ラウンド）。

01
タグ以降のコミットを一覧

差分コマンドを実行し、前回タグ（なければ HEAD~20）から HEAD までのコミットを取得します。これがリリースの変更範囲になります。

$git log $(git describe --tags --abbrev=0 2>/dev/null || echo HEAD~20)..HEAD --oneline
02
既存の記載と照合

各コミットを CHANGELOG.md の [Unreleased] と突き合わせ、不足・古い・不正確な項目を洗い出します。

03
変更履歴を更新

ユーザーに見える変更のみ項目を追加・修正し、内部的なリファクタリングは含めません。

04
直近のコミットを確認

git log -5 --oneline で、記録されていない最近の変更がないか確認します。漏れがあれば次のラウンドに進みます。

未達 → 次のラウンド条件を満たせば終了

対応エージェント

この Loop をそのまま実行できるコーディングエージェントです。

Claude Code
Cursor

コメント

Markdown 対応