docs(整合): 在 CLAUDE.md 中添加提交前更新 changelog 的规范

- 在操作流程规范中增加「更新 changelog」步骤
- 新增「更新 changelog 规范」章节,详细说明字段格式和注意事项
- 要求每次提交前必须更新 src/data/changelog.json
- 提供完整的字段说明和示例代码

via [HAPI](https://hapi.run)

Co-Authored-By: HAPI <noreply@hapi.run>
This commit is contained in:
ittoview
2026-03-08 03:28:12 +00:00
parent c5c19362c5
commit c15e54fd8c
2 changed files with 64 additions and 3 deletions

View File

@@ -327,9 +327,63 @@ import { useAppStore } from '@/stores/useAppStore'
每次完成数据更新后,必须按以下步骤操作: 每次完成数据更新后,必须按以下步骤操作:
1. **询问提交**:数据更新完成后,询问用户是否提交推送,不得自动提交 1. **更新 changelog**:在提交前,必须先更新 `src/data/changelog.json`,添加本次变更记录
2. **构建检查**:用户确认提交前,运行 `npm run build`,确保无类型错误和编译错误(无需每次修改后立即检查,在提交推送前统一检查即可) 2. **询问提交**:数据更新完成后,询问用户是否提交推送,不得自动提交
3. **提交推送**:构建通过后执行 `git add` + `git commit` + `git push` 3. **构建检查**:用户确认提交前,运行 `npm run build`,确保无类型错误和编译错误(无需每次修改后立即检查,在提交推送前统一检查即可)
4. **提交推送**:构建通过后执行 `git add` + `git commit` + `git push`
---
### 更新 changelog 规范
**文件:** `src/data/changelog.json`
每次提交代码前,必须在 `changelogEntries` 数组开头添加一条新记录:
```json
{
"id": "YYYY-MM-DD-brief-description",
"date": "YYYY-MM-DD",
"type": "feat|fix|style|refactor|docs|perf|test|chore",
"title": "简短描述本次变更内容",
"scope": "整合|范围|进度|成本|质量|资源|沟通|风险|采购|相关方|练习|矩阵等"
}
```
**字段说明:**
- `id`:唯一标识符,格式为 `日期-简短描述`,使用小写字母和连字符
- `date`:提交日期,格式 `YYYY-MM-DD`
- `type`:变更类型,与 Git 提交规范的 type 保持一致
- `title`:变更标题,简洁描述本次变更的内容
- `scope`:关联范围,与 Git 提交规范的 scope 保持一致
**注意事项:**
- 新记录添加在数组开头(最新记录在最前)
- `title` 中如需使用引号,使用「」而非 "",避免 JSON 解析错误
- 每次提交只添加一条记录,对应本次 commit
- `type``scope` 应与 Git 提交信息保持一致
**示例:**
```json
{
"changelogEntries": [
{
"id": "2026-03-08-changelog-modal",
"date": "2026-03-08",
"type": "feat",
"title": "新增更新时间轴浏览页面与顶部快捷入口",
"scope": "整合"
},
{
"id": "2026-03-08-practice-fix-offset",
"date": "2026-03-08",
"type": "fix",
"title": "修正底部固定区域偏移方式",
"scope": "练习"
}
]
}
```
--- ---

View File

@@ -1,5 +1,12 @@
{ {
"changelogEntries": [ "changelogEntries": [
{
"id": "2026-03-08-update-changelog-rule",
"date": "2026-03-08",
"type": "docs",
"title": "在 CLAUDE.md 中添加提交前更新 changelog 的规范",
"scope": "整合"
},
{ {
"id": "2026-03-08-changelog-modal", "id": "2026-03-08-changelog-modal",
"date": "2026-03-08", "date": "2026-03-08",