refactor(skills): Agent架构重构——去阶段/去步骤号/审查纯Issue化/工作流拆技能/目录扁平化

- game-reviewer: 删除本地审查记录,仅Issue评论
- quality-gate-review: 删除审查记录/步骤号/阶段标准
- game-dev: 删除阶段感知节,4个工作流详情拆到技能
- game-designer: 删除原型/批量生产阶段,执行案规范拆到技能
- game-pm: 去掉节号和步骤号
- 全局去掉步骤标号(①-⑧/步骤1-5/1.4.X/第一步-第四步)
- 新建技能: code-implementation/deviation-report/design-execution
- 原型目录扁平化: docs/design/prototype/* → docs/design/
- requirements-analysis及子文件去步骤号和阶段引用
- stage-iteration/sketch/roadmap去任务编号
- 更新所有docs/design/路径引用
This commit is contained in:
2026-06-08 16:03:24 +08:00
parent 53a8dc9fed
commit c3c10a9fcb
44 changed files with 435 additions and 508 deletions
+146
View File
@@ -0,0 +1,146 @@
# v0.1 范围定义 — 场景漫游与环境交互
> 本文档明确 v0.1 原型的功能边界,作为程序和美术 Agent 的需求基准。
---
## v0.1 目标
**验证核心问题**: 玩家能否在千禧年城郊场景中感受到"探索的乐趣"和"时代的氛围"?
**体验目标**:
1. 玩家能自由漫步在城郊小街场景中
2. 通过观察和交互,感受到千禧年前后城郊的生活气息
3. 每个可交互物体都提供一小段叙事文本,唤起怀旧感
4. 收集散落的物品,获得探索的满足感
**一句话**: "在一条千禧年的城郊小街上散步,翻翻冰箱、看看小卖部、捡起地上的弹珠。"
---
## In Scope(v0.1 包含)
### 玩家控制
- [x] 第三人称摄像机跟随
- [x] WASD 跑步移动
- [x] E 键交互
### 场景
- [x] 城郊小街白盒场景(6个区域:家、小卖部、街道、空地、巷子、水塘边)
- [x] 基础地面和碰撞体
- [x] 简单的天空盒(夏日晴空)
- [x] 基础光照(午后阳光方向光 + 环境光)
### 交互系统
- [x] 靠近物体显示交互提示 UI
- [x] 观察类交互(25+ 个可观察物体,每个有叙事文本)
- [x] 拾取类交互(10 个收集品)
- [x] 操作类交互(开门)
- [x] 交互后叙事文本的显示 UI
### 收集系统(简化版)
- [x] 拾取物品的计数显示
- [x] 物品获得时的 UI 提示
### 视觉
- [x] Lowpoly 风格的白盒几何体(不需要最终美术资产)
- [x] 用简单颜色区分不同区域和物体
- [x] 基本的场景氛围(暖色调光照)
---
## Out of Scope(v0.1 不包含)
### 明确排除
- ❌ 完整的小游戏系统(弹珠、跳绳等)→ v0.2
- ❌ 时间循环系统(一天四个时段)→ v0.3
- ❌ NPC AI 和移动
- ❌ 对话树 / 对话选择
- ❌ 物品背包 UI(只做计数,不做界面)
- ❌ 物品使用 / 组合系统
- ❌ 任务系统
- ❌ 蹲下系统
- ❌ 跳跃 / 攀爬
- ❌ 手柄支持
- ❌ 音频系统(BGM、音效)→ 后续版本
- ❌ 存档/读档系统
- ❌ 设置菜单(画质、音量等)
- ❌ 多语言支持
- ❌ 过场动画 / 镜头演出
- ❌ 粒子效果(除了基础材质动画)
- ❌ 远景 / 天气系统
---
## 验收标准
### 基础运行
- [ ] 游戏能正常启动并加载场景
- [ ] 角色出现在"家"门口
- [ ] 无崩溃、无严重性能问题(目标:稳定30帧以上)
### 移动体验
- [ ] WASD 移动响应流畅,无延迟感
- [ ] 摄像机跟随平滑,不穿墙
- [ ] 转身和停止有自然的过渡
### 交互体验
- [ ] 靠近可交互物体时正确显示提示
- [ ] 按E键能触发交互,显示叙事文本或拾取物品
- [ ] 叙事文本整句一次性显示(无打字机效果)
- [ ] 离开交互范围时提示自动消失
### 场景体验
- [ ] 6个区域均可到达和探索
- [ ] 每个区域至少有3个可交互物体
- [ ] 场景有基本的视觉辨识度(不同区域有不同感觉)
- [ ] 10个收集品可以全部找到并拾取
### 氛围体验(主观判断)
- [ ] 走在街上能感受到"千禧年城郊"的时代感
- [ ] 交互文本能唤起某种怀旧感或共鸣
- [ ] 整体体验让人想继续探索更多
---
## 与 v0.2 的衔接点
v0.1 完成后,v0.2 将在以下基础上扩展:
1. **新增小游戏**: 在"空地"区域加入弹珠小游戏
- v0.1 的空地已预留了弹珠游戏的位置(地面上的"圈")
- 交互系统可复用和扩展
2. **蹲下系统**: 在交互基础上增加蹲下探索
- 部分隐藏物品需要蹲下才能发现
3. **NPC 对话**: 从简单的观察文本升级为对话系统
- 小卖部老板可以交谈
- 可能出现小伙伴 NPC
4. **音效**: 为场景添加基础音效
- 脚步声、交互音效、环境音
5. **室内空间**: 扩展家的内部和小卖部内部
- v0.1 如果只做了室外,v0.2 补全室内
---
## 开发优先级(供程序 Agent 参考)
1. **P0 — 必须完成**: 角色控制 + 摄像机 + 交互系统核心 + 场景白盒
2. **P1 — 应该完成**: 全部25+观察交互 + 10个拾取品 + 收集计数
3. **P2 — 可以简化**: 叙事文本 UI 效果、光照细节、场景装饰
---
## 预估工作量(粗略)
| 模块 | 预估 | 说明 |
|------|------|------|
| 角色控制器 | 1-2天 | UE5 内置 Character + 摄像机设置 |
| 交互系统 | 2-3天 | 基类 + 检测 + UI 提示 + 文本显示 |
| 场景白盒 | 2-3天 | 6个区域的基础几何体搭建 |
| 交互内容填充 | 1-2天 | 配置25+交互对象的数据 |
| 调试打磨 | 1-2天 | 测试和修复 |
| **合计** | **7-12天** | 单人独立开发节奏 |