starmen1265
b73a3ef098
- 添加 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 项目简介
2.0 KiB
2.0 KiB
Git 快速参考（AI 用）
从 GIT-GUIDE.md 精简。完整规范见原文。
分支策略
轻量 Feature Branch — 单人开发，main 永远可玩可编译。
| 分支 | 前缀 | 生命期 | 说明 |
|---|---|---|---|
| 主线 | main |
永久 | 稳定版本，不直接在上面开发 |
| 功能 | feature/ |
合并后删 | 新系统、新功能 |
| 修复 | fix/ |
合并后删 | Bug 修复 |
| 原型 | prototype/ |
实验完即删 | 技术验证，随便写 |
| 发布 | release/ |
永久 | 从 main 切出，版本标记 |
命名规则： <类型>/<小写连字符描述>
feature/player-movement fix/camera-clipping release/v0.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主版本.次版本.修订号 — 主版本=里程碑，次版本=新系统，修订号=小修