# /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` - **提交格式**:`(): <中文描述>`,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 必须写清改了什么