Release Skill

Automates the claude-code-harness release process.

Quick Reference

• "Release a new version" → /release
• "Bump patch version" → /release patch
• "Create a minor release" → /release minor

Execution Flow

Step 1: Change Verification

Run in parallel:

1. git status - Check uncommitted changes
2. git diff --stat - List changed files
3. git log --oneline -10 - Recent commit history

Step 2: Version Determination

Check current version:

cat VERSION

Determine version based on changes (Semantic Versioning):

• patch (x.y.Z): Bug fixes, minor improvements
• minor (x.Y.0): New features (backward compatible)
• major (X.0.0): Breaking changes

Ask user: "What should the next version be? (e.g., 2.5.23)"

Step 3: CHANGELOG Update (JP + EN)

⚠️ 重要: ユーザー体験に影響する変更を中心に記載。内部修正は簡潔に。

Update both CHANGELOG_ja.md and CHANGELOG.md.

CHANGELOG 記載ルール

テンプレート

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

### 🎯 What's Changed for You

**ユーザー体験の変化を1行で説明**

| Before | After |
|--------|-------|
| 変更前の状態 | 変更後の状態 |

### Added

- 新機能の簡潔な説明

### Internal

- 内部修正の1行サマリー

Before/After テーブルのルール

• 体験が変わる変更のみ Before/After を記載
• 内部修正（CI、テスト、リファクタリング）には不要
• 技術詳細ではなく ユーザー視点の変化 を記載

悪い例 vs 良い例

❌ 悪い例（技術詳細すぎる）:
- **agents/*.md**: スキル参照を更新（`review` → `harness-review`）
- **CI: validate-plugin.sh** が Skills 移行後も正常動作するように修正

✅ 良い例（ユーザー視点）:
### Internal
- CI/テスト/ドキュメントを Skills 移行後の構造に更新

Step 3.5: README Update Check

Check if README needs update (JP/EN both)

Step 4: Version File Update

echo "X.Y.Z" > VERSION

Also update .claude-plugin/plugin.json:

"version": "X.Y.Z"

Step 5: Commit and Tag

git add -A
git commit -m "chore: release vX.Y.Z"
git tag -a vX.Y.Z -m "Release vX.Y.Z"

Step 6: Push

git push origin main
git push origin vX.Y.Z

Step 7: GitHub Release (Optional)

gh release create vX.Y.Z \
  --title "vX.Y.Z - Title" \
  --notes "$(cat <<'EOF'
## 🎯 What's Changed for You

**ユーザー体験の変化を1行で**

| Before | After |
|--------|-------|
| 変更前 | 変更後 |

### Added / Changed / Fixed

- 簡潔な説明

---

🤖 Generated with [Claude Code](https://claude.com/claude-code)
EOF
)"

GitHub Release Format

Follow .claude/rules/github-release.md:

## 🎯 What's Changed for You

**One-line value description**

| Before | After |
|--------|-------|
| Previous state | New state |

### Added / Changed / Fixed

- Brief description

---

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Related Skills

• verify - Pre-release verification