このページは英語版ドキュメントの翻訳です。コマンド、識別子、例はそのままです。ランタイム 7.24.4 · SDK 2.6.7。英語版

リリースロールバックの手順書

状態: 有効範囲: 公開、現行状態最終確認: 2026-09-03 担当: AX Code リリースエンジニアリング

この手順書は、公開済みの 安定版（latest チャネル）AX Code CLI リリースを撤回し、前のリリースを戻す方法を説明します。プレリリース（beta チャネル）のリリースは Homebrew tap や winget に触れないため、ロールバックには下記の GitHub リリース手順だけで足ります。

機能上の不具合には、前方へのホットフィックス（vX.Y.Z+1 を出す）を優先してください。ロールバックは、リリース完全性の失敗に限ってください。壊れた、または誤って署名された成果物、破損したインストーラー、チャネルやタグの誤り（たとえばプレリリースタグが latest に公開された場合）、または迅速な修正がない重大な退行です。

1. チャネルを凍結する

ロールバックが完了するまで、以降のリリースと postpublish_only の再開を止めてください。リリースワークフローは、すでに公開されたリリースのアセット置き換えを拒否するため、同時の再実行が、ロールバック中の状態を上書きすることはできません。

2. GitHub リリースの向きを戻す

悪いリリースをプレリリースとして印付けし、latest が前のタグを解決するようにし、上書きされていた場合は前のリリースノートを戻します。

gh release edit "vX.Y.Z" --repo defai-digital/ax-code --prerelease
gh release edit "vX.Y.(Z-1)" --repo defai-digital/ax-code --latest

悪いリリースのアセットが破損している、または誤って署名されている場合は、インストーラーがそれらを取得できないよう、削除もします。

gh release delete-asset "vX.Y.Z" "<asset-name>" --repo defai-digital/ax-code

成果物が調査されるまで、リリースオブジェクト自体は削除しないでください。署名済みアセットとワークフローログは、事後検証の証拠です。

3. Homebrew tap を戻す

bash .github/scripts/update-homebrew.sh は、共有の defai-digital/homebrew-tap リポジトリへ formula のコミットをプッシュしました。brew upgrade ax-code が再び前のバージョンを提供するよう、そのコミットを戻してください。以前の defai-digital/homebrew-ax-code リポジトリには移行メタデータだけが含まれます。その formula を復元しないでください。

git -C homebrew-tap revert --no-edit <formula-commit>

そのあと、復元されたバージョンに対する Homebrew のスモークジョブ（.github/workflows/install-matrix-smoke.yml）で収束を確認します。

4. winget マニフェストを戻す

Winget のマニフェストは、GitHub リリースに添付されたマニフェスト ZIP から、メンテナーが microsoft/winget-pkgs へ提出します。悪いバージョンがすでに受理されている場合は、それらのマニフェストファイルを戻す PR を開きます。まだレビュー中なら、PR を閉じてください。リリース上の --clobber アップロードは、添付 ZIP だけを置き換え、公開済みパッケージは決して置き換えません。

5. 知らせる

リリースディスカッションと、支援チャンネルに短いメモを投稿します。影響を受けたバージョン、復元されたバージョン、再インストール手順を含めます。

Homebrew: brew update && brew upgrade ax-code（または brew uninstall ax-code && brew install ax-code）。
Windows とその他: 前のリリースページから固定されたインストーラーを再実行します。インストーラーは署名不一致でフェイルクローズドになり、固定され SHA-256 を確認した minisign をブートストラップします。

6. 復元された状態を検証する

GitHub の latest リリースが前のタグを指し、すべてのアセットが検証されることを確認します。

gh release download "vX.Y.(Z-1)" --repo defai-digital/ax-code -p '*.zip' -p '*.minisig'
minisign -V -p docs/release/ax-minisign.pub -m ax-code-darwin-arm64.zip -x ax-code-darwin-arm64.zip.minisig

Homebrew の formula が復元されたバージョンを提供し、きれいなランナーで問題なくインストールされることを確認します（install-matrix のスモークワークフローがこれを行います）。
新規インストールで ax-code --version が復元されたバージョンを報告し、ax-code doctor に合格することを確認します。

7. 事後検証

リリースゲートを通過したのに壊れたまま出荷されたものを記録し、次のリリースの前に .github/workflows/release.yml（検証、スモークの網羅）に対する修正を提出します。書かれたとおりに動かなかった手順があれば、この手順書を更新します。