# 01 Git 规范

## 策略

Trunk-Based Development：

- 默认分支：`main`（可发布）。
- 功能分支：`feature/<short-name>`，生命周期尽量 < 2 天。
- 修复：`fix/<short-name>`。
- 不设长期 `develop`。

## Commit

Conventional Commits：

```
<type>(<scope>): <subject>

[optional body]
```

常用 type：`feat` `fix` `refactor` `perf` `style` `docs` `test` `chore`。

scope 示例：`auth` `report` `sdk` `user-h5` `api`。

subject 用英文或中文均可，但同一仓库保持一种；推荐英文短句，说明意图。

## Release

- 打 tag：`v0.1.0`（semver）。
- Changelog 记录在 `apps/docs/CHANGELOG.md`（有正式发布时更新）。

## 禁止

- `git commit --no-verify`（除非负责人明确批准）。
- 强制推送 `main`。
- 提交密钥、`.env`、本地数据库文件。