手順: 新しいリリースのChangelogを更新する

目的

自動リリース情報に基づいて、changelogファイル (latest.md、preview.md、index.md) の更新プロセスを標準化する。

入力

• version: リリースバージョン文字列 (例: v0.28.0、v0.29.0-preview.2)。
• TIME: リリースタイムスタンプ (例: 2026-02-12T20:33:15Z)。
• BODY: 「What's Changed」セクションと「Full Changelog」リンクを含む、生のマークダウンリリースノート。

latest.md と preview.md のハイライトガイドライン

• 3～5個のキーハイライトポイントを目指す。
• 各ハイライトポイントは、変更を要約した太字のタイトルで始める必要があります (例: **新機能:** 簡潔な説明...)。
• 優先順位: 新機能の要約をバグ修正やその他の変更よりも優先する。
• 避ける: 安定版リリースで「実験的」または「プレビュー中」の機能について言及しない。
• 含めない: これらのハイライトにはPR番号、リンク、または著者名を含めない。
• .gemini/skills/docs-changelog/references/highlights_examples.md を参照して、正しいスタイルとトーンを確認する。

初期処理

1. バージョンの分析: version 文字列に基づいてリリースパスを決定する。
   • version に「nightly」が含まれている場合、停止する。変更は行わない。
   • version が .0 で終わる場合、パスA: 新しいマイナーバージョンの手順に従う。
   • version が .0 で終わらない場合、パスB: パッチバージョンの手順に従う。
2. 時刻の処理: TIME 入力を後で使用するために yyyy-mm-dd と Month dd, yyyy の2つの形式に変換する。
3. 本文の処理:
   • 入力された BODY コンテンツを一時ファイルに保存して処理する。
   • 一時ファイルの「What's Changed」セクションで、すべてのプルリクエストURLをマークダウンリンク形式に再フォーマットする。テキストとしてPR番号を使用する (例: [#12345](URL))。
   • 「New Contributors」セクションが存在する場合は削除する。
   • 「Full Changelog」リンクは保持する。この一時ファイルの処理されたコンテンツは、後続のステップで使用される。

---

パスA: 新しいマイナーバージョン

バージョン番号が .0 で終わる場合はこのパスを使用する。

重要: バージョンに基づいて、セクションA.1 (安定版リリース) またはA.2 (プレビューリリース) のいずれかに従う必要があります。他のセクションの指示には従わないでください。

A.1: 安定版リリース (例: v0.28.0)

安定版リリースの場合、changelogから2つの異なる要約を生成します: メインchangelogページ用の簡潔なアナウンスと、リリース固有のページ用のより詳細なハイライトセクション。

1. index.md のアナウンスを作成:

   • 最も重要な変更を要約した簡潔なアナウンスを生成する。 各アナウンスエントリは、変更を要約した太字のタイトルで始める必要があります。
   • 重要: このアナウンスの形式は独特です。docs/changelogs/index.md の既存のアナウンスと .gemini/skills/docs-changelog/references/index_template.md 内の例を参照ガイドとして使用する必須です。この形式にはPRリンクと著者が含まれます。1～2個のPRリンクと著者に留める。
   • この新しいアナウンスを docs/changelogs/index.md の最上部に追加する。

2. ハイライトを作成して latest.md を更新:

   • 上記の「latest.md と preview.md のハイライトガイドライン」セクションに従って、包括的な「Highlights」セクションを生成する。
   • .gemini/skills/docs-changelog/references/latest_template.md からコンテンツを取得する。
   • テンプレートに version、release_date、生成された highlights、および一時ファイルから処理されたコンテンツを入力する。
   • 生成されたテンプレートで docs/changelogs/latest.md の内容を完全に置き換える。

A.2: プレビューリリース (例: v0.29.0-preview.0)

1. preview.md を更新:
   • ハイライトガイドラインに従って、包括的な「Highlights」セクションを生成する。
   • .gemini/skills/docs-changelog/references/preview_template.md からコンテンツを取得する。
   • テンプレートに version、release_date、生成された highlights、および一時ファイルから処理されたコンテンツを入力する。
   • 生成されたテンプレートで docs/changelogs/preview.md の内容を完全に置き換える。

---

パスB: パッチバージョン

バージョン番号が .0 で終わらない場合はこのパスを使用する。

重要: バージョンに基づいて、セクションB.1 (安定版パッチ) またはB.2 (プレビューパッチ) のいずれかに従う必要があります。他のセクションの指示には従わないでください。

B.1: 安定版パッチ (例: v0.28.1)

• 対象ファイル: docs/changelogs/latest.md
• 対象ファイルで以下の編集を実行する:

  1. メインヘッダーのバージョンを更新する。行は以下のように読む必要があります: # Latest stable release: {{version}}

  2. リリース日を更新する。行は以下のように読む必要があります: Released: {{release_date_month_dd_yyyy}}

  3. 一時ファイルに「What's Changed」セクションが存在するかどうかを判定する。 存在する場合は、ステップ4に進む。存在しない場合は、ステップ5にスキップする。

  4. 一時ファイルから処理された「What's Changed」リストを latest.md の既存の「What's Changed」リストの先頭に追加する。既存のリストを変更または置き換えないでください。最初に追加するのみ。

  5. 「Full Changelog」で、URLの終わり部分のみを編集する。...{previous_version} のようなURLの最後の部分を識別し、それを ...{version} に更新する。

     例: パッチバージョンが v0.29.1 であると仮定します。 Full Changelog: https://github.com/google-gemini/gemini-cli/compare/v0.28.2…v0.29.0 を Full Changelog: https://github.com/google-gemini/gemini-cli/compare/v0.28.2…v0.29.1 に変更する。

B.2: プレビューパッチ (例: v0.29.0-preview.3)

• 対象ファイル: docs/changelogs/preview.md
• 対象ファイルで以下の編集を実行する:

  1. メインヘッダーのバージョンを更新する。行は以下のように読む必要があります: # Preview release: {{version}}

  2. リリース日を更新する。行は以下のように読む必要があります: Released: {{release_date_month_dd_yyyy}}

  3. 一時ファイルに「What's Changed」セクションが存在するかどうかを判定する。 存在する場合は、ステップ4に進む。存在しない場合は、ステップ5にスキップする。

  4. 一時ファイルから処理された「What's Changed」リストを preview.md の既存の「What's Changed」リストの先頭に追加する。既存のリストを変更または置き換えないでください。最初に追加するのみ。

  5. 「Full Changelog」で、URLの終わり部分のみを編集する。...{previous_version} のようなURLの最後の部分を識別し、それを ...{version} に更新する。

     例: パッチバージョンが v0.29.0-preview.1 であると仮定します。 Full Changelog: https://github.com/google-gemini/gemini-cli/compare/v0.28.2…v0.29.0-preview.0 を Full Changelog: https://github.com/google-gemini/gemini-cli/compare/v0.28.2…v0.29.0-preview.1 に変更する。

---

最終化

• 変更を加えた後、npm run format が失敗する場合は、まず npm install を実行してすべてのフォーマット依存関係が利用可能であることを確認する必要があります。 その後、npm run format を実行して一貫性を確保する。
• プロセス中に作成された一時ファイルは削除する。