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 项目简介
90 lines
3.4 KiB
Markdown
90 lines
3.4 KiB
Markdown
# 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 必须写清内容
|