Harness Release v3：自动化发布流程工具，支持语义化版本控制和GitHub集成

harness-release by chachamaru127/claude-code-harness

1 周安装量

241 GitHub Stars

GitHub

安装命令

npx skills add https://github.com/chachamaru127/claude-code-harness --skill harness-release

自动化开发运维命令行工具

🇨🇳中文介绍

Harness Release (v3)

Harness v3 的集成发布技能。整合了以下旧技能：

release-har — 通用发布自动化
x-release-harness — Harness 专用发布自动化
handoff — 向 PM 的交接与完成报告

快速参考

/release          # 交互式（确认版本类型）
/release patch    # 补丁版本号提升（bug 修复）
/release minor    # 次要版本号提升（新功能）
/release major    # 主要版本号提升（破坏性变更）
/release --dry-run  # 仅预览（不执行）
/release --announce # 同时执行向 Slack 等的通知

分支策略

单独开发：允许直接推送到 main（CI 作为质量关卡）
协作开发：必须通过 PR 进行合并
强制推送（--force / --force-with-lease）始终禁止

广告位招租

在这里展示您的产品或服务

触达数万 AI 开发者，精准高效

联系我们

Pre-flight 检查（必需）

# 1. 确认 gh 命令
command -v gh &>/dev/null || echo "⚠️ 无 gh 命令：将跳过 GitHub Release"

# 2. 确认未提交的更改
git diff --quiet && git diff --cached --quiet || {
  echo "⚠️ 存在未提交的更改。请先提交。"
  exit 1
}

# 3. 确认 CI 状态
gh run list --branch main --limit 3 --json status,conclusion

Step 1: 获取当前版本

CURRENT=$(cat VERSION 2>/dev/null || jq -r '.version' package.json 2>/dev/null)

Step 2: 计算新版本

遵循语义化版本控制（SemVer）：

patch: x.y.Z → x.y.(Z+1)（bug 修复）
minor: x.Y.z → x.(Y+1).0（新功能，向后兼容）
major: X.y.z → (X+1).0.0（破坏性变更）

Step 3: 更新 CHANGELOG

Keep a Changelog 格式（英文）：

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

### Added
- **Feature name**: Description

### Changed
- **Change**: Description

### Fixed
- **Fix**: Description

Step 4: 更新版本文件

echo "$NEW_VERSION" > VERSION
# 如果存在 package.json
jq --arg v "$NEW_VERSION" '.version = $v' package.json > tmp && mv tmp package.json
# 如果存在 .claude-plugin/plugin.json
jq --arg v "$NEW_VERSION" '.version = $v' .claude-plugin/plugin.json > tmp && mv tmp .claude-plugin/plugin.json

Step 5: 提交 & 标签

git add CHANGELOG.md VERSION package.json .claude-plugin/plugin.json
git commit -m "chore: release v$NEW_VERSION"
git tag -a "v$NEW_VERSION" -m "Release v$NEW_VERSION"
git push origin main --tags

Step 6: 创建 GitHub Release

gh release create "v$NEW_VERSION" \
  --title "v$NEW_VERSION - $(head -n 2 CHANGELOG.md | tail -n 1)" \
  --notes "$(cat <<'EOF'
## What's Changed

**[变更概述]**

### Before / After

| Before | After |
|--------|-------|
| 旧状态 | 新状态 |

---

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

GitHub Release Notes 格式

## What's Changed 部分
粗体的一行摘要
Before / After 表格
Generated with [Claude Code](...) 页脚
语言：英文（禁止使用日文）

发布后向 PM 发送完成报告：

## 发布完成报告

**版本**: v{{NEW_VERSION}}
**发布日期**: {{DATE}}

### 实施内容
{{CHANGELOG 的内容}}

### GitHub Release
{{URL}}

### 后续操作
- PM 确认发布说明
- 部署到生产环境（如适用）

review — 发布前进行代码审查
execute — 实现发布后的下一个任务
plan — 制定下一版本的计划

🇯🇵日本語

Harness Release (v3)

Harness v3 の統合リリーススキル。以下の旧スキルを統合:

release-har — 汎用リリース自動化
x-release-harness — Harness 専用リリース自動化
handoff — PM へのハンドオフ・完了報告

Quick Reference

/release          # インタラクティブ（バージョン種別を確認）
/release patch    # パッチバージョンバンプ（バグ修正）
/release minor    # マイナーバージョンバンプ（新機能）
/release major    # メジャーバージョンバンプ（破壊的変更）
/release --dry-run  # プレビューのみ（実行しない）
/release --announce # Slack 等への告知も実行

ブランチポリシー

単独開発 : main への直接 push を許容（CI が品質ゲートとして機能）
共同開発 : PR 経由のマージが必須
force push（--force / --force-with-lease）は常に禁止

実行フロー

Pre-flight チェック（必須）

# 1. gh コマンド確認
command -v gh &>/dev/null || echo "⚠️ gh なし: GitHub Release はスキップ"

# 2. 未コミット変更確認
git diff --quiet && git diff --cached --quiet || {
  echo "⚠️ 未コミット変更あり。先にコミットしてください。"
  exit 1
}

# 3. CI 状態確認
gh run list --branch main --limit 3 --json status,conclusion

Step 1: 現在バージョン取得

CURRENT=$(cat VERSION 2>/dev/null || jq -r '.version' package.json 2>/dev/null)

Step 2: 新バージョン算出

セマンティックバージョニング（SemVer）に従う:

patch: x.y.Z → x.y.(Z+1)（バグ修正）
minor: x.Y.z → x.(Y+1).0（新機能・後方互換）
major: X.y.z → (X+1).0.0（破壊的変更）

Step 3: CHANGELOG 更新

Keep a Changelog フォーマット（英語）:

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

### Added
- **Feature name**: Description

### Changed
- **Change**: Description

### Fixed
- **Fix**: Description

Step 4: バージョンファイル更新

echo "$NEW_VERSION" > VERSION
# package.json がある場合
jq --arg v "$NEW_VERSION" '.version = $v' package.json > tmp && mv tmp package.json
# .claude-plugin/plugin.json がある場合
jq --arg v "$NEW_VERSION" '.version = $v' .claude-plugin/plugin.json > tmp && mv tmp .claude-plugin/plugin.json

Step 5: コミット & タグ

git add CHANGELOG.md VERSION package.json .claude-plugin/plugin.json
git commit -m "chore: release v$NEW_VERSION"
git tag -a "v$NEW_VERSION" -m "Release v$NEW_VERSION"
git push origin main --tags

Step 6: GitHub Release 作成

gh release create "v$NEW_VERSION" \
  --title "v$NEW_VERSION - $(head -n 2 CHANGELOG.md | tail -n 1)" \
  --notes "$(cat <<'EOF'
## What's Changed

**[変更の概要]**

### Before / After

| Before | After |
|--------|-------|
| 旧状態 | 新状態 |

---

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

GitHub Release Notes フォーマット

必須要素:

## What's Changed セクション
太字の1行サマリー
Before / After テーブル
Generated with [Claude Code](...) フッター
言語: 英語（日本語禁止）

PM ハンドオフ

リリース後に PM への完了報告:

## リリース完了報告

**バージョン**: v{{NEW_VERSION}}
**リリース日**: {{DATE}}

### 実施内容
{{CHANGELOG の内容}}

### GitHub Release
{{URL}}

### 次のアクション
- PM によるリリースノートの確認
- 本番環境へのデプロイ（該当する場合）

Harness Release v3：自动化发布流程工具，支持语义化版本控制和GitHub集成

🇨🇳中文介绍

Harness Release (v3)

快速参考

分支策略

相关 Skills

执行流程

Pre-flight 检查（必需）

Step 1: 获取当前版本

Step 2: 计算新版本

Step 3: 更新 CHANGELOG

Step 4: 更新版本文件

Step 5: 提交 & 标签

Step 6: 创建 GitHub Release

GitHub Release Notes 格式

PM 交接

相关技能

🇯🇵日本語

Harness Release (v3)

Quick Reference

ブランチポリシー

実行フロー

Pre-flight チェック（必須）

Step 1: 現在バージョン取得

Step 2: 新バージョン算出

Step 3: CHANGELOG 更新

Step 4: バージョンファイル更新

Step 5: コミット & タグ

Step 6: GitHub Release 作成

GitHub Release Notes フォーマット

PM ハンドオフ

関連スキル

最新 Skills