ai-agent-team: Skill for Claude Code

changelog-generator - 智能变更日志生成器

概述

当用户需要生成或更新 CHANGELOG 时，此 skill 会自动完成以下流程：

1. 分析 Git 提交历史
2. 根据 Conventional Commits 规范解析提交
3. 智能分类和组织变更
4. 生成符合 Keep a Changelog 标准的 CHANGELOG.md
5. 支持版本发布和增量更新

支持的触发指令

用户可以通过以下方式触发此 skill：

• "changelog" - 简易触发词
• "变更日志" - 简易触发词
• "帮我生成 CHANGELOG" - 生成完整的 CHANGELOG
• "更新 CHANGELOG" - 增量更新 CHANGELOG
• "发布新版本" - 发布正式版本
• "初始化 changelog 配置" - 创建配置文件

工作流程

步骤 1: 初始化配置（首次使用）

命令:

cd ~/.claude/skills/changelog-generator
npm install

# 在项目目录中初始化配置
cd /path/to/your/project
changelog-generate init

配置文件: .changelogrc.json

交互式配置会询问：

• 当前版本号
• 语言选择（中文/英文）
• 是否使用 emoji
• 是否显示作者信息

步骤 2: 生成 CHANGELOG

场景 A: 首次生成完整 CHANGELOG

# 生成所有历史提交的 CHANGELOG
changelog-generate generate --all

# 生成指定范围的 CHANGELOG
changelog-generate generate --from v1.0.0 --to v2.0.0

场景 B: 增量更新 CHANGELOG

# 更新 [Unreleased] 区域
changelog-generate update

# 从指定标签开始更新
changelog-generate update --from v2.0.0

场景 C: 发布新版本

# 自动确定版本号（交互式）
changelog-generate release

# 手动指定版本号
changelog-generate release --version 2.1.0

# 指定日期
changelog-generate release --version 2.1.0 --date 2023-11-10

步骤 3: 输出文件

默认输出路径: ./CHANGELOG.md

生成的 CHANGELOG 示例:

# Changelog

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

## [Unreleased]

## [2.0.0] - 2023-11-10

### 💥 BREAKING CHANGES

- **api:** Remove deprecated v1 endpoints (#123)

### ✨ Features

- **auth:** Add JWT authentication (#120)
- **api:** Add user profile endpoint (#121)

### 🐛 Bug Fixes

- **ui:** Fix button alignment issue (#122)

### 📝 Documentation

- Update API documentation

## [1.0.0] - 2023-10-01

...

核心功能

1. 智能提交解析

支持 Conventional Commits 规范：

feat(auth): add login functionality
^    ^      ^
type scope  subject

BREAKING CHANGE: Remove old auth API

支持的提交类型:

• feat: ✨ Features
• fix: 🐛 Bug Fixes
• docs: 📝 Documentation
• style: 💄 Styles (可隐藏)
• refactor: ♻️ Code Refactoring
• perf: ⚡ Performance
• test: ✅ Tests
• build: 📦 Build System
• ci: 👷 CI/CD
• chore: 🔧 Chores (可隐藏)