release

Release

kaji の release を maintainer の手元で進める skill。 各 step で user 承認を挟みながら version bump → CHANGELOG → tag → GitHub Release ページ作成まで進める。 PyPI publish は GitHub Release 公開後に .github/workflows/publish-pypi.yml が GitHub Actions + PyPI Trusted Publisher で実行する。

いつ使うか

タイミング	このスキル
kaji の release（version bump + tag + Release ページ）を切る	✅ 必須
dry-run（push / Release ページ作成手前まで確認したい）	✅ --dry-run 経路
PyPI publish	✅ GitHub Release 公開後、publish-pypi.yml へ引き継ぐ
.github/workflows/release-please.yml の再有効化	❌ 対象外（本 skill は maintainer 手元実行前提）

入力

/release            # 通常実行（push と Release ページ作成まで進める）
/release --dry-run  # ローカル状態のみ更新（push / gh release create はスキップ）

引数なしで起動し、skill 側で git / pyproject の状態を読んで判定する。

前提

• 実行場所: kaji 本体の main worktree で実行する（release branch は切らない、main 直接 update する運用）
• gh CLI を使う（GitHub 運用）
• GitHub を指す git remote が 1 つ存在すること。Step 1 で git remote -v の URL から動的に抽出する。.kaji/config.toml の provider.github.git_remote 値と整合する remote 名であることが前提
• 解決した GitHub remote に対して git push できる権限を maintainer が持っていること
• uv / make check が走る環境（kaji 開発環境セットアップ済み）
• PyPI publish を行う場合、GitHub environment pypi が作成済みで approval rule が設定されていること
• PyPI 側で project kaji の Trusted Publisher（初回は Pending Trusted Publisher）が設定済みであること
  • owner: apokamo
  • repository: kaji
  • workflow filename: publish-pypi.yml
  • environment: pypi

Note: 現状 skill は git remote -v の URL grep でのみ remote を解決し、.kaji/config.toml の provider.github.git_remote は直接読まない。config 値を変えただけでは動作は変わらない点に注意。将来 kaji config git-remote 相当の CLI を追加する余地あり。

実行手順

Step 1: Pre-flight check

以下を順に確認する。1 つでも失敗した時点で停止し、user に復旧手順を提示する。

# 1-0. GitHub remote 名を解決
#      `git remote -v` から URL に github.com を含む push remote を動的抽出する。
#      `.kaji/config.toml` の `provider.github.git_remote` 値と整合する
#      remote 名であることが前提（skill は config を直接読まない）。
GITHUB_REMOTE=$(git remote -v | awk '/github\.com.*\(push\)/{print $1; exit}')
# 上記で見つからない場合、`origin` が GitHub を指していれば fallback
if [ -z "$GITHUB_REMOTE" ]; then
    if git remote get-url origin 2>/dev/null | grep -q github; then
        GITHUB_REMOTE=origin
    else
        echo "ABORT: no git remote pointing to github.com found"
        exit 1
    fi
fi
echo "Resolved GitHub remote: $GITHUB_REMOTE"

# 1-1. main checkout 状態
git rev-parse --abbrev-ref HEAD   # → "main" であること

# 1-2. working tree clean
git status --porcelain            # → 空であること

# 1-3. 上流 sync
git fetch "$GITHUB_REMOTE"
git rev-list --left-right --count "$GITHUB_REMOTE/main"...HEAD
# → "0\t0"（ahead/behind ともに 0）であること

# 1-4. 解決した remote が GitHub を指していることを再確認
git remote get-url "$GITHUB_REMOTE"   # → github.* を含むこと

# 1-5. gh CLI 認証済み
gh auth status                        # → "Logged in" 表示