変更のプロモーション
現在の作業状態から、mainブランチ上のタグ付きGitHubリリースまで、完全なリリースワークフローを実行します。
現在のブランチ: !git branch --show-current 2>/dev/null || echo "unknown"
Gitステータス: !git status --short 2>/dev/null || echo "not a git repo"
最後のタグ: !git describe --tags --abbrev=0 2>/dev/null || echo "none"
最後のタグ以降の最近のコミット:
!`git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --oneline -10 2>/dev/null || git log --oneline -10`
次のバージョン(上記のコミットから計算):
!`(last=$(git describe --tags --abbrev=0 2>/dev/null || echo "v0.0.0"); IFS='.' read -r ma mi pa <<< "${last#v}"; log=$(git log "${last}..HEAD" --format="%s" 2>/dev/null); if echo "$log" | grep -qE "^[a-z]+(\([^)]+\))?!:"; then echo "v$((ma+1)).0.0"; elif echo "$log" | grep -qE "^feat"; then echo "v${ma}.$((mi+1)).0"; else echo "v${ma}.${mi}.$((pa+1))"; fi)`
ステップ0: 事前チェック
gh auth status 2>&1 || { echo "ERROR: gh is not authenticated. Run: gh auth login"; exit 1; }
誤ってステージされる可能性のある追跡されていない .env ファイルを確認:
git status --short | grep -E '^\?\? .*\.env' && echo "WARNING: untracked .env files detected — review before staging"
cat .gitignore 2>/dev/null | grep -q '\.env' || echo "WARNING: .gitignore does not exclude .env files"
もし .env ファイルがステージされる場合は:
if [ -t 0 ]; then
# 対話モード — 続行前に確認を求める
read -p "WARNING: .env files detected. Continue? (y/N) " confirm
[[ "$confirm" =~ ^[Yy]$ ]] || { echo "Aborted."; exit 1; }
else
# 非対話モード — 強制停止。人間の確認なしではリスクが高すぎる
echo "ERROR: untracked .env files detected in non-interactive mode. Aborting."
exit 1
fi
ステップ1: 未コミットの変更をコミットする
上記のgitステータスに未コミットまたは追跡されていない変更がある場合:
- diffを確認:
git diffとgit diff --cached - 変更を選択的にステージ — 追跡ファイルを優先:
git add -u、その後確認し、必要に応じて新しいファイルを個別に追加。git add -Aはユーザーが明示的に確認しない限り避ける。 - 変更から従来のコミットメッセージを作成 — タイププレフィックス(
feat:、fix:、docs:、chore:など)と簡潔なサマリーで始める - ヒアドキュメントを使用してコミットし、複数行のメッセージが正しくフォーマットされるようにする
未コミットの変更がない場合は、ステップ2に進む。
ステップ2: プッシュ
現在のブランチをリモートにプッシュ:
git push -u origin HEAD
ステップ3: mainにマージ(フィーチャーブランチのみ)
すでに main(またはリポジトリのデフォルトブランチ)にいる場合はこのステップをスキップする。
フィーチャーブランチにいる場合:
-
最後のタグ以降のコミットをスキャンしてIssue参照を探す:
git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --format="%B"Closes #N、Fixes #N、Resolves #N(大文字小文字を区別しない)を探す。見つかったすべてのIssue番号を収集する。見つからない場合:if [ -t 0 ]; then # 対話モード — ユーザーに問い合わせ read -p "Any GitHub issues this resolves? (e.g. 12 15 — or enter to skip) " issues else # 非対話モード — 静かにスキップ issues="" fi -
mainをターゲットにしたPRを作成し、ボディにクロージングキーワードを含めて、マージ時にGitHubが自動的にIssueをクローズするようにする:
gh pr create --title "<type>: <summary>" --body "$(cat <<'EOF' ## Summary <bullet points from commits> Closes #N, Closes #N 🤖 Generated with [claude-workflow-skills:promote](https://github.com/ali5ter/claude-workflow-skills) on behalf of [Alister](https://github.com/ali5ter) EOF )"Issueが特定されなかった場合は
Closes行を省略する。 -
自動マージを有効にする(squash推奨):
gh pr merge --auto --squash -
マージされるまでポーリング:
gh pr view --json state --jq '.state' -
mainに切り替えてプル:
git checkout main && git pull
ステップ4: 次のバージョンを確認
次のバージョンは上記のコンテキストブロックで、以下のsemverルールを使用して事前計算されています:
- コミット件名に
!:が含まれる(例:feat!:,fix!:) → major バンプ - コミット件名が
featで始まる → minor バンプ - その他のコミット → patch バンプ
コミットリストを考慮して、計算されたバージョンが正しいことを確認する。以前のタグが存在しない場合は v1.0.0 を使用する。計算されたバージョンが明らかに間違っている場合(例: インジェクションでエラーまたは空の出力が返された場合)のみ上書きする。
ステップ5: プラグインマニフェストの同期(存在する場合)
.claude-plugin/plugin.json が存在する場合、その version フィールドを <next-version>(v プレフィックスなし — プラグインマニフェストは 1.2.3 のようなベアセマンティックバージョニングを使用)に更新する:
node -e "
const fs = require('fs');
const f = '.claude-plugin/plugin.json';
const d = JSON.parse(fs.readFileSync(f, 'utf8'));
d.version = '<next-version>';
fs.writeFileSync(f, JSON.stringify(d, null, 2) + '\n');
"
その後コミットしてプッシュ:
git add .claude-plugin/plugin.json
git commit -m "chore: sync plugin.json version to v<next-version>"
git push
.claude-plugin/plugin.json が存在しない場合はこのステップを完全にスキップする。
ステップ6: タグとリリース
git tag -a v<next-version> -m "Release v<next-version>"
git push origin v<next-version>
gh release create v<next-version> \
--generate-notes \
--title "v<next-version>"
ステップ7: 解決したIssueをクローズする(mainブランチのみ)
ステップ3でPRが作成された場合はこのステップをスキップする — GitHubはPRマージ時にPRボディの Closes #N キーワードを介して自動的にIssueをクローズする。
プロモーションが直接 main で行われた場合(PRなし)、特定されたIssueを今クローズする:
gh issue close <N> --comment "Resolved in $(gh release view v<next-version> --json url --jq '.url')"
ステップ8: マージ済みフィーチャーブランチをクリーンアップ
ステップ3でフィーチャーブランチがマージされた場合、ローカルおよびリモートで削除する:
git branch -d <feature-branch>
git push origin --delete <feature-branch>
ステップ9: クリーンな状態を確認
git status
git log --oneline -5
GitHubリリースのURLを gh release view v<next-version> --json url --jq '.url' から報告する。