docs(design): 交互系统执行案与项目文档整理
- 新增交互系统执行案 (P-002a),含层级状态模型、行为规则、边界情况 - 新增概念草案 concept.md、头脑风暴记录 - 新增 Agent 配置 (策划/PM/程序) 及角色记忆 - 新增 P-002 质量门审查报告、任务汇报、工作日志 - 更新路线图、current.md 等项目计划文档 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
+99
-64
@@ -1,83 +1,118 @@
|
||||
# 当前进度
|
||||
|
||||
> 最后更新:2026-06-03
|
||||
> 最后更新:2026-06-05
|
||||
> 代理完成工作后汇报结果,由开发者确认后才勾选 ✔
|
||||
|
||||
## 当前里程碑:v0.1 场景漫游与环境交互
|
||||
## 当前阶段
|
||||
|
||||
**开发阶段**: 原型阶段
|
||||
**阶段路线图**: `docs/plans/prototype-roadmap.md`
|
||||
**设计目录**: `docs/design/prototype/`
|
||||
- **开发阶段**:原型阶段
|
||||
- **当前版本**:v0.1
|
||||
- **版本验证目标**:"世界有味道" — 角色控制 + 交互系统 + 6 区域白盒 + 收集计数
|
||||
- **关注问题**:这个世界好玩吗?美术风格对吗?技术方案跑得通吗?
|
||||
|
||||
### 流水线状态
|
||||
- 当前阶段:④执行案(①②③基本就绪)
|
||||
- 阻塞点:执行案缺失,需先补齐执行案
|
||||
## 原型阶段退出标准
|
||||
|
||||
### 进行中
|
||||
- [ ] 用户主观判断核心玩法已验证通过
|
||||
- [ ] `prototype/` 最终版复制到 `production/`
|
||||
|
||||
> 按流水线阶段和优先级排列
|
||||
> 原型阶段使用版本开发流水线(③-⑦),执行质量门审查。
|
||||
> 原型阶段灵活性:⑤⑥允许交替推进,不必严格串行。
|
||||
|
||||
- [ ] 整理全局设计文档,按规范放置 — ①全局设计
|
||||
- [ ] 产出 v0.1 版本设计文档(v01-design.md)— ③版本设计
|
||||
- [ ] 产出玩家控制器执行案(player-controller-execution.md)— ④执行案
|
||||
- [ ] 产出交互系统执行案(interaction-system-execution.md)— ④执行案
|
||||
- [ ] 产出收集系统 v0.1 执行案(collection-system-execution.md)— ④执行案
|
||||
## v0.1 流水线进度
|
||||
|
||||
### 待开始
|
||||
| 步骤 | 状态 | 说明 |
|
||||
|------|------|------|
|
||||
| ① 设计案 | ✅ 已有素材 | `docs/design/prototype/` 下 10 份设计文档 |
|
||||
| ② 阶段路线图 | ✅ 已有 | `docs/plans/prototype-roadmap.md` |
|
||||
| ③ 执行案 | 🔴 质量门未通过 | 审查报告 `docs/plans/reviews/P-002-review.md`,需创建独立执行案并修正 |
|
||||
| ④ 程序设计 | ⬜ 未开始 | 依赖 ③ 完成并通过质量门 |
|
||||
| ⑤ 美术产出 | ⬜ 未开始 | 白盒场景 + 占位资产 |
|
||||
| ⑥ 程序实现 | ⬜ 未开始 | 原型阶段允许与 ⑤ 交替推进 |
|
||||
| ⑦ 版本复盘 | ⬜ 未开始 | -- |
|
||||
|
||||
- [ ] 执行案质量门审查 — PM
|
||||
- [ ] 玩家控制器程序设计(player-controller-tech.md)— ⑤程序设计
|
||||
- [ ] 交互系统程序设计(interaction-system-tech.md)— ⑤程序设计
|
||||
- [ ] 收集系统程序设计(collection-system-tech.md)— ⑤程序设计
|
||||
- [ ] 程序设计质量门审查 — PM
|
||||
- [ ] v0.1 美术资产产出 — ⑥美术产出(v0.1 允许开发者自行处理占位资源)
|
||||
- [ ] 美术资产验收门审查 — PM
|
||||
- [ ] 清理引擎模板变体代码 — ⑦实现(无流水线依赖,可并行)
|
||||
- [ ] 角色控制器实现 — ⑦实现
|
||||
- [ ] 交互系统实现 — ⑦实现
|
||||
- [ ] v0.1 场景白盒搭建(6个区域)— ⑦实现
|
||||
- [ ] 收集计数系统实现 — ⑦实现
|
||||
- [ ] v0.1 验收测试
|
||||
- [ ] 文档同步(更新设计案/执行案匹配实现)
|
||||
## 进行中
|
||||
|
||||
### 已完成
|
||||
> 按优先级排列,建议从上到下依次完成
|
||||
|
||||
- [x] Git 分支策略与提交规范
|
||||
- [x] 项目目录结构与协作体系设计
|
||||
- [x] 建立项目基础设施(目录结构、规范文档)
|
||||
- [x] 游戏愿景文档(game-vision.md)
|
||||
- [x] v0.1 范围定义(v01-scope.md)
|
||||
- [x] 玩家控制设计(player-controller.md)
|
||||
- [x] 交互系统设计(interaction-system.md)
|
||||
- [x] v0.1 场景设计(scene-v01-suburban.md)
|
||||
- [x] 修正项目时代设定(CLAUDE.md + style-guide.md)
|
||||
- [x] 收集系统设计(collection-system.md)
|
||||
- [x] Brainstorm 讨论记录(brainstorm-2026-06-01)— 阶段 1-5 全部完成
|
||||
- [x] 场景与世界观详细设计(scene-world.md)
|
||||
- [x] 小游戏系统设计(minigame-system.md)
|
||||
- [x] 叙事框架设计(narrative-framework.md)
|
||||
- [x] 主角角色设计(protagonist-character.md)
|
||||
- [x] 开发流程重构:四阶段框架 + 阶段目录 + 文档同步
|
||||
- [x] **P-001** 原型阶段启动准备 ✔ 2026-06-05
|
||||
- ✅ 全面重新评估并更新 `prototype-roadmap.md`(3→4 版本)
|
||||
- ✅ 同步更新 `roadmap.md`
|
||||
- ✅ 建立角色汇报机制(`docs/plans/reports/`)
|
||||
- ✅ 归档草案阶段文档
|
||||
|
||||
---
|
||||
- [ ] **P-002** v0.1 ③执行案 — 质量门未通过,需修正后重新提交
|
||||
- 审查报告:`docs/plans/reviews/P-002-review.md`
|
||||
- 以下 3 个子任务按顺序完成,全部完成后重新提交质量门
|
||||
|
||||
## 设计文档状态
|
||||
- [ ] **P-002a** 交互系统执行案
|
||||
- 产出:`docs/design/prototype/interaction-system-execution.md`
|
||||
- 依赖素材:`docs/design/prototype/interaction-system.md`(原始设计案)
|
||||
- 参考范围:`docs/design/prototype/v01-scope.md`
|
||||
- **阻塞问题**(必须修正):
|
||||
1. 创建独立执行案文件(含迭代记录表头)
|
||||
2. 移除技术越界内容:JSON 数据结构定义(原文件第170-193行)、程序实现注释(原文件第1行)、白盒占位模型需求(原文件第255-282行)
|
||||
3. 补充边界情况:交互中断行为、多交互物重叠键位冲突、推镜目标不可达、快速连续按键防护
|
||||
- **建议修正**:
|
||||
- 交互取消行为链补完
|
||||
- 废纸箱翻找结果的随机机制明确化
|
||||
- 交互中角色可移动范围/速度限制明确化
|
||||
|
||||
### 已完成(均位于 `docs/design/prototype/`)
|
||||
- [ ] **P-002b** 收集系统执行案
|
||||
- 产出:`docs/design/prototype/collection-system-execution.md`
|
||||
- 依赖素材:`docs/design/prototype/collection-system.md`(原始设计案)
|
||||
- 参考范围:`docs/design/prototype/v01-scope.md`、`docs/design/prototype/scene-world.md`(区域分布)
|
||||
- **阻塞问题**(必须修正):
|
||||
1. 创建独立执行案文件(含迭代记录表头)
|
||||
2. 扩展 v0.1 执行内容:10 个拾取品清单、计数 UI 位置/格式、区域分布规则、与交互系统的关联
|
||||
3. 补充边界情况:一次性拾取确认、全部收集完表现、重启状态处理、拾取中断处理
|
||||
|
||||
- [x] `game-vision.md` — 游戏愿景
|
||||
- [x] `v01-scope.md` — v0.1 范围定义
|
||||
- [x] `player-controller.md` — 玩家控制设计
|
||||
- [x] `interaction-system.md` — 交互系统设计
|
||||
- [x] `scene-v01-suburban.md` — v0.1 场景设计
|
||||
- [x] `collection-system.md` — 收集系统设计
|
||||
- [x] `minigame-system.md` — 小游戏系统设计
|
||||
- [x] `narrative-framework.md` — 叙事框架设计
|
||||
- [x] `scene-world.md` — 场景与世界观详细设计
|
||||
- [x] `protagonist-character.md` — 主角角色设计
|
||||
- [ ] **P-002c** 角色控制执行案
|
||||
- 产出:`docs/design/prototype/player-controller-execution.md`
|
||||
- 依赖素材:`docs/design/prototype/player-controller.md`(原始设计案)
|
||||
- 参考范围:`docs/design/prototype/v01-scope.md`、`docs/design/prototype/protagonist-character.md`
|
||||
- **阻塞问题**(必须修正):
|
||||
1. 创建独立执行案文件(含迭代记录表头)
|
||||
- **建议修正**:
|
||||
- 明确 WASD 相对角色朝向还是相对摄像机方向
|
||||
- 补充视角垂直角度限制
|
||||
- 第1行注释移除"动画蓝图"技术术语
|
||||
|
||||
### 待产出
|
||||
- [ ] **P-003** v0.1 ④程序设计
|
||||
- 依赖:P-002 完成
|
||||
- 基于执行案设计实现方案(类/组件架构、数据流、美术需求清单)
|
||||
- 提交程序设计质量门
|
||||
|
||||
- [ ] `docs/plans/roadmap.md` 更新 — 路线图补全 v0.5-v0.7
|
||||
- [ ] `economy-system.md` — 零花钱经济系统设计(v0.3 前产出即可)
|
||||
- [ ] `time-system.md` — 一天时间循环系统设计(v0.3 前产出即可)
|
||||
- [ ] **P-004** v0.1 ⑤美术 + ⑥程序实现
|
||||
- 依赖:P-003 完成
|
||||
- 白盒场景 + 占位资产 → 编写代码实现
|
||||
- 原型阶段允许⑤⑥交替推进
|
||||
|
||||
- [ ] **P-005** v0.1 ⑦版本复盘
|
||||
- 依赖:P-004 完成
|
||||
- 程序汇报偏差 → PM 协调 → 策划更新文档
|
||||
|
||||
## 可用素材
|
||||
|
||||
> `docs/design/prototype/` 下的设计文档 + 草案阶段产出:
|
||||
|
||||
| 文档 | 内容 | 用途 |
|
||||
|------|------|------|
|
||||
| `game-vision.md` | 愿景、核心情感、三大支柱 | 设计案参考 |
|
||||
| `brainstorm-2026-06-01-*.md` | 5 阶段讨论记录 | 素材来源 |
|
||||
| `scene-world.md` | 场景与世界观详细设计 | 执行案:场景白盒 |
|
||||
| `protagonist-character.md` | 主角角色设计 | 执行案:角色控制 |
|
||||
| `narrative-framework.md` | 叙事框架 | 后续版本参考 |
|
||||
| `minigame-system.md` | 小游戏体系设计 | v0.2 参考 |
|
||||
| `collection-system.md` | 收集系统设计 | 执行案:收集系统 |
|
||||
| `interaction-system.md` | 交互系统设计 | 执行案:交互系统 |
|
||||
| `player-controller.md` | 玩家控制设计 | 执行案:角色控制 |
|
||||
| `v01-scope.md` | v0.1 范围定义 | 范围界定 |
|
||||
| `../concept.md` | 玩法概念草案(7 字段齐全) | 核心概念参考 |
|
||||
| `docs/technical/feasibility-assessment.md` | 技术可行性评估(10 系统) | 程序设计参考 |
|
||||
|
||||
## 已归档
|
||||
|
||||
- 草案阶段全部工作 → `docs/plans/archive/draft/`
|
||||
- 基础设施、头脑风暴、10 份设计文档 → `pre-draft.md`
|
||||
- D-001 玩法概念草案 → `docs/design/concept.md`(保留在位,归档记录)
|
||||
- D-002 技术可行性评估 → `docs/technical/feasibility-assessment.md`(保留在位,归档记录)
|
||||
|
||||
Reference in New Issue
Block a user