Back to Skills

changelog

verified

CHANGELOG and release notes generation guide. Supports Conventional Commits, Keep a Changelog format, and Semantic Versioning.

View on GitHub

Marketplace

ai-agent-setup

sk8metalme/ai-agent-setup

Plugin

development-toolkit

Repository

sk8metalme/ai-agent-setup
1stars

plugins/development-toolkit/skills/changelog/SKILL.md

Last Verified

January 25, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/sk8metalme/ai-agent-setup/blob/main/plugins/development-toolkit/skills/changelog/SKILL.md -a claude-code --skill changelog

Installation paths:

Claude
.claude/skills/changelog/
Powered by add-skill CLI

Instructions

# CHANGELOG生成スキル

## 目的

プロジェクトの変更履歴を適切に管理し、ユーザーにとって有用なCHANGELOGとリリースノートを生成する。

## CHANGELOG形式

### Keep a Changelog形式(推奨)

[Keep a Changelog](https://keepachangelog.com/)に準拠した形式:

```markdown
# Changelog

All notable changes to this project will be documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [Unreleased]

### Added
- 新機能A
- 新機能B

### Changed
- 変更された機能C

### Deprecated
- 非推奨となった機能D

### Removed
- 削除された機能E

### Fixed
- 修正されたバグF

### Security
- セキュリティ修正G

## [1.0.0] - 2024-01-15

### Added
- 初回リリース
- 基本機能の実装

[Unreleased]: https://github.com/user/repo/compare/v1.0.0...HEAD
[1.0.0]: https://github.com/user/repo/releases/tag/v1.0.0
```

### カテゴリの意味

| カテゴリ | 説明 | 例 |
|---------|------|-----|
| **Added** | 新機能 | 新しいAPI、新しいコマンド |
| **Changed** | 既存機能の変更 | パラメータ変更、デフォルト値変更 |
| **Deprecated** | 非推奨(将来削除予定) | 古いAPI、レガシー機能 |
| **Removed** | 削除された機能 | 非推奨だった機能の削除 |
| **Fixed** | バグ修正 | クラッシュ修正、表示バグ修正 |
| **Security** | セキュリティ修正 | 脆弱性対応、CVE修正 |

## Conventional Commits

### フォーマット

```
<type>[optional scope]: <description>

[optional body]

[optional footer(s)]
```

### タイプ一覧

| Type | 説明 | CHANGELOGカテゴリ |
|------|------|------------------|
| `feat` | 新機能 | Added |
| `fix` | バグ修正 | Fixed |
| `docs` | ドキュメントのみ | - |
| `style` | コードの意味に影響しない変更 | - |
| `refactor` | リファクタリング | - |
| `perf` | パフォーマンス改善 | Changed |
| `test` | テスト追加・修正 | - |
| `build` | ビルドシステム変更 | - |
| `ci` | CI設定変更 | - |
| `chore` | その他の変更 | - |
| `revert` | コミットの取り消し | - |

### Breaking Changes

**BREAKING CHANGE** を含むコミットはメジャーバージョンアップの対象:

```
feat!: drop support for Node 14

BREAKING CHANGE: Node 14 is no longer supported. Minimum version is Node 16.
```

### 例

#### 新機能
```
feat(auth): add OAuth2 login support

Implemented OAuth2 authentication flow with Google and GitHub providers.
Closes #123
```

#### バグ修正
```
fix(api): handle null response in user endpoin

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
8067 chars