# Changelog

> Use when generating a CHANGELOG entry for bit-framework based on git commits since the last tag.

- Skill: `tomevault-io/changelog-11` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/changelog-11`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/changelog-11/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/changelog-11

---


# Changelog

根据 git log 自动生成 CHANGELOG 条目，追加到 CHANGELOG.md 文件顶部。

## 用法

```
/changelog
```

## 执行步骤

### 第一步：获取上一个 tag

```bash
git describe --tags --abbrev=0
```

如果没有 tag，使用第一个 commit 作为起点：
```bash
git rev-list --max-parents=0 HEAD
```

### 第二步：获取 commits

```bash
git log {last_tag}..HEAD --oneline --no-merges
```

### 第三步：分类整理

将 commits 按前缀分类：

| 前缀 | 分类 |
|------|------|
| `feat` | Added（新增功能）|
| `fix` | Fixed（Bug 修复）|
| `refactor` | Changed（重构/改动）|
| `docs` | Documentation（文档）|
| `chore` | Chore（构建/版本/配置）|
| 其他 | Changed |

过滤掉纯版本 bump 的 commit（`chore: bump version`）。

### 第四步：获取当前版本号

```bash
cat package.json | grep '"version"' | head -1
```

### 第五步：生成 CHANGELOG 条目

格式：

```markdown
## [x.x.x] - YYYY-MM-DD

### Added
- feat: xxx (commit hash)

### Fixed
- fix: xxx (commit hash)

### Changed
- refactor: xxx (commit hash)

### Chore
- chore: xxx (commit hash)
```

日期使用今天的日期。只包含有内容的分类。

### 第六步：写入文件

如果 `CHANGELOG.md` 不存在，创建并写入：
```markdown
# Changelog

{新条目}
```

如果已存在，将新条目插入到第一个 `## [` 之前（保留文件头部的标题）。

### 完成

展示生成的 CHANGELOG 条目内容，告知已写入文件。

---
> Source: [gongxh0901/bit-framework](https://github.com/gongxh0901/bit-framework) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-06-24 -->