release-workflow

Skills Collection リリースワークフロー

不変のソース識別情報と観測された検証結果を用いて、要求されたリリース段階を実行します。ローカル候補、リモート CI、インストール済みソース、公開、最終証明は、それぞれ別個の結果です。

対象範囲と権限

リポジトリ、対象バージョン、要求された段階、現在のベースラインを特定します。既存タグの監査では履歴モードを使用し、新規リリースでは現行モードを使用します。新規インストールのみの要求は、タグ作成や公開を許可するものではありません。

不足している公開権限を求める前に、ローカル候補を準備してレビューします。最初のリモート書き込みの前に、対象候補、タグ、パッケージ数、実行する操作を明示します。その範囲ですでに明示的に付与されている権限は再利用します。対象が変更された場合は、新たな判断が必要です。許可されたタスクの範囲外で、プッシュ、タグ付け、公開、グローバルインストール、Host 設定の変更を行ってはいけません。

成果物とドキュメントの状態

• マニフェストには、準備時点の対象範囲、ソース識別情報、ローカルでの証拠を固定します。
• ノートと公開スナップショットページには、このバージョンの内容を記載します。他のバージョンが現在の安定版である、またはこのバージョンが未公開であるという主張は固定しません。
• レシートは公開後に main 上で初めて作成し、観測された事実を記録します。事前に記入したり、候補やタグに含めたりしてはいけません。

現在の安定版の権威ある情報、バイリンガル対応の箇所、スナップショット／Release 本文の意味、観測入力、過去との互換性については、DOCUMENT-STATE.md を読んでください。ファイルが存在することやリンクテキストが一致することだけでは、正しいバージョンや公開状態を確認したことにはなりません。

選択した段階を実行する

PREPARED → CI_VERIFIED → TAGGED → INSTALL_VERIFIED → PUBLISHED → ATTESTED

段階ごとの手順については RELEASE-STAGES.md を、実際にリリースされたソースのインストールについては VERIFICATION.md を読んでください。関連する各固定ツリーと段階で、共通の整合性ゲートを実行します。記録された CI は正確なコミットを識別し、完了済みかつ成功している必要があります。タグ保護、注釈付きオブジェクトと参照先の識別情報、完全なインストールマニフェストも引き続き必須です。

意味を考慮したレンダラーで Release 本文を準備し、実際に公開された本文とナビゲーションを確認します。成功の主張が許されるのは、インストール／公開の証拠が実際に観測された場合だけです。外部の事実をローカルで代替確認する場合は、明示的に --simulate を指定する必要があり、結果は本番 PASS ではなく、常に SIMULATED_PASS です。

完了処理

CLOSEOUT.md に従ってください。段階ごとに一貫した修正を 1 件完了し、最終的なステージ済み Git ツリーとそのクリーンなエクスポートを検証します。また、許可された公開については、候補と最終 main の正確な CI を必須とします。候補とレシートは別々のコミットにします。失敗した試行と不変の履歴を保持してください。

最終 main CI の観測結果は、それ自体のレシートの外に置きます。自己参照コミットのループを作成してはいけません。候補と最終版の識別情報、実際に行った確認、インストール／公開の結果、未解決のゲートを報告します。Release の公開やプッシュの成功だけでは、タスクは完了しません。