Menu
バージョン整合性チェック→提案→承認→GitHub Release作成までの標準リリースフロー（マルチエコシステム対応）
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
npx skills add https://github.com/takemo101/compose-workflow --skill release-workflowThe command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
Showing SKILL.md
| name | release-workflow |
| description | バージョン整合性チェック→提案→承認→GitHub Release作成までの標準リリースフロー（マルチエコシステム対応） |
バージョン提案 → ユーザー承認 → リリース作成までの標準フローを定義する。
0.5. バージョン整合性チェック（ハードコード検出）
↓
1. バージョン提案（Sisyphusが自動計算）
↓
2. ユーザーがバージョンを承認/変更
↓
3. リリース実行（自動）
- ハードコードバージョン修正（検出時）
- バージョンファイル更新
- CHANGELOG.md更新
- コミット & タグ作成
- push
- GitHub Release作成
- Release Workflow完了待機
リリース作業はホスト環境で直接実行します。
| 理由 | 説明 |
|---|---|
| コード変更なし | バージョンファイル（Cargo.toml等）とCHANGELOG.mdのみ更新 |
| ドキュメント操作のみ | 実行可能コードの変更を伴わない |
| タグ・リリース操作 | Gitタグ作成とGitHub Release操作のみ |
# リリース作業はホスト環境で直接実行
git add Cargo.toml CHANGELOG.md
git commit -m "chore: release v<version>"
git tag -a v<version> -m "Release v<version>"
git push origin <default-branch> --tags
gh release create v<version> ...
| エコシステム | バージョンファイル | 検出条件 |
|---|---|---|
| Rust | Cargo.toml | Cargo.toml 存在 |
| Node.js | package.json | package.json 存在 |
| Python (pyproject) | pyproject.toml | pyproject.toml 存在 |
| Python (setup.py) | setup.py | setup.py 存在 |
| Go | タグのみ | go.mod 存在 |
| Generic | VERSION | VERSION ファイル存在 |
| Tag-only | なし | 上記いずれも該当しない |
Cargo.toml → Rustpackage.json → Node.jspyproject.toml → Python (pyproject)setup.py → Python (setup.py)go.mod → GoVERSION → GenericNote: 複数のエコシステムファイルが存在する場合、上記の優先順位で最初にマッチしたものを使用します。 スクリプトは検出時に警告を表示します。
リリース前にコードベース内のハードコードされたバージョンを検出し、修正を提案する。
| パターン | 検索コマンド | 問題 | 推奨修正 |
|---|---|---|---|
#[command(version = "x.x.x")] | rg '#\[command\(version\s*=' --type rust | clap属性にハードコード | #[command(version)] |
const VERSION: &str = "x.x.x" | rg 'const\s+VERSION.*=.*"\d+\.\d+' --type rust | 定数定義 | env!("CARGO_PKG_VERSION") |
static VERSION | rg 'static\s+VERSION.*=.*"\d+\.\d+' --type rust | static定義 | env!("CARGO_PKG_VERSION") |
| パターン | 検索コマンド | 問題 | 推奨修正 |
|---|---|---|---|
const version = "x.x.x" | rg 'const\s+version\s*=\s*["\x27]\d+\.\d+' --type js --type ts | 定数定義 | require('./package.json').version |
VERSION = "x.x.x" | rg 'VERSION\s*=\s*["\x27]\d+\.\d+' --type js --type ts | 大文字定数 | process.env.npm_package_version |
.version("x.x.x") | rg '\.version\(["\x27]\d+\.\d+' --type js --type ts | メソッドチェーン | 動的取得に変更 |
| パターン | 検索コマンド | 問題 | 推奨修正 |
|---|---|---|---|
__version__ = "x.x.x" | rg '__version__\s*=\s*["\x27]\d+\.\d+' --type py | モジュールバージョン | importlib.metadata.version("pkg") |
VERSION = "x.x.x" | rg 'VERSION\s*=\s*["\x27]\d+\.\d+' --type py | 定数定義 | importlib.metadata.version("pkg") |
version="x.x.x" in setup() | rg 'version\s*=\s*["\x27]\d+\.\d+' setup.py | setup.py内 | pyproject.tomlに移行 |
| パターン | 検索コマンド | 問題 | 推奨修正 |
|---|---|---|---|
var Version = "x.x.x" | rg 'var\s+[Vv]ersion\s*=\s*"\d+\.\d+' --type go | 変数定義 | -ldflags "-X main.Version=..." |
const Version = "x.x.x" | rg 'const\s+[Vv]ersion\s*=\s*"\d+\.\d+' --type go | 定数定義 | -ldflagsでビルド時注入 |
| パターン | 検索コマンド | 対応 |
|---|---|---|
| READMEバッジ | rg 'badge/v?\d+\.\d+\.\d+' README.md | 新バージョンに更新 |
| シールドバッジ | rg 'shields\.io.*\d+\.\d+\.\d+' README.md | 新バージョンに更新 |
| インストール例 | rg '@\d+\.\d+\.\d+' README.md | 新バージョンに更新 |
| ドキュメント内バージョン | rg 'v\d+\.\d+\.\d+' docs/ | 警告表示（確認必要） |
バージョン整合性チェックは release.sh に統合されています：
# Phase 0.5 のみ実行
.pi/skills/release-workflow/scripts/release.sh --version-check <new-version>
# 完全リリースフロー内で自動実行（デフォルト）
.pi/skills/release-workflow/scripts/release.sh --version 1.2.3
# Phase 0.5 をスキップして実行
.pi/skills/release-workflow/scripts/release.sh --version 1.2.3 --skip-version-check
依存:
rg（ripgrep）がインストールされている場合は高速検索を使用。 未インストールの場合はgrep -Eにフォールバック。
## バージョン整合性チェック結果
### ⚠️ 検出されたハードコードバージョン
| ファイル | 行 | 現在の値 | 種別 | 推奨対応 |
|---------|-----|---------|------|---------|
| src/cli/args.rs | 5 | `version = "0.1.0"` | Rust/clap | `#[command(version)]` に変更 |
| README.md | 12 | `badge/v0.1.0` | バッジ | `v{NEW_VERSION}` に更新 |
### 対応オプション
1. **自動修正を適用** → 推奨パターンに変換（コード変更あり）
2. **バージョン番号のみ更新** → 現在のパターンを維持し値のみ更新
3. **スキップ** → 警告のみ、修正なし
> 番号を選択してください（1-3）:
| 種別 | 自動修正可能 | 修正内容 |
|---|---|---|
| Rust clap属性 | ✅ | version = "x.x.x" → version |
| Rust定数 | ✅ | "x.x.x" → env!("CARGO_PKG_VERSION") |
| READMEバッジ | ✅ | バージョン番号を新バージョンに置換 |
| Node.js定数 | ⚠️ 確認必要 | 使用箇所により異なる |
Python __version__ | ⚠️ 確認必要 | importlib使用可否による |
| Go変数 | ❌ 手動 | ビルドスクリプト修正が必要 |
| ドキュメント内 | ⚠️ 確認必要 | コンテキストによる |
以下の場合はPhase 0.5をスキップ可能：
--skip-version-check フラグ指定時# スクリプトを使用（推奨）
.pi/skills/release-workflow/scripts/release.sh --detect
# または手動で検出
# Rust
grep '^version = ' Cargo.toml | head -1 | sed 's/version = "\(.*\)"/\1/'
# Node.js
jq -r '.version' package.json
# Python (pyproject.toml)
grep '^version = ' pyproject.toml | head -1 | sed 's/version = "\(.*\)"/\1/'
# Python (setup.py)
grep -o "version=['\"][^'\"]*['\"]" setup.py | sed "s/version=['\"]\\([^'\"]*\\)['\"/\\1/"
# Go / Tag-only
git tag --sort=-version:refname | head -1 | sed 's/^v//'
# Generic
cat VERSION
# 前回リリースからのコミットを取得
git log <last-tag>..HEAD --oneline
| 変更種別 | バージョン変更 | 例 |
|---|---|---|
| Breaking Change | MAJOR (x.0.0) | API変更、後方互換性なし |
| 新機能追加 | MINOR (0.x.0) | 機能追加、後方互換性あり |
| バグ修正 | PATCH (0.0.x) | バグ修正、リファクタリング |
## リリース提案
### エコシステム
<detected-ecosystem>
### 現在のバージョン
v0.4.0
### 前回リリースからの変更
- feat: 新機能追加（#XX）
- fix: バグ修正（#YY）
### 提案バージョン
**v0.5.0** (MINOR: 新機能追加)
### 変更種別
- ✨ 新機能: N件
- 🐛 バグ修正: N件
- 📝 ドキュメント: N件
---
**このバージョンでリリースしますか？**
1. **提案バージョンで続行** → v0.5.0 でリリース開始
2. **バージョン変更** → 手動でバージョンを入力
3. **キャンセル** → リリース中止
> 番号を選択してください（1-3）:
参照:
approval-gateskill 形式に準拠
ユーザーがバージョンを承認または変更するまで待機。
| 選択 | アクション |
|---|---|
| 1 | 提案バージョンでリリース |
| 2 | 指定バージョンでリリース（入力プロンプト） |
| 3 | リリース中止 |
# スクリプトを使用（推奨）
.pi/skills/release-workflow/scripts/release.sh --update-version <new-version>
# または手動で更新（エコシステム別）
sed -i '' 's/^version = ".*"/version = "<new-version>"/' Cargo.toml
npm version <new-version> --no-git-tag-version
# または
jq '.version = "<new-version>"' package.json > tmp.json && mv tmp.json package.json
sed -i '' 's/^version = ".*"/version = "<new-version>"/' pyproject.toml
sed -i '' "s/version=['\"][^'\"]*['\"]/version='<new-version>'/" setup.py
echo "<new-version>" > VERSION
バージョンファイル更新なし（タグのみ）
変更内容を ## [Unreleased] の下に追加：
## [<new-version>] - <YYYY-MM-DD>
### Added
- 機能追加項目
### Fixed
- バグ修正項目
### Changed
- 変更項目
# スクリプトを使用（推奨）
.pi/skills/release-workflow/scripts/release.sh --commit <new-version>
# または手動
git add -A
git commit -m "chore: release v<new-version>"
git tag -a v<new-version> -m "Release v<new-version> - <summary>"
git push origin <default-branch> --tags
# スクリプトを使用（推奨）
.pi/skills/release-workflow/scripts/release.sh --create-release <new-version> "<release-notes>"
# または手動
gh release create v<new-version> \
--title "v<new-version> - <summary>" \
--notes "<release-notes>"
# スクリプトを使用（推奨）
.pi/skills/release-workflow/scripts/release.sh --watch
# または手動
gh run list --workflow=Release --limit 1
gh run watch <run-id>
gh release view v<new-version> --json tagName,assets --jq '.tagName, (.assets[].name)'
.pi/skills/release-workflow/scripts/release.sh を使用することで、上記の処理を自動化できます。
# エコシステム検出とバージョン表示
.pi/skills/release-workflow/scripts/release.sh --detect
# 完全自動リリース（対話モード）
.pi/skills/release-workflow/scripts/release.sh
# バージョン指定リリース
.pi/skills/release-workflow/scripts/release.sh --version 1.2.3
# ドライラン（実行せずに確認）
.pi/skills/release-workflow/scripts/release.sh --dry-run --version 1.2.3
# バージョン更新のみ
.pi/skills/release-workflow/scripts/release.sh --update-version 1.2.3
# コミット & タグのみ
.pi/skills/release-workflow/scripts/release.sh --commit 1.2.3
# GitHub Release作成のみ
.pi/skills/release-workflow/scripts/release.sh --create-release 1.2.3 "Release notes here"
# Workflow監視
.pi/skills/release-workflow/scripts/release.sh --watch
## <project-name> v<version>
### ✨ 新機能
#### <機能名>
<説明>
### 🐛 バグ修正
- <修正内容> (#<issue-number>)
### 📝 ドキュメント
- <ドキュメント変更>
---
### インストール方法
```bash
# エコシステムに応じたインストールコマンド
<command> --version
---
## CHANGELOG.md テンプレート
```markdown
## [<version>] - <YYYY-MM-DD>
### Added
- **<機能名>**: <説明> (#<issue>)
- <詳細1>
- <詳細2>
### Fixed
- **<修正名>**: <説明> (#<issue>, #<pr>)
### Changed
- **<変更名>**: <説明>
### Deprecated
- **<非推奨名>**: <説明>
### Removed
- **<削除名>**: <説明>
### Security
- **<セキュリティ修正>**: <説明>
# エラー: tag 'v0.5.0' already exists
git tag -d v<version> # ローカル削除
git push origin :refs/tags/v<version> # リモート削除
# 再度タグ作成
# ワークフロー再実行
gh run rerun <run-id>
# または手動でリリースアセットをアップロード
gh release upload v<version> <asset-file>
| ドキュメント | 内容 |
|---|---|
| Keep a Changelog | CHANGELOG形式の標準 |
| Semantic Versioning | バージョニング規約 |
| release.sh スクリプト | リリース自動化スクリプト |
workflow-phase-convention skill | Phase番号体系（release-workflowセクション参照） |
approval-gate skill | 承認ゲートの共通フォーマット |
| 日付 | バージョン | 変更内容 |
|---|---|---|
| 2026-01-17 | 3.1.0 | 承認ゲート形式を番号形式に統一。workflow-phase-convention参照を追加。複数エコシステム警告を追加 |
| 2026-01-17 | 3.0.0 | Phase 0.5（バージョン整合性チェック）追加。エコシステム別ハードコード検出パターン定義。自動修正ルール追加 |
| 2026-01-10 | 2.0.0 | マルチエコシステム対応（Rust, Node.js, Python, Go, Generic）。release.sh スクリプト追加 |
| 2026-01-09 | 1.0.0 | 初版作成（Rust専用） |
Based on SOC occupation classification