release-nightly について
nightly ビルドの準備と公開を支援するリリースワークフローのスキルです。リポジトリ、CI、リリースノート、タグ、公開結果の確認を案内し、公開前に明示的な承認を求めます。
主な機能
- 01nightly 公開前の確認
- 02コミット範囲に基づくノート作成
- 03リリースノートの検証
- 04タグとビルド手順の案内
- 05公開後の確認
活用シーン
- 01nightly 前に CI とリポジトリ状態を確認
- 02対象コミットからノートを作成
- 03nightly ビルドと公開アセットを検証
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ koruworks/ skills --skill release-nightlyインストール後、Claude Code で/release-nightlyを入力して読み込まれたか確認します。
詳細
ナイトリリースを公開する
ナイトリリースの作成は簡単ですが、公開後に取り消すことはできません。タグが更新された時点でリリースノートが公開され、インストール済みのビルドは自動的にナイトリリースへ更新されます。そのため、作業の大半は、何かが手元のマシンから外に出る前に確認を済ませることです。
プロジェクトのナイトリリースの手順を確認する
まず、プロジェクトでナイトリリースについて説明している場所を確認します。
- タグをトリガーとして実行されるワークフロー(例:
.github/workflows/nightly.yml。通常、ヘッダーコメントに手順が記載されています) - リリースノートのフォルダーにある README(例:
releases/nightly/README.md) - リリースノート作成手順のナイトリリースに関するセクション(
releases/WRITING.md)
これらの記載から、タグの名前、リリースノートの保存場所とファイル名、ビルドでリリースノートが選ばれる仕組み、ビルド対象のプラットフォームが分かります。記載がない場合は、作業を中止して確認してください。タグ名やリリースノートの形式を独自に決めてはいけません。
何かを書く前に確認する
- タグが最新であること。 リモートから強制的にタグを取得します(
git fetch origin --force tag nightly)。以前のチェックアウトから残っているローカルタグでは、比較対象が誤り、リリースノートで説明するコミットも間違ってしまいます。 - リリース対象のツリーであること。 取得後、main ブランチにいて、リモートと同じ状態で、ワーキングツリーがクリーンであることを確認します。作業中も他の人のマージによって main は更新されるため、タグを付ける直前にもう一度確認してください。サブモジュールのポインターとチェックアウト先が異なっていても、ビルドでサブモジュールをチェックアウトしないならビルドには影響しませんが、その旨を明記してください。
- タグを付けるコミットで main の CI が成功していること。 その正確なコミットの CI 実行結果を確認します。ナイトリリースのワークフローでは通常、テストもリンターも実行されないため、ビルドで行われる確認は CI だけです。ジョブが失敗していたら、作業を中止してください。失敗した各ジョブと最初の実際のエラーを挙げ、まず main の修正を勧めてから、先に修正するか、それでもリリースするかを確認します。ジョブが実行中なら、そのジョブを挙げて完了を待つか確認します。
- リリースするものがあること。
git log --no-merges <tag>..HEADの結果が空でないことを確認します。 - 前回のナイトリリースが成功していること。 ナイトリリースのワークフローの最近の実行結果を確認します。公開されていないコミットにタグが残る形で実行が失敗していた場合、次の手順が変わります(「ビルドが失敗した場合」を参照)。
リリースノートを書く
プロジェクトのナイトリリース向けリリースノート作成手順に従って、write-release-notes を実行します。その手順に加えて、次の点を確認します。
- 正確なファイルを指定すること。 リリースノートの README に記載されている名前を使います。通常は UTC の日付で、同じ日に 2 回目のビルドを行う場合はサフィックスを付けます。ビルドでは、タグの直近の位置以降に追加されたリリースノートファイルがちょうど 1 つだけ使われるため、この範囲にほかのファイルが追加されていないことを確認します。
- 1 行の要約ではなく、完全なコミットメッセージを使うこと。
git log --no-merges --format='%h %s%n%b' <tag>..HEADを実行し、メッセージを読んでも分からない点があれば、その変更の差分を確認します。 - このビルドに含まれる内容だけを書くこと。 ワークフローでビルドされるプラットフォームを確認します。機能について説明する前に、その機能が対象プラットフォームに存在することを確認してください(
cfg(windows)やプラットフォーム用モジュールの欠落がよくある手がかりです)。特定のプラットフォームだけに関わる変更は、そのプラットフォームの見出しの下に記載するか、記載しないでください。 - プロジェクトの下書き作成コマンドがエージェントを呼び出す場合があります。 あなたがそのエージェントなら、新たなエージェントを起動するのではなく、同じコミット範囲を基に自分でファイルを書いてください。
- 検証すること。 ファイルが解析でき、必須項目がすべて記入されており、公開処理で拒否される内容(画像や HTML など)が含まれていないことを確認します。
表示してから公開する
タグ付けするメモとコミットをユーザーに表示します。このリリースを依頼されており、ユーザーがメモを確認したか、確認せずに公開するよう指示した場合にのみ公開します。公開済みのメモファイルは、その後編集しません。これはアーカイブです。
- main ブランチでメモファイルのみをコミットし、以前のメモのコミットと同じスタイルにします(
git log --oneline -- <notes folder>)。ブランチをプッシュします。これは通常の早送りプッシュであり、強制プッシュは行いません。 - main に変更がなく、引き続きグリーンであることをもう一度確認してから、そのコミットにタグを移動し、強制プッシュします。
git tag -f nightly && git push -f origin nightly。ローリングタグには強制プッシュが適切ですが、このタグに限ります。
監視と検証
- タグのプッシュで開始された実行を見つけ(
gh run list --workflow <file>)、監視します(gh run watch <id>)。実行中のワークフローがすでにある場合、この実行はその完了を待ちます。 - 成功したら、リリース自体を確認します(
gh release view nightly)。プレリリースのままであり、このビルドのパッケージ、署名、更新マニフェストが含まれ、それ以前のものは含まれていないこと、また説明文が新しいメモであることを確認します。 - 実行とリリースのリンク、バージョンまたはビルド番号、確認で見つかった問題を報告します。
ビルドに失敗した場合
ワークフローが安全な順序(新しいパッケージ、次にマニフェスト、最後に削除)で公開する場合、リリースページには以前のビルドが残ります。失敗したステップを確認して報告します。
- 一時的な失敗(ランナーの障害、ネットワークのタイムアウト)の場合:失敗した実行を再実行します(
gh run rerun <id> --failed)。タグは移動していないため、実行には同じメモが使われます。 - コードの修正が必要な失敗の場合:タグを再度移動する前にユーザーに確認します。ビルドでは、タグの直前の位置と新しい位置の間にあるコミットからメモを取得するため、失敗したコミットから修正コミットへタグを移動すると、新しいメモが見つからず停止します。ユーザーが選べる案として、修正版ビルド用の2つ目のメモファイルを用意するか、まずタグを最後に公開されたコミットに戻してから(その実行は仕様上、ビルド前に失敗します)、修正コミットに移動することを提案します。
コメント
Markdown 対応