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,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 技能
|
||||
```
|
||||
Reference in New Issue
Block a user