AgentSkillsCN

kodo-release

执行 kodo 的发布流程。 从版本更新、CHANGELOG 更新、PR 创建，到标签生成，全程无缝衔接、一气呵成。 触发条件：“release”、“发布”、“版本升级”、“publish” 适用场景：(1) 新功能发布；(2) 修复漏洞的发布；(3) 定期发布的例行操作。

SKILL.md
--- frontmatter
name: kodo-release
description: |
  kodo のリリースを実行する。
  バージョン更新、CHANGELOG 更新、PR 作成、タグ作成までを一貫して行う。
  トリガー: "release", "リリース", "バージョンアップ", "publish"
  使用場面: (1) 新機能リリース、(2) バグ修正リリース、(3) 定期リリース

kodo Release

kodo のリリースプロセスを実行するスキル。

実行時の質問

重要: スキル実行時、事前確認後に必ず AskUserQuestion でリリースタイプを質問すること:

選択肢説明バージョン例
メジャー (MAJOR)Breaking changes0.3.0 → 1.0.0
マイナー (MINOR)新機能追加0.3.0 → 0.4.0
パッチ (PATCH)バグ修正0.3.0 → 0.3.1
マージのみリリースせず PR マージだけバージョン変更なし

「マージのみ」が選択された場合は、バージョン更新・CHANGELOG 更新・タグ作成をスキップし、feature ブランチで PR を作成してマージのみ行う。

前提条件

  • •main ブランチは ruleset で保護されているため、PR 経由でマージが必要
  • •CI がパスしていること
  • •crates.io への publish は GitHub Actions で自動実行

リリースフロー

code
1. CI パス確認
2. release/vX.Y.Z ブランチ作成
3. Cargo.toml バージョン更新
4. CHANGELOG.md 更新
5. コミット & プッシュ
6. PR 作成 & マージ
7. タグ作成 & プッシュ
8. GitHub Actions が自動でリリース

手順詳細

Step 1: 事前確認

bash
# main ブランチに切り替え、最新化
git checkout main && git pull origin main

# CI ステータス確認
gh run list --branch main --limit 1

# 現在のバージョン確認
grep '^version' Cargo.toml

Step 2: リリースブランチ作成

bash
# バージョンを決定（例: 0.4.0）
NEW_VERSION="X.Y.Z"

# リリースブランチ作成
git checkout -b release/v${NEW_VERSION}

Step 3: Cargo.toml 更新

Cargo.toml の version フィールドを新バージョンに更新:

toml
[package]
name = "kodo"
version = "X.Y.Z"  # ← ここを更新

Step 4: CHANGELOG.md 更新

  1. •[Unreleased] セクションの内容を新バージョンセクションに移動
  2. •新しい [Unreleased] セクションを空で追加
  3. •比較リンクを更新
markdown
## [Unreleased]

## [X.Y.Z] - YYYY-MM-DD

### Added
- (Unreleased から移動)

### Changed
- (Unreleased から移動)

### Fixed
- (Unreleased から移動)

リンク更新:

markdown
[Unreleased]: https://github.com/yumazak/kodo/compare/vX.Y.Z...HEAD
[X.Y.Z]: https://github.com/yumazak/kodo/compare/vPREV...vX.Y.Z

Step 4.5: ドキュメントサイトの CHANGELOG 同期

CHANGELOG.md を website のドキュメントにも反映する:

bash
# 英語版（ヘッダーを除いてコピー）
echo "# Changelog" > website/docs/en/changelog.md
echo "" >> website/docs/en/changelog.md
tail -n +3 CHANGELOG.md >> website/docs/en/changelog.md

# 日本語版（日本語ヘッダーで）
echo "# 変更履歴" > website/docs/ja/changelog.md
echo "" >> website/docs/ja/changelog.md
tail -n +3 CHANGELOG.md >> website/docs/ja/changelog.md

注意: 日本語版は英語のままになるが、CHANGELOG は技術的な内容なので許容する。 必要に応じて手動で翻訳を追加可能。

Step 5: コミット & プッシュ

bash
git add Cargo.toml Cargo.lock CHANGELOG.md website/docs/en/changelog.md website/docs/ja/changelog.md
git commit -m "chore: Bump version to ${NEW_VERSION}"
git push -u origin release/v${NEW_VERSION}

Step 6: PR 作成 & マージ

bash
# PR 作成
gh pr create --title "chore: Release v${NEW_VERSION}" --body "$(cat <<EOF
## Release v${NEW_VERSION}

### Changes
- Version bump to ${NEW_VERSION}
- Updated CHANGELOG.md

### Checklist
- [ ] CI passes
- [ ] Version in Cargo.toml is correct
- [ ] CHANGELOG.md is updated
EOF
)"

# CI パス後にマージ
gh pr merge --squash --delete-branch

Step 7: タグ作成 & プッシュ

bash
# main に戻って最新化
git checkout main && git pull origin main

# タグ作成
git tag v${NEW_VERSION}

# タグをプッシュ（リリースワークフローが起動）
git push origin v${NEW_VERSION}

Step 8: リリース確認

bash
# ワークフロー実行状況
gh run list --workflow release.yml --limit 1

# リリース確認
gh release view v${NEW_VERSION}

バージョニングガイドライン

変更内容バージョン例
Breaking changesMAJOR0.x.0 → 1.0.0
New featuresMINOR0.3.0 → 0.4.0
Bug fixesPATCH0.3.0 → 0.3.1

トラブルシューティング

PR がマージできない

  • •CI がパスしているか確認: gh pr checks
  • •ruleset の要件を満たしているか確認

タグプッシュ後にリリースが失敗

  • •ワークフローログを確認: gh run view <run-id>
  • •CARGO_REGISTRY_TOKEN が設定されているか確認

crates.io publish が失敗

  • •トークンの権限を確認
  • •バージョンが既に存在していないか確認

関連ドキュメント