- 将 CLAUDE.md 移至 .claude/ 目录,精简为 AI 开发指南 - 扩充 README.md 为完整的用户文档 - 新增 rules/mock-spec.md: YAML 配置生成规范 - 新增 rules/commit-spec.md: Git 提交消息格式规范 - 从 .gitignore 移除 .claude/ 目录以便跟踪 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
90 lines
1.6 KiB
Markdown
90 lines
1.6 KiB
Markdown
---
|
||
paths:
|
||
- "**/*"
|
||
---
|
||
|
||
## Git 提交消息规范
|
||
|
||
AI 在生成 commit 消息时必须遵循以下格式。
|
||
|
||
### 格式
|
||
|
||
```
|
||
<类型>(<范围>): <描述>
|
||
|
||
[可选的详细说明]
|
||
|
||
[可选的脚注]
|
||
```
|
||
|
||
### 类型(Type)
|
||
|
||
| 类型 | 说明 |
|
||
|------|------|
|
||
| feat | 新功能(feature) |
|
||
| fix | 修复 bug |
|
||
| docs | 文档更新 |
|
||
| style | 代码格式(不影响功能的变动) |
|
||
| refactor | 代码重构(既非新功能也非 bug 修复) |
|
||
| test | 添加或修改测试 |
|
||
| chore | 构建系统或辅助工具的变动 |
|
||
| perf | 性能优化 |
|
||
|
||
### 范围(Scope)
|
||
|
||
描述提交影响的功能模块或组件(可选)。
|
||
|
||
### 描述(Description)
|
||
|
||
- 简明扼要描述变动内容
|
||
- 首字母小写
|
||
- 不超过 100 个字符
|
||
- 使用祈使句(如 "add" 而非 "added")
|
||
|
||
### 详细说明(Body)
|
||
|
||
- 提供更多上下文和详细说明(可选)
|
||
- 每行不超过 72 个字符
|
||
- 说明"做了什么"和"为什么"
|
||
|
||
### 脚注(Footer)
|
||
|
||
- 破坏性变动说明(如 `BREAKING CHANGE: ...`)
|
||
- 关闭的 Issue(如 `Closes #123`)
|
||
|
||
### 示例
|
||
|
||
**新功能:**
|
||
|
||
```
|
||
feat(api): 添加用户登录端点
|
||
|
||
- 实现 JWT 认证逻辑
|
||
- 添加登录表单前端组件
|
||
- 更新用户服务处理登录请求
|
||
|
||
Closes #45
|
||
```
|
||
|
||
**Bug 修复:**
|
||
|
||
```
|
||
fix(router): 修复路径匹配大小写问题
|
||
|
||
路径匹配在某些情况下区分大小写导致无法正确路由到处理器。
|
||
```
|
||
|
||
**文档更新:**
|
||
|
||
```
|
||
docs: 更新 README 中的安装说明
|
||
```
|
||
|
||
**重构:**
|
||
|
||
```
|
||
refactor(handler): 简化响应处理逻辑
|
||
|
||
将文件响应和内联响应的处理逻辑分离到独立函数中。
|
||
```
|