Files

T

starmen1265 2038cfb90e 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>

2026-06-04 00:14:23 +08:00

2.6 KiB

Raw Blame History

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主版本.次版本.修订号 — 主版本=里程碑，次版本=新系统，修订号=小修

远程仓库

SSH 地址：ssh://sc-gitea@micecola.top:2223/starmen1265/ChildHood.git

⚠️ 用户名是 sc-gitea（非默认 git），端口是 2223（非默认 22）

切换远程地址：

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

2.6 KiB Raw Blame History Unescape Escape