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 项目简介
33 lines
1.7 KiB
Markdown
33 lines
1.7 KiB
Markdown
# /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 必须写清改了什么
|