リリース

リリースをカット、変更ログを検証、git フックがインストールされていることを確認します。

使い方

/release 1.0.5 または /release patch (現在のバージョンからパッチを更新)

プロセス

ユーザーが /release <version> をトリガーした場合:

1. コンテキストを集める — skills/release/scripts/release-context.sh <version> を実行します。 git フックをサイレントインストールし、必要な情報をすべて出力します：バージョン情報、 作業ディレクトリのステータス、最後のリリース以降のコミット、変更されたファイル、現在の [Unreleased] コンテンツ、スタイル参照用の前回のリリースエントリ。

2. 未完了の作業をコミット — コンテキストにこのリリースに属するステージング、変更、 または未追跡ファイルが示されている場合は、まずそれらをコミットします。/commit スキルを使用するか、 適切にフォーマットされたコミットを直接作成します。

3. 変更ログを書く — [Unreleased] が空の場合は、コンテキスト出力のコミットとファイル変更を使用して 今すぐ書きます。下記の変更ログ標準に従ってください。コミット後、必要に応じてコンテキストスクリプトを再実行します。

4. リリースをカット — scripts/release.sh <version> を実行します。これにより [Unreleased] → [X.Y.Z] - date に改名され、新しい [Unreleased] が挿入され、 package.json が更新され、コミットしてタグ付けされます。

5. 最終変更ログを表示 — scripts/extract-changelog.sh <version> を使用して 完全な [Unreleased] とマイナーシリーズのロールアップを出力します。 プッシュする前にユーザーに確認を求めます。

6. プッシュ — 明示的な確認後、git push origin main --tags を実行します。

7. CI を監視 — プッシュ後、バックグラウンド dispatch で publish ワークフローを監視するデスパッチを開始します。 dispatch モードで interactive_shell を使用して:

   gh run watch $(gh run list --workflow=publish.yml --limit=1 --json databaseId --jq '.[0].databaseId') --exit-status
   

   CI が完了したときエージェントに通知され、結果を報告する必要があります。

8. 依存関係の更新をチェック — リリースをカットする前に、sqlite-vec (およびプラットフォームパッケージ)、 node-llama-cpp、better-sqlite3 の更新を確認します。pnpm outdated を実行し、 これらのパッケージで利用可能な更新を報告します。更新がある場合は、それらをピン留めして ( ^ の範囲なし)、続行する前にテストを再実行します。

ステップが失敗した場合は停止して説明してください。強制プッシュや検証をスキップしないでください。

依存関係ポリシー

すべての依存関係は正確なバージョンにピン留めする必要があります (^ または ~ の範囲なし)。 ロックファイルは再現可能なインストールを保証します。依存関係を追加または更新するときは、 常に正確なバージョン文字列を使用してください (例: "^3.18.1" ではなく "3.18.1")。

変更ログ標準

変更ログは CHANGELOG.md に記載され、Keep a Changelog の規約に従います。

見出しの形式

• ## [Unreleased] — リリース間の エントリを蓄積
• ## [X.Y.Z] - YYYY-MM-DD — リリース済みバージョン

リリースエントリの構造

各バージョンエントリは 2 つの部分に分かれています:

1. ハイライト (オプション、散文 1～4 文)

バージョン見出しの直後、### セクションの前。エレベーターピッチ - 30 秒で誰かに何を伝えるか? 重大なリリースにのみ使用; 小さなパッチの場合はスキップしてください。

## [1.1.0] - 2026-03-01

QMD は Node.js と Bun の両方で実行でき、並列コンテキストを通じて最大 2.7 倍高速な再ランキングが可能です。
GPU 自動検出は信頼できない `gpu: "auto"` を明示的な CUDA/Metal/Vulkan プローブに置き換えます。

2. 詳細な変更ログ (### Changes と ### Fixes)

### Changes

- Runtime: support Node.js (>=22) alongside Bun. The `qmd` wrapper
  auto-detects a suitable install via PATH. #149 (thanks @igrigorik)
- Performance: parallel embedding & reranking — up to 2.7x faster on
  multi-core machines.

### Fixes

- Prevent VRAM waste from duplicate context creation during concurrent
  `embedBatch` calls. #152 (thanks @jkrems)

作成のガイドライン

• 理由だけでなく、内容も説明してください。 変更ログはユーザー向けです。
• 数字を含めてください。 「2.7 倍高速」、「17 倍少ないメモリ」。
• テーマ別にグループ化してください。ファイル別ではなく。 「パフォーマンス」ではなく「llm.ts への変更」。
• すべてのコミットをリストしないでください。 関連する変更を集約してください。
• 貢献者にクレジットを与えてください: 外部 PR の場合、箇条書きの最後に #NNN (thanks @username) を付けてください。 リポジトリ所有者にクレジットを与える必要はありません。

含めない内容

• ユーザーに見える影響のない内部リファクタリング
• 依存関係の更新 (ユーザー向けバグ修正の場合を除く)
• CI/ツーリング変更 (リリース成果物に影響する場合を除く)
• テスト追加 (言及する価値のある修正を検証する場合を除く)

GitHub リリースノート

各 GitHub リリースは、x.x.0 に遡る マイナーシリーズ の完全な変更ログを含みます。 scripts/extract-changelog.sh スクリプトがこれを処理し、publish ワークフロー (publish.yml) がそれを呼び出して GitHub リリースに入力します。

Git フック

pre-push フック (scripts/pre-push) は以下の場合を除き、v* タグプッシュをブロックします:

1. package.json バージョンがタグと一致している
2. CHANGELOG.md にバージョンの ## [X.Y.Z] - date エントリがある
3. GitHub で CI が合格した (非対話型シェルで警告、ターミナルでブロック)

フックはコンテキストスクリプトによってサイレントにインストールされます。 skills/release/scripts/install-hooks.sh を使用して手動でインストールするか、 bun install (prepare スクリプト) を使用して自動的にインストールできます。