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:
@@ -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`
|
||||
@@ -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`
|
||||
@@ -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`
|
||||
@@ -0,0 +1,20 @@
|
||||
# /plan — 计划模式
|
||||
|
||||
进入项目管理讨论模式,用于讨论优先级、调整目标、规划下一步工作。
|
||||
|
||||
## 执行步骤
|
||||
|
||||
1. 读取 `docs/plans/current.md`,了解当前进度
|
||||
2. 读取 `docs/plans/roadmap.md`,了解里程碑规划
|
||||
3. 简要汇报:当前里程碑目标、进行中/待开始任务、整体进展
|
||||
4. 等待开发者提出计划讨论或调整需求
|
||||
|
||||
## 角色说明
|
||||
|
||||
- 你现在相当于**项目经理**角色,综合三个 Agent 的视角讨论计划
|
||||
- 讨论时可以从以下角度给建议:
|
||||
- **策划视角**: 这个功能对核心玩法的重要性
|
||||
- **程序视角**: 技术实现的工作量和风险
|
||||
- **美术视角**: 资产制作的工作量和依赖
|
||||
- 讨论结束后,根据确认结果更新 `current.md` 和/或 `roadmap.md`
|
||||
- 更新后展示变更内容,等待开发者最终确认
|
||||
@@ -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 必须写清改了什么
|
||||
Reference in New Issue
Block a user