docs(workflow): 工作流重构——3阶段状态机+独立审查代理+阶段技能体系
- 简化 game-pm:删除质量门审查和风险检测,改为进度检查+任务分配调度器 - 重写 game-reviewer:改为子代理模式,角色完成工作后自行启动,使用 ai-reviewer 账号 - 新增 project-initializer 技能:项目冷启动初始化 - 新增 stage-sketch/roadmap/iteration 技能:3 阶段任务序列管理 - 修改 game-designer/game-dev:添加审查交接流程 - 更新 gitea-collab/quality-gate-review/development-workflow - gitea.js:添加 reviewer 角色 + 5 个新标签(review:pass/fail, stage:sketch/roadmap/iteration)
This commit is contained in:
@@ -0,0 +1,308 @@
|
||||
---
|
||||
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 技能
|
||||
```
|
||||
Reference in New Issue
Block a user