---
name: "stage-iteration"
description: "迭代阶段技能 — 版本迭代开发管理。插件检查→设计补充→执行案→需求分析→开发→优化→整合→修复。"
---

# 迭代阶段

> 当 PM 检测到 Pipeline Tracker 标记为「迭代阶段」时调用本技能。
> 目标：按版本迭代推进开发，每个迭代完成一个可玩版本。

---

## 阶段概述

| 项目 | 说明 |
|------|------|
| 目标 | 将设计转化为可玩的迭代版本 |
| 产出 | 可运行的 UE5 版本 |
| 参与角色 | 策划（执行案）、程序（需求分析+开发） |
| 完成标志 | Bug 修复任务关闭 |

---

## 任务序列

每个迭代版本按以下顺序逐步创建任务。**PM 每次激活时只创建下一个可创建的任务**，不要一次全部创建。

### 任务列表（按创建顺序）

| 编号 | 任务名称 | 角色 | 前置依赖 | 首次迭代 |
|------|---------|------|---------|---------|
| 1.4.0 | 插件资产检查与准备 | 程序 | 无 | 仅首次 |
| 1.4.0.5 | 设计案迭代补充 | 策划 | 1.4.0（首次）或无 | 可选 |
| 1.4.1 | 策划执行案 | 策划 | 1.4.0.5 | 必选 |
| 1.4.2 | 程序需求分析 | 程序 | 1.4.1 | 必选 |
| 1.4.3.1 | 关卡搭建 | 程序 | 1.4.2 | 有场景时 |
| 1.4.3.2 | 系统开发 | 程序 | 1.4.2 | 必选 |
| 1.4.3.3 | 优化意见 | 程序 | 1.4.3.1 + 1.4.3.2 | 必选 |
| 1.4.3.5 | 资产接入整合 | 程序 | 1.4.3.3 | 必选 |
| 1.4.4 | Bug 修复 | 程序 | 1.4.3.5 | 必选 |

---

### 各任务详细说明

#### 1.4.0 插件资产检查与准备（仅首次迭代）

```bash
--title "P-XXX 插件资产检查与准备"
--body "## 任务信息
- **任务ID**: P-XXX
- **所属阶段**: 迭代阶段
- **角色**: 程序

## 预期产出
插件资产引用表 \`docs/technical/插件资产引用表.md\`

## 检查内容
1. BlockoutStarterPack — 白模资产完整性检查
   - 路径: Content/BlockingStarterPack/
   - 参考: .claude/refs/blockout-asset-reference.md
2. Lowpoly 角色/场景资源
   - 路径: Content/Lowpoly*/ 或对应插件目录
3. 人物动作相关插件（动画蓝图、骨骼等）
4. 其他已安装插件

## 产出格式
对每个插件/资产包：
- 插件名称和版本
- 安装路径
- 关键资产列表（按类型分类：网格体、材质、动画、音效等）
- 可用性评估（完整/部分可用/缺失）
- 对开发的支持程度说明

## 目的
生成资产引用表，使开发过程可以脱离 3D 美术进行。"
--labels "stage:iteration,role:dev,status:ready"
--assignees "ai-programmer"
```

#### 1.4.0.5 设计案迭代补充（可选）

```bash
--title "D-XXX 设计案迭代补充 — <版本号>"
--body "## 任务信息
- **任务ID**: D-XXX
- **所属阶段**: 迭代阶段
- **角色**: 策划

## 预期产出
对现有设计文档的迭代补充，可能包括：
- 新增系统设计细节
- 调整已有系统参数
- 补充关卡设计细节
- 更新 UI/音频设计

## 说明
每个迭代版本可能对总路线阶段的设计有调整。
策划根据本版本的范围和目标，检查并补充设计文档。
如果设计文档无需调整，此任务可以跳过（直接关闭并说明'无需补充'）。"
--labels "stage:iteration,role:design,status:ready"
--assignees "ai-designer"
```

#### 1.4.1 策划执行案

```bash
--title "D-XXX 策划执行案 — <版本号>"
--body "## 任务信息
- **任务ID**: D-XXX
- **所属阶段**: 迭代阶段
- **角色**: 策划
- **依赖**: D-XXX 设计案迭代补充完成

## 预期产出
根据设计案为本版本写策划执行案：
- 系统执行案（每份系统一份，如 D-XXXa 交互系统执行案）
- 关卡执行案（如涉及场景搭建）

## 执行案要求
- 只写玩家可感知的行为规则
- 不包含引擎组件、代码架构、数据格式
- 每条行为规则清晰无歧义
- 边界情况有明确处理

## 参考文档
- 设计案: docs/design/
- 执行案模板: .claude/refs/level-execution-template.md（关卡执行案）"
--labels "stage:iteration,role:design,status:backlog"
--assignees "ai-designer"
```

#### 1.4.2 程序需求分析

```bash
--title "P-XXX 程序需求分析 — <版本号>"
--body "## 任务信息
- **任务ID**: P-XXX
- **所属阶段**: 迭代阶段
- **角色**: 程序
- **依赖**: D-XXX 策划执行案完成

## 预期产出
技术设计文档（使用 /requirements-analysis 技能）

## 工作方式
基于策划执行案，使用 8 步需求分析技能产出技术设计文档：
1. 特性点枚举
2. 功能域图
3. 类设计图
4. 时序图（条件性）
5. 核心数据结构
6. 复杂接口描述（条件性）
7. 技术风险
8. 工作量估算

## 产出路径
docs/technical/<系统名>-tech.md"
--labels "stage:iteration,role:dev,status:backlog"
--assignees "ai-programmer"
```

#### 1.4.3.1 关卡搭建（有场景时）

```bash
--title "P-XXX 关卡搭建 — <版本号>"
--body "## 任务信息
- **任务ID**: P-XXX
- **所属阶段**: 迭代阶段
- **角色**: 程序
- **依赖**: P-XXX 程序需求分析完成

## 预期产出
白模关卡文件 + 搭建报告

## 搭建流程
参见 .claude/refs/level-execution-template.md 和 game-dev agent 的 Workflow B"
--labels "stage:iteration,role:dev,status:backlog"
--assignees "ai-programmer"
```

#### 1.4.3.2 系统开发

```bash
--title "P-XXX 系统开发 — <版本号>"
--body "## 任务信息
- **任务ID**: P-XXX
- **所属阶段**: 迭代阶段
- **角色**: 程序
- **依赖**: P-XXX 程序需求分析完成

## 预期产出
根据技术设计文档实现各系统代码

## 工作方式
参见 game-dev agent 的 Workflow C"
--labels "stage:iteration,role:dev,status:backlog"
--assignees "ai-programmer"
```

#### 1.4.3.3 优化意见

```bash
--title "P-XXX 优化意见 — <版本号>"
--body "## 任务信息
- **任务ID**: P-XXX
- **所属阶段**: 迭代阶段
- **角色**: 程序
- **依赖**: P-XXX 关卡搭建 + P-XXX 系统开发

## 预期产出
优化意见报告，包含：
- 性能分析（帧率、内存）
- 关卡布局优化建议
- 系统交互优化建议
- 体验改进建议"
--labels "stage:iteration,role:dev,status:backlog"
--assignees "ai-programmer"
```

#### 1.4.3.5 资产接入整合

```bash
--title "P-XXX 资产接入整合 — <版本号>"
--body "## 任务信息
- **任务ID**: P-XXX
- **所属阶段**: 迭代阶段
- **角色**: 程序
- **依赖**: P-XXX 优化意见完成

## 预期产出
整合所有资产到最终关卡中，确保：
- 白模资产正确替换（如有正式资产）
- 所有系统正常交互
- 关卡可完整游玩"
--labels "stage:iteration,role:dev,status:backlog"
--assignees "ai-programmer"
```

#### 1.4.4 Bug 修复

```bash
--title "P-XXX Bug修复 — <版本号>"
--body "## 任务信息
- **任务ID**: P-XXX
- **所属阶段**: 迭代阶段
- **角色**: 程序
- **依赖**: P-XXX 资产接入整合完成

## 工作方式
1. 完整游玩当前版本
2. 记录发现的 Bug
3. 按严重程度排序修复
4. 验证修复后无回归"
--labels "stage:iteration,role:dev,status:backlog"
--assignees "ai-programmer"
```

---

## 进度检查

每次 PM 激活时执行：

1. **读取当前迭代任务状态**：`issue list --milestone "迭代-vX.X" --state open`
2. **判断当前焦点**：
   - 按 1.4.0 → 1.4.0.5 → 1.4.1 → 1.4.2 → 1.4.3.1/2 → 1.4.3.3 → 1.4.3.5 → 1.4.4 顺序
   - 找到第一个未完成的步骤 → 建议：启动对应角色完成该步骤
   - 如果某步骤的依赖未完成 → 建议：先完成依赖任务
3. **只创建下一个可创建的任务**：
   - 已有任务进行中 → 不创建新任务
   - 所有前置依赖已完成 → 创建下一个任务并设为 `status:ready`
4. **检查完成条件**：
   - 1.4.4 (Bug修复) 已关闭 → 触发迭代转换

---

## 迭代转换

**前置条件**：Bug 修复任务（1.4.4）已关闭。

**询问用户**：是否有下一个迭代版本？

### 情况 A：有下一个迭代

```bash
# 1. 关闭当前迭代里程碑
node scripts/gitea.js --role pm milestone update <当前里程碑ID> --state closed

# 2. 创建下一个迭代里程碑
node scripts/gitea.js --role pm milestone create \
  --title "迭代-vX.X" \
  --description "第 N 个迭代版本：<简要描述>"

# 3. 从 1.4.0.5（设计补充）或 1.4.1（执行案）开始
# 非首次迭代跳过 1.4.0（插件检查）

# 4. 更新 Pipeline Tracker
```

### 情况 B：无下一个迭代，返回总路线

```bash
# 1. 关闭当前迭代里程碑
# 2. 重新打开或创建总路线阶段里程碑
# 3. 更新 Pipeline Tracker 为「总路线阶段」
# 4. 下次 PM 激活时将调用 stage-roadmap 技能
```