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:
2026-06-07 23:49:58 +08:00
parent e31151a8b6
commit 6ba07318be
12 changed files with 1202 additions and 915 deletions
+183
View File
@@ -0,0 +1,183 @@
---
name: "stage-roadmap"
description: "总路线阶段技能 — 全面设计文档产出与版本路径规划。管理总路线阶段任务创建和阶段转换。"
---
# 总路线阶段
> 当 PM 检测到 Pipeline Tracker 标记为「总路线阶段」时调用本技能。
> 目标:产出完整的游戏设计文档体系,规划版本迭代路径。
---
## 阶段概述
| 项目 | 说明 |
|------|------|
| 目标 | 建立"这个游戏长什么样"的完整蓝图 |
| 产出 | 9 份设计文档 + 版本路径图 |
| 参与角色 | 策划(全部文档) |
| 完成标志 | 所有任务关闭 + 里程碑下无 open issues |
---
## 任务创建
### 检查已有任务
先通过 `issue list --milestone "总路线阶段" --state open` 检查现有任务,避免重复创建。
### 需要创建的任务(共 9 个)
**占位规则**:除系统设计文档(⑤)和关卡设计文档(⑥)必须完整内容外,其他文档允许暂时留空文件占位(包含标题、章节结构和「待填充」说明),后续迭代中逐步完善。
---
**任务 1:设计总索引文档** (D-XXX)
```bash
--title "D-XXX 设计总索引文档"
--body "## 任务信息
- **任务ID**: D-XXX
- **所属阶段**: 总路线阶段
- **角色**: 策划
- **优先级**: 最高(其他设计文档的索引基础)
## 预期产出
设计总索引 \`docs/design/设计总索引.md\`,包含:
- 所有设计文档的目录和链接
- 文档间的依赖关系图
- 当前完成状态追踪
## 占位规则
此文档必须完整产出(不允许占位)。"
--labels "stage:roadmap,role:design,status:ready"
--assignees "ai-designer"
```
**任务 2:世界观设计文档** (D-XXX) — 可占位
```
--title "D-XXX 世界观设计"
--body "...产出 docs/design/世界观设计.md
占位规则:允许占位(标题+章节结构+待填充说明)"
--labels "stage:roadmap,role:design,status:ready"
```
**任务 3:剧情设计文档** (D-XXX) — 可占位
```
--title "D-XXX 剧情设计"
--body "...产出 docs/design/剧情设计.md
占位规则:允许占位"
--labels "stage:roadmap,role:design,status:ready"
```
**任务 4:角色设计文档** (D-XXX) — 可占位
```
--title "D-XXX 角色设计"
--body "...产出 docs/design/角色设计.md
占位规则:允许占位"
--labels "stage:roadmap,role:design,status:ready"
```
**任务 5:系统设计文档** (D-XXX) — ⚠️ 必须完整
```
--title "D-XXX 系统设计"
--body "...产出 docs/design/系统设计.md(含各子系统的设计)
⚠️ 不允许占位,必须产出完整内容。"
--labels "stage:roadmap,role:design,status:ready"
```
**任务 6:关卡设计文档** (D-XXX) — ⚠️ 必须完整
```
--title "D-XXX 关卡设计"
--body "...产出 docs/design/关卡设计.md
⚠️ 不允许占位,必须产出完整内容。"
--labels "stage:roadmap,role:design,status:ready"
```
**任务 7:UI 设计文档** (D-XXX) — 可占位
```
--title "D-XXX UI设计"
--body "...产出 docs/design/UI设计.md
占位规则:允许占位"
--labels "stage:roadmap,role:design,status:ready"
```
**任务 8:音频设计文档** (D-XXX) — 可占位
```
--title "D-XXX 音频设计"
--body "...产出 docs/design/音频设计.md
占位规则:允许占位"
--labels "stage:roadmap,role:design,status:ready"
```
**任务 9:版本路径图** (D-XXX)
```
--title "D-XXX 版本路径图"
--body "...产出 docs/plans/版本路径图.md
包含:版本列表、每个版本的核心目标、范围概述、内容完成度、
涉及的系统清单、版本间递进逻辑、验收标准
依赖:任务 2-8(至少了解各文档的概要信息后才能规划版本路径)"
--labels "stage:roadmap,role:design,status:backlog"
```
### 依赖关系
```
任务 1(总索引)→ 先完成
任务 2-8(各设计文档)→ 1 完成后可并行创建,建议按序执行
任务 9(版本路径图)→ 依赖 2-8,最后完成
```
设置依赖:`issue block <任务9> <任务2>` ~ `issue block <任务9> <任务8>`
---
## 进度检查
每次 PM 激活时执行:
1. **读取任务状态**:`issue list --milestone "总路线阶段" --state open`
2. **判断当前焦点**:
- 任务 1 未完成 → 建议:先完成设计总索引
- 任务 2-8 有未完成的 → 建议按序完成各设计文档
- 任务 2-8 全完成,任务 9 未开始 → 更新任务 9 为 `status:ready`
- 任务 9 进行中 → 等待
3. **检查完成条件**:
- 总路线阶段里程碑下 open issues = 0 → 触发阶段转换
---
## 阶段转换
**前置条件**:总路线阶段里程碑下无 open issues。
**转换操作**(每步需用户确认):
```bash
# 1. 关闭总路线阶段里程碑
node scripts/gitea.js --role pm milestone update <总路线里程碑ID> --state closed
# 2. 创建第一个迭代版本里程碑
node scripts/gitea.js --role pm milestone create \
--title "迭代-v0.1" \
--description "第一个迭代版本"
# 3. 创建第一个迭代任务:插件资产检查与准备
# (详细参数见 stage-iteration 技能)
# 4. 更新 Pipeline Tracker
# 更新正文:当前阶段改为「迭代阶段」
# 阶段历史表添加总路线阶段完成日期
# 5. 告知用户已进入迭代阶段
# 下次 PM 激活时将调用 stage-iteration 技能
```