ChatGPT や Claude でリリースノートを書く方法

そのまま使える頼み方

例

架空の例です。美容室向けの予約アプリが、11 月 10 日に 4.8 を出します。チケットは 6 つです。BK-311 予約の画面で毎週のくり返し予約。BK-322 予約を変えるとリマインダーの SMS が 2 回届く。BK-325 フロントエンドのフレームワークの更新。BK-327 お客さまの検索を作り直し、ふだんの応答が 1.8 秒から 0.4 秒に。BK-330 支払いの失敗のログを増やす。BK-333「オンボーディングを調整」。リリースノート：

プロダクトマネージャーが BK-333 を確かめると、オンボーディングの手順が 1 つ移っていました。ヘルプセンターの画面写真を直してから、次のリリースノートに 1 行入れます。

チームに残ること

1. どの行もチケットと照らす。AI はチケットに書いてあることしか知らない。
2. 画面に出る名前を使う。コードの名前は使わない。
3. 利用者が出会わなかった不具合の修正は載せない。
4. 設定の要る新機能にはヘルプ記事のリンクを。
5. 動きが変わるものは、先にサポートへ伝える。

次の一歩：頼み方を毎回貼らない

リリースは 1〜2 週ごとに来るので、頼み方はチーム全員が見つけられる場所に置きます。ChatGPT のプロンプトを保存して毎回貼るのをやめるで、保存する場所を紹介しています。

よくある質問

AI でリリースノートは書ける？

変更の一覧から書けます。マージした変更のタイトルかチケットの要約を貼り、新機能・改善・修正の 3 つに分けた利用者向けの文と、別の社内の変更履歴を頼みます。どの行も利用者にできるようになったことから書かせ、チケットからわからないことは推測させずに確認の印をつけさせます。

リリースノートには何を書く？

利用者に見えることだけです。新しくできること、速く・わかりやすくなったこと、利用者が出会った不具合の修正を、画面やボタンの名前で書きます。内部の作り直し、依存関係の更新、テストは社内の変更履歴へ入れます。Keep a Changelog は、それを Added、Changed、Deprecated、Removed、Fixed、Security に分け、新しい版から日付つきで並べます。

不具合の修正はどう書く？

原因ではなく、利用者が気づいた症状で書きます。「予約を変えると、お客さまにリマインダーの SMS が 2 回届く問題を直しました」のように書き、「SMS ジョブの重複を修正」とは書きません。だれかのせいにしたり謝りすぎたりせず、利用者に届かなかった不具合の修正は載せません。