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,89 @@
|
||||
# ChildHood(我的童年)
|
||||
|
||||
> 80年代中国乡村童年生活模拟 · UE5.7.4 · 3D Lowpoly · 单人独立开发
|
||||
|
||||
## 项目概况
|
||||
|
||||
- **引擎**: Unreal Engine 5.7.4
|
||||
- **美术风格**: 3D Lowpoly,温暖色调,怀旧氛围
|
||||
- **核心玩法**: 模拟80年代中国乡村儿童的日常生活(弹珠、跳绳、捉虫、探险等)
|
||||
- **开发者**: starmen1265(单人独立开发)
|
||||
- **仓库**: E:\MiceCola\work\ChildHood
|
||||
|
||||
---
|
||||
|
||||
## Agent 角色
|
||||
|
||||
本项目使用三个 AI Agent 协作,各有明确职责边界。
|
||||
|
||||
### 策划 Agent(Design)
|
||||
|
||||
- **职责**: 玩法设计、数值平衡、剧情/叙事、系统机制设计
|
||||
- **输出位置**: `docs/design/`(设计文档)、`config/`(数值配置表)
|
||||
- **输出格式**: Markdown 文档 + CSV/JSON 配置表
|
||||
- **不做**: 不写蓝图,不写 C++,不处理 .uasset 文件
|
||||
|
||||
### 程序 Agent(Programming)
|
||||
|
||||
- **职责**: 蓝图/C++ 开发、系统实现、技术架构、Bug 修复
|
||||
- **输出位置**: `Source/`(C++)、`Content/Blueprints/`(蓝图)、`Content/Data/`(DataAsset)
|
||||
- **依赖**: 读取 `docs/design/` 中的设计文档和 `config/` 中的配置表作为需求来源
|
||||
- **不做**: 不设计玩法,不决定数值,不生成美术资产
|
||||
|
||||
### 美术 Agent(Art)
|
||||
|
||||
- **职责**: 美术需求分析、资产规格定义、风格指南维护、AI 图像生成
|
||||
- **输出位置**: `docs/art/`(美术规格)、`Content/`(经 UE5 导入后的资产)
|
||||
- **参考**: `docs/art/style-guide.md`(风格指南,所有美术产出的锚点)
|
||||
- **不做**: 不写代码,不设计玩法逻辑
|
||||
|
||||
---
|
||||
|
||||
## 协作规则
|
||||
|
||||
1. **策划先行**: 设计文档放 `docs/design/`,配置表放 `config/`,其他 Agent 以此为需求源
|
||||
2. **程序读设计**: 程序 Agent 实现前必须先读取对应的设计文档和配置表
|
||||
3. **美术读需求**: 美术 Agent 收到需求后先产出规格文档,再进行资产制作
|
||||
4. **冲突时策划说了算**: 玩法/数值/叙事的最终决定权在策划角色
|
||||
5. **文档即交接**: Agent 之间不直接通信,通过共享文档目录交接
|
||||
|
||||
---
|
||||
|
||||
## 进度管理
|
||||
|
||||
- **进度追踪**: `docs/plans/current.md`
|
||||
- **里程碑路线**: `docs/plans/roadmap.md`
|
||||
- **计划讨论**: 使用 `/plan` 命令,综合三个角色视角讨论优先级和目标调整
|
||||
|
||||
**规则(严格遵守)**:
|
||||
- 代理完成工作后**汇报结果**,不自动勾选 `[x]`
|
||||
- 开发者确认后,由代理或开发者勾选
|
||||
- 里程碑和任务的新增/调整由开发者决定,代理可建议
|
||||
- 任何代理都可根据开发者指示更新 `current.md` 和 `roadmap.md`
|
||||
- 每次执行 `/zqstart` 时自动展示当前进度
|
||||
|
||||
---
|
||||
|
||||
## 目录约定
|
||||
|
||||
```
|
||||
config/ # 游戏数值配置(CSV/JSON),策划维护
|
||||
docs/
|
||||
design/ # 策划文档(玩法、系统、剧情)
|
||||
art/ # 美术规格、风格指南
|
||||
technical/ # 技术架构、实现笔记
|
||||
plans/ # 开发计划、进度追踪
|
||||
Content/ # UE5 内容(蓝图、模型、贴图等)
|
||||
Source/ # C++ 源代码
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## Git 规范
|
||||
|
||||
详见 [docs/GIT-GUIDE-LITE.md](docs/GIT-GUIDE-LITE.md)。核心要点:
|
||||
|
||||
- `main` 永远可玩可编译
|
||||
- 分支: `feature/` `fix/` `prototype/` `release/`
|
||||
- 提交: `<type>(<scope>): <中文描述>`,subject ≤ 50 字符
|
||||
- UE5: 蓝图与 C++ 分开提交;.uasset/.umap commit message 必须写清内容
|
||||
Reference in New Issue
Block a user