docs(refs): 移动参考文档至.claude/refs并修复工作流10项逻辑问题

- 移动 development-workflow.md, GIT-GUIDE.md, GIT-GUIDE-LITE.md 至 .claude/refs/
- 修复③引用执行案时序矛盾,改为引用全局设计案系统名
- 区分阶段级前置①②和版本级循环③-⑧的不可跳过声明
- 删除草案阶段'不需要质量门'的自相矛盾表述
- 全局设计案改为'当前阶段目标形态',明确两阶段独立维护
- 文档同步改为⑧版本复盘:程序汇报→PM协调→策划更新
- PM质量门改为斜体注释行,不再与步骤并列
- 新增设计文档层级关系说明(定调→定骨架→填血肉)
- 三道质量门均新增'开发者最终裁决'仲裁机制
- 原型阶段⑤⑥⑦允许交替推进,放松严格串行约束
- 更新 CLAUDE.md 中 GIT-GUIDE-LITE.md 引用路径

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
2026-06-04 00:14:23 +08:00
parent cc0f66ac54
commit 2038cfb90e
4 changed files with 77 additions and 34 deletions
+102
View File
@@ -0,0 +1,102 @@
# 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主版本.次版本.修订号` — 主版本=里程碑,次版本=新系统,修订号=小修
---
## 远程仓库
**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)