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:
2026-05-31 03:00:41 +08:00
parent bcc146584b
commit b73a3ef098
15 changed files with 503 additions and 2 deletions
+32
View File
@@ -0,0 +1,32 @@
# /zqstart — 项目状态快照
快速查看当前 Git 仓库状态,加载提交/分支规范,为开始工作提供上下文。
## 执行步骤
1. 运行 `git status --short --branch` 获取当前分支名、同步状态和工作区变更
2. 运行 `git log --oneline -3` 查看最近 3 条提交记录
3. 读取 `docs/GIT-GUIDE-LITE.md`,将其中规范作为本次会话的 Git 操作依据
4. 读取 `docs/plans/current.md`,展示当前进度摘要
## 输出格式
请按以下格式**简洁**汇总(不要输出多余信息):
**`当前分支`** branch-name ↑↓ synced/behind/ahead
- 工作区:干净 / 有 N 个未提交修改 / 有 N 个未跟踪文件(仅列出文件名)
- 最近提交:列出 3 条(哈希 + 消息),无多余表格装饰
- 当前进度:列出 current.md 中的进行中和待开始项(仅 `[ ]` 未勾选项),不展示已完成项
---
## Git 操作规范(来自 GIT-GUIDE-LITE.md)
以下规范在本次会话中自动生效,后续所有 Git 操作必须遵守:
- **分支策略**:轻量 Feature Branch。从 `main` 切出 `feature/`、`fix/`、`prototype/` 分支开发,完成后合并回 `main` 并删除。`main` 永远可玩可编译。
- **分支命名**:`<类型>/<小写连字符描述>`,如 `feature/player-movement`、`fix/camera-clipping`
- **提交格式**:`<type>(<scope>): <中文描述>`,subject ≤ 50 字符
- **Type**:`feat` `fix` `art` `level` `audio` `bp` `refactor` `config` `docs` `wip`
- **Scope**(可选):`player` `enemy` `combat` `ui` `camera` `inventory` `dialogue` `quest` `save` `audio` `animation` `ai` `level` `vfx`
- **UE5**:蓝图与 C++ 分开提交;`.uasset`/`.umap` 无法 diff,commit message 必须写清改了什么