feat: 建立项目基础设施
- 添加 CLAUDE.md(项目上下文,AI 自动加载) - 添加三角色 Agent 体系(策划/程序/美术) - 添加 /zqstart /plan /design /dev /art 命令 - 创建 docs/ 目录结构(design/art/technical/plans) - 创建 config/ 数值配置目录 - 添加美术风格指南(3D Lowpoly 温暖怀旧) - 添加进度追踪文件(current.md + roadmap.md) - 精简 Git 规范(GIT-GUIDE-LITE.md) - 更新 README.md 项目简介
This commit is contained in:
@@ -0,0 +1,75 @@
|
||||
# Git 快速参考(AI 用)
|
||||
|
||||
> 从 [GIT-GUIDE.md](GIT-GUIDE.md) 精简。完整规范见原文。
|
||||
|
||||
---
|
||||
|
||||
## 分支策略
|
||||
|
||||
**轻量 Feature Branch** — 单人开发,`main` 永远可玩可编译。
|
||||
|
||||
| 分支 | 前缀 | 生命期 | 说明 |
|
||||
|---|---|---|---|
|
||||
| 主线 | `main` | 永久 | 稳定版本,不直接在上面开发 |
|
||||
| 功能 | `feature/` | 合并后删 | 新系统、新功能 |
|
||||
| 修复 | `fix/` | 合并后删 | Bug 修复 |
|
||||
| 原型 | `prototype/` | 实验完即删 | 技术验证,随便写 |
|
||||
| 发布 | `release/` | 永久 | 从 main 切出,版本标记 |
|
||||
|
||||
**命名规则:** `<类型>/<小写连字符描述>`
|
||||
```
|
||||
feature/player-movement fix/camera-clipping release/v0.1
|
||||
```
|
||||
|
||||
**流程:**
|
||||
1. 从 `main` 拉分支 → 2. 开发并提交 → 3. 测试通过后合并回 `main` → 4. 删除分支
|
||||
|
||||
---
|
||||
|
||||
## 提交规范
|
||||
|
||||
**格式:** `<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主版本.次版本.修订号` — 主版本=里程碑,次版本=新系统,修订号=小修
|
||||
Reference in New Issue
Block a user