ChildHood/.claude/skills/stage-iteration.md

name, description

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

迭代阶段

当 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 插件资产检查与准备（仅首次迭代）

--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 设计案迭代补充（可选）

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

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

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

1.4.1 策划执行案

--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 程序需求分析

--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 关卡搭建（有场景时）

--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 系统开发

--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 优化意见

--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 资产接入整合

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

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

1.4.4 Bug 修复

--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：有下一个迭代

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

# 2. 创建下一个迭代里程碑
node .claude/skills/gitea-pm/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：无下一个迭代，返回总路线

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