docs(common): Git规范文档迁移至docs/common
This commit is contained in:
@@ -1,139 +0,0 @@
|
|||||||
# Git 快速参考(AI 用)
|
|
||||||
|
|
||||||
> 从 [GIT-GUIDE.md](GIT-GUIDE.md) 精简。完整规范见原文。
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 分支策略
|
|
||||||
|
|
||||||
**develop 长期开发分支模型** — 单人开发 + 多 Agent 协作。
|
|
||||||
|
|
||||||
```
|
|
||||||
main ─────────── 永远可玩可编译,受保护,禁止直接推送
|
|
||||||
│
|
|
||||||
│ PR (Gitea) ← 里程碑/迭代结束时,PM 发起
|
|
||||||
│
|
|
||||||
└── develop ──── 长期分支,所有 agent 在此工作
|
|
||||||
```
|
|
||||||
|
|
||||||
| 分支 | 生命期 | 说明 |
|
|
||||||
|---|---|---|
|
|
||||||
| `main` | 永久 | 稳定版本,受保护 |
|
|
||||||
| `develop` | 永久 | 日常开发分支,所有 agent 共用 |
|
|
||||||
|
|
||||||
**辅助分支(可选,用于实验):**
|
|
||||||
|
|
||||||
| 分支 | 前缀 | 生命期 | 说明 |
|
|
||||||
|---|---|---|---|
|
|
||||||
| 原型 | `prototype/` | 实验完即删 | 技术验证,随便写 |
|
|
||||||
| 发布 | `release/` | 永久 | 从 main 切出,版本标记 |
|
|
||||||
|
|
||||||
**流程:**
|
|
||||||
1. 所有开发在 `develop` 上进行 → 2. 迭代完成时创建 PR → 3. 审查通过后合并回 `main`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 提交规范
|
|
||||||
|
|
||||||
**格式:** `<type>(<scope>): <中文描述>`
|
|
||||||
|
|
||||||
- subject ≤ 50 字符,中文描述,技术术语保留英文
|
|
||||||
- body 可选,每行 ≤ 72 字符
|
|
||||||
|
|
||||||
**Type(必选):**
|
|
||||||
|
|
||||||
| Type | 用途 |
|
|
||||||
|---|---|
|
|
||||||
| `feat` | 新功能 |
|
|
||||||
| `fix` | Bug 修复 |
|
|
||||||
| `art` | 美术资源 |
|
|
||||||
| `level` | 关卡/场景 |
|
|
||||||
| `audio` | 音效/音乐 |
|
|
||||||
| `bp` | 蓝图逻辑 |
|
|
||||||
| `refactor` | 重构(不改功能) |
|
|
||||||
| `config` | 项目/引擎配置 |
|
|
||||||
| `docs` | 文档 |
|
|
||||||
| `wip` | 进行中(未完成) |
|
|
||||||
|
|
||||||
**Scope(可选,常用):**
|
|
||||||
`player` `enemy` `combat` `ui` `camera` `inventory` `dialogue` `quest` `save` `audio` `animation` `ai` `level` `vfx`
|
|
||||||
|
|
||||||
**示例:**
|
|
||||||
```
|
|
||||||
feat(player): 实现角色跳跃和二段跳
|
|
||||||
fix(camera): 修复穿墙时摄像机卡顿问题
|
|
||||||
bp(enemy): 实现巡逻-追击-攻击状态机
|
|
||||||
wip(crafting): 合成系统UI初步框架
|
|
||||||
config: 启用Nanite和Lumen
|
|
||||||
```
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## UE5 注意事项
|
|
||||||
|
|
||||||
- 蓝图与 C++ 分开提交
|
|
||||||
- `.uasset` / `.umap` 无法 diff → commit message 必须写清改了什么
|
|
||||||
- 不提交 `Binaries/` `Intermediate/` `Saved/` `.vs/`
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 版本号
|
|
||||||
|
|
||||||
`v主版本.次版本.修订号` — 主版本=里程碑,次版本=新系统,修订号=小修
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 远程仓库
|
|
||||||
|
|
||||||
**SSH 地址**:`ssh://sc-gitea@micecola.top:2223/starmen1265/ChildHood.git`
|
|
||||||
|
|
||||||
> ⚠️ 用户名是 `sc-gitea`(非默认 `git`),端口是 `2223`(非默认 22)
|
|
||||||
|
|
||||||
**切换远程地址**:
|
|
||||||
```bash
|
|
||||||
git remote set-url origin ssh://sc-gitea@micecola.top:2223/starmen1265/ChildHood.git
|
|
||||||
```
|
|
||||||
|
|
||||||
**SSH config**(`~/.ssh/config`):
|
|
||||||
```
|
|
||||||
Host gitea micecola.top
|
|
||||||
HostName micecola.top
|
|
||||||
Port 2223
|
|
||||||
User sc-gitea
|
|
||||||
IdentityFile ~/.ssh/id_ed25519_gitea
|
|
||||||
IdentitiesOnly yes
|
|
||||||
```
|
|
||||||
|
|
||||||
**内网地址**(家里用):`ssh://sc-gitea@192.168.1.22:2223/starmen1265/ChildHood.git`
|
|
||||||
|
|
||||||
完整规范见 → [GIT-GUIDE.md](GIT-GUIDE.md)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
## 自动化工作流
|
|
||||||
|
|
||||||
`git-workflow.sh` 脚本封装了常用 git 操作:
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# 开始工作:确保在 develop 上且最新
|
|
||||||
bash .claude/scripts/git-workflow.sh ready
|
|
||||||
|
|
||||||
# 提交修改
|
|
||||||
bash .claude/scripts/git-workflow.sh commit <type> <scope> "中文描述"
|
|
||||||
|
|
||||||
# 推送到远程
|
|
||||||
bash .claude/scripts/git-workflow.sh push
|
|
||||||
|
|
||||||
# 查看状态
|
|
||||||
bash .claude/scripts/git-workflow.sh status
|
|
||||||
```
|
|
||||||
|
|
||||||
### PM 发布流程
|
|
||||||
|
|
||||||
```bash
|
|
||||||
# 创建 develop → main PR
|
|
||||||
bash .claude/scripts/git-workflow.sh release "迭代名称"
|
|
||||||
|
|
||||||
# 用户在 Gitea 合并后同步
|
|
||||||
bash .claude/scripts/git-workflow.sh post-release
|
|
||||||
```
|
|
||||||
@@ -23,9 +23,9 @@
|
|||||||
|
|
||||||
## Git 规范
|
## Git 规范
|
||||||
|
|
||||||
详见 [.claude/refs/GIT-GUIDE-LITE.md](.claude/refs/GIT-GUIDE-LITE.md)。核心要点:
|
详见 [docs/common/GIT-GUIDE.md](docs/common/GIT-GUIDE.md)。核心要点:
|
||||||
|
|
||||||
- `main` 永远可玩可编译
|
- `main` 永远可玩可编译
|
||||||
- 分支: `feature/` `fix/` `prototype/` `release/`
|
- 分支: `develop/`
|
||||||
- 提交: `<type>(<scope>): <中文描述>`,subject ≤ 50 字符
|
- 提交: `<type>(<scope>): <中文描述>`,subject ≤ 50 字符
|
||||||
- UE5: 蓝图与 C++ 分开提交;.uasset/.umap commit message 必须写清内容
|
- UE5: 蓝图与 C++ 分开提交;.uasset/.umap commit message 必须写清内容
|
||||||
|
|||||||
Reference in New Issue
Block a user