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
+22 -26
View File
@@ -1,19 +1,19 @@
---
name: "quality-gate-review"
description: "质量门审查技能 — 4 道质量门标准、阶段对应标准、审查流程、强制操作清单"
description: "审查标准技能 — 4 道质量门标准、阶段对应标准、审查流程、强制操作清单。供 game-reviewer 子代理使用。"
---
# 质量门审查
# 审查标准
> 本技能定义 4 道质量门的审查标准、阶段对应标准和审查后强制操作。
> 供 game-reviewer agent、game-pm agent 及各工种自审使用。
> 供 **game-reviewer 子代理**使用——角色完成工作后启动 reviewer 子代理,reviewer 按此标准审查。
> 项目管理工具操作细节参见 `.claude/skills/gitea-collab.md`。
---
## 审查流程
每次质量门审查必须严格按以下步骤执行:
每次审查必须严格按以下步骤执行:
### 1. 读取交付物
- 从对应 Issue 的评论中获取产出文件路径
@@ -28,17 +28,19 @@ description: "质量门审查技能 — 4 道质量门标准、阶段对应标
- 格式见下方"审查记录格式"
### 4. Issue 评论(强制)
- **无论通过或不通过,都必须在对应 Issue 上发布审查结论评论**
- 使用 `--role reviewer` 操作
- 评论中标注审查者身份:`审查 Agent (ai-reviewer)`
- 无论通过或不通过,都必须在对应 Issue 上发布审查结论评论
- 通过:摘要 + 通过结论
- 不通过:摘要 + 具体问题清单
### 5. 更新标签
- 通过:设置 `gate:*-pass` 标签,移除 `gate:*-fail`(如有)
- 不通过:设置 `gate:*-fail` 标签,移除 `gate:*-pass`(如有)
- 通过:设置 `review:pass` 标签,移除 `status:in-review`
- 不通过:设置 `review:fail` 标签,移除 `status:in-review`,改为 `status:blocked`
### 6. 通过时关闭 Issue(强制)
- **审查通过时必须关闭 Issue**,附完成说明
- 不通过时 Issue 保持打开,等待修改
### 6. 返回结果给启动角色
- 不关闭 Issue(关闭决策权在用户)
- 将审查结果返回给启动你的角色,由该角色向用户汇报
---
@@ -58,8 +60,6 @@ description: "质量门审查技能 — 4 道质量门标准、阶段对应标
> 关卡执行案的质量门**仅做资产存在验证**。空间精度、比例、跨文档一致性等维度的准确性由程序在白模搭建过程中验证——如果程序在 Issue 中汇报了搭建异常,审查者将异常汇总并汇报给用户确认,不自行判断通过或不通过。
标签:`gate:execution-pass` / `gate:execution-fail`
### 质量门 2:程序设计质量门(④→⑤)
检查维度:
@@ -70,8 +70,6 @@ description: "质量门审查技能 — 4 道质量门标准、阶段对应标
- **技术风险**:是否识别?
- **工作量与拆分建议**:是否给出工作量估算?拆分方式是否合理,每个子任务可独立验证?拆分后的任务集合是否完整覆盖实现方案?
标签:`gate:tech-pass` / `gate:tech-fail`
### 质量门 3:美术资产验收门(⑤→⑥)
检查维度:
@@ -80,8 +78,6 @@ description: "质量门审查技能 — 4 道质量门标准、阶段对应标
- **资产规格**:尺寸和格式是否符合需求?
- **缺失项处理**:未到位资产是否有明确处理方案?
标签:`gate:art-pass` / `gate:art-fail`
### 质量门 4:程序实现验收门(⑥→⑦)
检查维度:
@@ -89,10 +85,8 @@ description: "质量门审查技能 — 4 道质量门标准、阶段对应标
- **执行案覆盖度**:最终实现是否覆盖所有行为规则?
- **资产使用确认**:美术资产是否正确集成?
- **偏差处理**:
- **轻微偏差**(不影响核心行为)→ 记录,在⑦复盘时同步文档
- **重大偏差**(影响核心行为)→ 建议回退到③或开启新版本,用户决定
标签:`gate:impl-pass` / `gate:impl-fail`
- **轻微偏差**(不影响核心行为)→ 记录,在复盘时同步文档
- **重大偏差**(影响核心行为)→ 建议回退或开启新版本,用户决定
---
@@ -109,8 +103,8 @@ description: "质量门审查技能 — 4 道质量门标准、阶段对应标
## 判定规则
- **通过** → 发布通过评论 + 设置 pass 标签 + **关闭 Issue**
- **不通过** → 发布不通过评论(附问题清单)+ 设置 fail 标签 + Issue 保持打开
- **通过** → 发布通过评论 + 设置 `review:pass` 标签 + 返回结果(不关闭 Issue)
- **不通过** → 发布不通过评论(附问题清单)+ 设置 `review:fail` 标签 + 设置 `status:blocked` + 返回结果
- **争议** → 用户最终裁决;审查者提供明确证据和具体文档位置
---
@@ -126,6 +120,7 @@ description: "质量门审查技能 — 4 道质量门标准、阶段对应标
**审查对象**:[任务名] — [产出文档路径]
**宏观阶段**:[原型 / 批量生产]
**质量门类型**:[执行案 / 程序设计 / 美术资产 / 程序实现]
**审查者**:审查 Agent (ai-reviewer)
## 检查结果
@@ -149,7 +144,8 @@ description: "质量门审查技能 — 4 道质量门标准、阶段对应标
审查完成后,**必须**逐项确认以下操作:
- [ ] 在 `docs/plans/reviews/<task-ID>-审查记录.md` 写了审查记录
- [ ] 在对应 Issue 上发布了审查结论评论(通过/不通过 + 摘要)
- [ ] 更新了 Issue 的 gate:* 标签(通过→pass,不通过→fail)
- [ ] **通过时**:关闭 Issue 并附完成说明
- [ ] **不通过时**:评论中包含具体问题清单,Issue 保持打开
- [ ] 使用 `--role reviewer` 在对应 Issue 上发布了审查结论评论(标注审查者身份)
- [ ] 更新了 Issue 的标签(通过→`review:pass`,不通过→`review:fail` + `status:blocked`)
- [ ] 将审查结果返回给了启动你的角色
- [ ] **不关闭 Issue**(关闭决策权在用户)
- [ ] **不通过时**:评论中包含具体问题清单