k2works/developing-release
.agents/skills/developing-release/SKILL.md
アプリケーションのリリースワークフローを一貫実行。品質ゲート→バージョンバンプ→CHANGELOG 生成→git commit + tag を自動化する。「リリースしたい」「バージョンを上げたい」「CHANGELOG を生成したい」「リリース前のチェックをしたい」といった場面で発動する。リリース手順を標準化することで、ヒューマンエラーを排除し、いつでも安全にリリースできる状態を維持する。
development
Updated Apr 16, 2026
$ install --global
skillsauthnpx skillsauth add k2works/getting-started-tdd developing-releaseInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 16, 2026, 5:24 PM5.8s1 file scanned
SKILL.md
- name:
- developing-release
- description:
- アプリケーションのリリースワークフローを一貫実行。品質ゲート→バージョンバンプ→CHANGELOG 生成→git commit + tag を自動化する。「リリースしたい」「バージョンを上げたい」「CHANGELOG を生成したい」「リリース前のチェックをしたい」といった場面で発動する。リリース手順を標準化することで、ヒューマンエラーを排除し、いつでも安全にリリースできる状態を維持する。
リリースワークフロー
品質ゲート→バージョンバンプ→CHANGELOG 生成→git commit + tag を一貫して実行する。
リリースを自動化する価値は「いつでもリリースできる」状態を維持すること。手作業によるミスを排除し、品質ゲートで最低品質を保証する。
参照ドキュメント
- @docs/reference/リリースガイド.md — リリースワークフロー全体
オプション
| オプション | 説明 |
|-----------|------|
| なし | ドライランを実行（デフォルト） |
| --dry-run | CHANGELOG プレビュー + バージョン計算 |
| --patch | パッチリリース（バグ修正） |
| --minor | マイナーリリース（新機能追加、後方互換あり） |
| --major | メジャーリリース（破壊的変更） |
| --preflight | 品質ゲートのみ実行 |
| --deploy | リリース + デプロイ（--patch / --minor / --major と併用） |
リリースフロー
- ドライラン: CHANGELOG プレビューとバージョン計算を確認する
- リリース種別選択: patch / minor / major を選択する
- 品質ゲート（preflight）: 全チェックを通過する
- リリース実行: バージョンバンプ→CHANGELOG 生成→commit + tag
- リモートプッシュ: コミットとタグをプッシュする
- プルリクエスト作成: リリースブランチからメインブランチへの PR を作成し、CHANGELOG の差分をレビューする
- デプロイ: 必要に応じて本番デプロイを実行する
品質ゲート（preflight）
リリース前に以下のチェックを直列実行する。全チェック通過が必須。
| チェック | コマンド | 内容 |
| :--- | :--- | :--- |
| working tree クリーン | release:preflight:clean | 未コミット変更がないこと |
| 静的解析 | release:preflight:lint | lint エラーがないこと |
| ユニットテスト | release:preflight:test | 全テストパス |
| ビルド確認 | release:preflight:build | ビルド成功 |
| E2E テスト | release:preflight:e2e | E2E テスト全パス |
バージョニング規則
Semantic Versioning に従う。
| 種類 | 変更例 | バージョン変化 |
| :--- | :--- | :--- |
| patch | バグ修正、軽微な改善 | 0.1.0 → 0.1.1 |
| minor | 新機能追加（後方互換あり） | 0.1.0 → 0.2.0 |
| major | 破壊的変更 | 0.1.0 → 1.0.0 |
モノレポ構成の場合、全パッケージのバージョンを同期管理する。
CHANGELOG 生成ルール
Conventional Commits に基づいて自動生成する。
| prefix | カテゴリ |
| :--- | :--- |
| feat | Features |
| fix | Bug Fixes |
| docs | Documentation |
| refactor | Refactoring |
| test | Tests |
| chore / perf / ci / style / build | その他 |
直近の git tag から HEAD までのコミットを対象とする。タグが存在しない場合は全コミット履歴を対象とする。
リリース実行ステップ
| ステップ | 内容 |
| :--- | :--- |
| [1/4] バージョン更新 | セマンティックバージョニングに従って更新 |
| [2/4] CHANGELOG 生成 | コミットを分類し CHANGELOG.md を生成 |
| [3/4] git commit + tag | release: vX.X.X でコミット→vX.X.X タグ作成 |
| [4/4] サマリー表示 | バージョン変化、タグ名、次のステップを表示 |
途中から再開
リリース作業の途中から再開する場合は、現在の状態を確認する。
Example:
ユーザー: 「品質ゲートは通った。リリースを実行したい」
回答: --preflight の結果を確認し、全チェック通過を検証する。
--patch / --minor / --major のいずれかでリリースを実行する。
トラブルシューティング
- working tree がクリーンでない: 変更をコミットまたは
git stashしてからリリース再実行する - テスト失敗: テストを修正してからリリースを再実行する
- リリースを元に戻したい: リモートプッシュ前なら
git tag -d vX.X.X && git reset --hard HEAD~1
コンテキスト管理
品質ゲート完了後、CHANGELOG 生成後、リリースコミット完了後に /compact を実施する。
注意事項
- ビルドツール・パッケージマネージャーがセットアップ済み、依存関係インストール済みであること（前提条件）
- working tree がクリーンでないとリリース不可
- リリース前に必ずドライランで内容を確認する
- Conventional Commits でコミットメッセージを記述し CHANGELOG の品質を確保する
関連スキル
git-commit— Conventional Commits 準拠のコミット作成managing-operations— デプロイ・運用管理planning-releases— リリース・イテレーション計画orchestrating-development— 開発フェーズ全体のワークフロー
Related Skills
k2works/validating-iteration-plan
tools
VerifiedTrustedCommunity
イテレーション計画と上流設計ドキュメント群（ユーザーストーリー、ドメインモデル、データモデル、UI 設計）との整合性を検証する。「イテレーション計画を検証したい」「計画の整合性をチェックして」「イテレーション計画を作成した」「計画と設計ドキュメントの不整合を確認したい」といった場面で発動する。planning-releases でイテレーション計画を作成した直後にも積極的に使用すること。計画作成後に必ず本検証を実施することで、開発着手前にドキュメント間の不整合を検知・修正できる。
SKILL.mdUpdated Apr 16, 2026
k2works/tracking-progress
tools
VerifiedTrustedCommunity
プロジェクトの開発進捗を多角的に分析しレポートを生成。イテレーション達成度、技術実装状況、品質メトリクスを確認し、計画ドキュメントを自動更新する。「進捗を確認したい」「プロジェクトの状態を知りたい」「イテレーションの達成度を分析したい」「進捗ドキュメントを更新したい」といった場面で発動する。定期的な進捗可視化により、遅延や品質低下を早期に発見しプロジェクトの透明性を確保する。
SKILL.mdUpdated Apr 16, 2026
k2works/syncing-github-project
testing
VerifiedTrustedCommunity
リリース計画を GitHub Project・Issue・Milestone に反映し一元管理。初回の一括同期から差異検出・自動同期まで対応する。「GitHub Project に同期したい」「Issue を作成したい」「計画と GitHub の差異を確認したい」「Milestone を設定したい」といった場面で発動する。計画ドキュメントを Single Source of Truth とし GitHub に自動反映することで、二重管理の手間と不整合を排除する。
SKILL.mdUpdated Apr 16, 2026
k2works/practicing-getting-start-tdd
development
VerifiedTrustedCommunity
テスト駆動開発から始めるプログラミング入門」の対話式チュートリアル。FizzBuzz を題材に TDD の Red-Green-Refactor サイクルを 14 言語で体験する。「TDD を練習したい」「FizzBuzz で TDD を学びたい」「テスト駆動開発の入門をしたい」「Java で TDD を体験したい」「Python で TDD を始めたい」「プログラミング入門チュートリアルをやりたい」「getting-start-tdd をやりたい」「TDD のハンズオンがしたい」「Red-Green-Refactor を体験したい」といった場面で発動する。TDD チュートリアルやプログラミング入門の要望があれば積極的に使用すること。
SKILL.mdUpdated Apr 16, 2026