changelog について
changelogは、プロジェクトの変更履歴を編集・レビューするエージェント向けスキルです。確認済みの変更に基づき、既存の記録を保ちながら、網羅性やリンク、クレジットを確認します。
主な機能
- 01対象範囲と比較基準の設定
- 02変更履歴と証拠の照合
- 03利用者向け変更と移行案内の追加
- 04リンクと貢献者クレジットの確認
- 05差分の確認と検証結果の報告
活用シーン
- 01Unreleasedの記録の保守
- 02指定リリースのノート作成
- 03変更せずに履歴の網羅性をレビュー
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ chrisbanes/ skills --skill changelogインストール後、Claude Code で/changelogを入力して読み込まれたか確認します。
同梱ファイルreferences/stable-release.md
詳細
変更履歴
基本原則
利用者向けの注記は、編集済みの表現とリリース履歴を維持しながら、検証済みの変更に基づく完全な内容にします。
手順
- 依頼された範囲、リポジトリの規約、変更履歴ファイルのパス、Git の状態を確認します。未リリース版のメンテナンスまたは指定リリースの変更履歴を選び、レビューは読み取り専用で行います。ユーザーが提供された情報だけに作業を限定している場合、調査コマンドは実行せず、提供されていない事実は不明として扱います。このスキルは言語や公開システムを問わず適用され、Kotlin プラグイン、認証情報、API スナップショット、リリース承認は必要ありません。 変更履歴が存在せず、作成も明示的に依頼されていない場合は、作成を見送ったことを報告して終了します。作成が明示的に依頼されている場合は、まず形式と履歴の対象範囲を確認します。
- リポジトリのタグ規約と祖先関係、または提供された証拠に基づいて、比較対象の範囲を定めます。未リリース版のメンテナンスでは、リポジトリの段階的なプレリリース基準を維持しつつ、該当する最新リリースと比較します。指定リリースの変更履歴では、提供された対象バージョンを使用し、対象が指定されていない、または曖昧な場合は編集前に確認します。指定されたプレリリースでは、直前の該当リリースからの段階的な基準を維持します。進行中のプレリリースサイクルでは、そのサイクル全体の変更履歴を記載します。正式リリースでは、最新の RC との差分だけでなく、サイクル全体の基準として直前の安定版リリースを使用します。最初の安定版リリースでは、履歴の開始時点からの変更を対象とします。曖昧なタグは、辞書順で最も後ろのものを選ぶのではなく、解決します。未リリース版のメンテナンスでは、次の開発バージョンは必要ありません。
- 既存の変更履歴を、対象範囲全体の履歴、差分、関連する Issue/PR の証拠と照合します。正確に整理されている文面は維持し、利用者に見える変更の記載漏れを追加し、不正確な箇所を修正し、内部向けの変更は除外します。引用とクレジットは、それぞれの変更を説明する項目にのみ付けます。対象となる項目のない変更は、独立した項目として記載します。関連する破壊的変更と移行ガイダンスを含めます。対象範囲に不確かな点がある場合は、事実を作り上げたり、網羅できていると断言したりせず、具体的な不足を解消するか報告します。正式な安定版リリースでは、編集前に安定版リリースのノートを最後まで読み、記載範囲と履歴の手順に従います。
- リンクとクレジットを確認します。PR が根拠となる変更では、番号から正規のプルリクエスト URL に直接リンクします。例:
[#123](https://github.com/OWNER/REPO/pull/123)。適切な場合は、明示的な Markdown URL を使って関連する Issue にもリンクします。番号のみの記載では不十分です。メンテナーではないことが確認された PR 作成者については、確認済みの名前またはユーザー名を GitHub プロフィールにリンクして記載します。PR から作成者を、リポジトリの証拠からメンテナーかどうかを確認します。提供された事実は証拠として扱います。情報が不足し、アクセスが許可されている場合に限り、プロバイダーに問い合わせます。検証できない URL、作成者またはメンテナーかどうかの確認状況、メンテナー以外であることが確認された人物のプロフィール URL が見つからない場合は、その旨を報告します。メンテナーにはプロフィールのクレジットは不要です。正確に整理されている文面は、依頼されたリンクとクレジットを除いて維持します。身元や分類を決して捏造しません。 - 許可された変更履歴の編集のみを行います。未リリース版のメンテナンスは、既存の見出しの下に記載します。指定リリースの変更履歴では、リポジトリの見出し、日付、アンカーの規約を維持し、依頼された場合にのみ見出しを確定します。
release-kotlin-libraryから呼び出された場合、呼び出し元が変更履歴のみの確定を明示的に依頼していない限り、見出しの確定はリリースヘルパーに任せます。プルやコミットを含む Git の変更、バージョンファイル、スナップショット、公開作業は呼び出し元に任せます。レビュー可能な変更履歴があっても、これらの作業は許可されません。 - レビューした変更と実際の差分を照合し、引用の配置と、公開済みの履歴が維持されていることを確認します。コマンドの実行が許可されている場合は、
git diff --checkを実行します。リポジトリのドキュメント検証は、指示または変更した書式で必要な場合に実施し、検証を利用できない場合は報告します。見出しの確認だけでは、内容が意味的に網羅されていることを確認できません。
完了ゲート
実際のノートまたは直接確認可能な差分、比較のベースラインとレビュー対象範囲、実施した検証、未解決の証拠またはカバレッジの不足を提示してください。 読み取り専用のレビューでは、編集したと主張せずに、所見または提案するノートを提示してください。 変更履歴がない場合は、照合を行ったと主張せずに、スキップしたことを報告してください。 最終リリースでは、ノートが完成したと主張する前に、残っているカバレッジ台帳の各行がすべて安定版の要約に含まれていることと、元のプレリリース履歴がそのまま維持されていることを確認してください。該当する場合は、これらの結果を呼び出し元のリリースワークフローに引き渡してください。残りのリリースゲートと承認は、その呼び出し元が担当します。
コメント
Markdown 対応