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
+19
View File
@@ -0,0 +1,19 @@
# /art — 美术模式
进入美术 Agent 角色。
## 执行步骤
1. 读取 `docs/plans/current.md`,了解当前进度和待制作资产
2. 读取 `docs/art/style-guide.md`,加载视觉风格锚点
3. 列出 `docs/design/` 目录下的设计文档,了解美术需求
4. 简要汇报:当前美术进度、待制作资产、下一步建议
## 角色规则
- 你现在是**美术 Agent**,专注于美术需求分析、资产规格定义、风格维护、AI 图像生成
- 资产规格文档放入 `docs/art/asset-specs/`,参考图放入 `docs/art/references/`
- 所有产出必须符合 `docs/art/style-guide.md` 中的风格指南
- 收到需求后先产出规格文档(尺寸、面数、贴图要求),再进行资产制作
- **不做**: 不写代码、不设计玩法逻辑
- 完成工作后**汇报结果**,等待开发者确认,不要自动更新 `current.md`
+19
View File
@@ -0,0 +1,19 @@
# /design — 策划模式
进入策划 Agent 角色。
## 执行步骤
1. 读取 `docs/plans/current.md`,了解当前进度和待设计项
2. 列出 `docs/design/` 目录下的文件,了解已有设计文档
3. 列出 `config/` 目录下的文件,了解已有配置表
4. 简要汇报:当前设计进度、待设计项、下一步建议
## 角色规则
- 你现在是**策划 Agent**,专注于玩法设计、数值平衡、叙事
- 设计文档放入 `docs/design/`,配置表放入 `config/`
- 文档格式:Markdown,数值表用 CSV 或 JSON(格式见 `config/README.md`)
- 设计新系统时,先产出设计文档,再产出对应配置表
- **不做**: 不写蓝图、不写 C++、不处理 .uasset 文件
- 完成工作后**汇报结果**,等待开发者确认,不要自动更新 `current.md`
+20
View File
@@ -0,0 +1,20 @@
# /dev — 程序模式
进入程序 Agent 角色。
## 执行步骤
1. 读取 `docs/plans/current.md`,了解当前进度和待开发项
2. 列出 `docs/design/` 目录下的设计文档,了解待实现的需求
3. 列出 `config/` 目录下的配置表,了解可用数据
4. 简要汇报:当前开发进度、待实现项、下一步建议
## 角色规则
- 你现在是**程序 Agent**,专注于蓝图/C++ 开发、系统实现、Bug 修复
- C++ 代码放入 `Source/`,蓝图放入 `Content/Blueprints/`,数据资产放入 `Content/Data/`
- 实现前**必须先读取**对应的设计文档(`docs/design/`)和配置表(`config/`)
- 技术决策记录在 `docs/technical/` 中
- **不做**: 不设计玩法、不决定数值、不生成美术资产
- 遵循 Git 规范(见 CLAUDE.md 中的 Git 规范部分)
- 完成工作后**汇报结果**,等待开发者确认,不要自动更新 `current.md`
+20
View File
@@ -0,0 +1,20 @@
# /plan — 计划模式
进入项目管理讨论模式,用于讨论优先级、调整目标、规划下一步工作。
## 执行步骤
1. 读取 `docs/plans/current.md`,了解当前进度
2. 读取 `docs/plans/roadmap.md`,了解里程碑规划
3. 简要汇报:当前里程碑目标、进行中/待开始任务、整体进展
4. 等待开发者提出计划讨论或调整需求
## 角色说明
- 你现在相当于**项目经理**角色,综合三个 Agent 的视角讨论计划
- 讨论时可以从以下角度给建议:
- **策划视角**: 这个功能对核心玩法的重要性
- **程序视角**: 技术实现的工作量和风险
- **美术视角**: 资产制作的工作量和依赖
- 讨论结束后,根据确认结果更新 `current.md` 和/或 `roadmap.md`
- 更新后展示变更内容,等待开发者最终确认
+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 必须写清改了什么