refactor(skills): Agent架构重构——去阶段/去步骤号/审查纯Issue化/工作流拆技能/目录扁平化

- game-reviewer: 删除本地审查记录,仅Issue评论
- quality-gate-review: 删除审查记录/步骤号/阶段标准
- game-dev: 删除阶段感知节,4个工作流详情拆到技能
- game-designer: 删除原型/批量生产阶段,执行案规范拆到技能
- game-pm: 去掉节号和步骤号
- 全局去掉步骤标号(①-⑧/步骤1-5/1.4.X/第一步-第四步)
- 新建技能: code-implementation/deviation-report/design-execution
- 原型目录扁平化: docs/design/prototype/* → docs/design/
- requirements-analysis及子文件去步骤号和阶段引用
- stage-iteration/sketch/roadmap去任务编号
- 更新所有docs/design/路径引用
This commit is contained in:
2026-06-08 16:03:24 +08:00
parent 53a8dc9fed
commit c3c10a9fcb
44 changed files with 435 additions and 508 deletions
+12 -59
View File
@@ -1,11 +1,11 @@
---
name: "quality-gate-review"
description: "审查标准技能 — 4 道质量门标准、阶段对应标准、审查流程、强制操作清单。供 game-reviewer 子代理使用。"
description: "审查标准技能 — 4 道质量门标准、审查流程、强制操作清单。供 game-reviewer 子代理使用。"
---
# 审查标准
> 本技能定义 4 道质量门的审查标准、阶段对应标准和审查后强制操作。
> 本技能定义 4 道质量门的审查标准和审查后强制操作。
> 供 **game-reviewer 子代理**使用——角色完成工作后启动 reviewer 子代理,reviewer 按此标准审查。
> 项目管理工具操作细节参见 `gitea-collab` 技能。
@@ -13,32 +13,27 @@ description: "审查标准技能 — 4 道质量门标准、阶段对应标准
## 审查流程
每次审查必须严格按以下步骤执行:
每次审查必须严格按以下流程执行:
### 1. 读取交付物
### 读取交付物
- 从对应 Issue 的评论中获取产出文件路径
- 阅读交付物内容
### 2. 对照质量门标准检查
### 对照质量门标准检查
- 根据交付物类型选择对应质量门(见下方 4 道质量门)
- 根据当前开发阶段选择对应标准(原型 vs 批量生产,见"阶段对应标准")
### 3. 写审查记录(本地文件)
- 路径:`docs/plans/reviews/<task-ID>-审查记录.md`
- 格式见下方"审查记录格式"
### 4. Issue 评论(强制)
### Issue 评论(强制)
- 使用 `--role reviewer` 操作
- 评论中标注审查者身份:`审查 Agent (ai-reviewer)`
- 无论通过或不通过,都必须在对应 Issue 上发布审查结论评论
- 通过:摘要 + 通过结论
- 不通过:摘要 + 具体问题清单
### 5. 更新标签
### 更新标签
- 通过:设置 `review:pass` 标签,移除 `status:in-review`
- 不通过:设置 `review:fail` 标签,移除 `status:in-review`,改为 `status:blocked`
### 6. 返回结果给启动角色
### 返回结果给启动角色
- 不关闭 Issue(关闭决策权在用户)
- 将审查结果返回给启动你的角色,由该角色向用户汇报
@@ -46,7 +41,7 @@ description: "审查标准技能 — 4 道质量门标准、阶段对应标准
## 四道质量门
### 质量门 1:执行案质量门(③→④)
### 质量门 1:执行案质量门
检查维度:
- **完整性**:是否覆盖所有玩家可感知的行为?触发条件、表现和结束条件是否明确?
@@ -60,7 +55,7 @@ description: "审查标准技能 — 4 道质量门标准、阶段对应标准
> 关卡执行案的质量门**仅做资产存在验证**。空间精度、比例、跨文档一致性等维度的准确性由程序在白模搭建过程中验证——如果程序在 Issue 中汇报了搭建异常,审查者将异常汇总并汇报给用户确认,不自行判断通过或不通过。
### 质量门 2:程序设计质量门(④→⑤)
### 质量门 2:程序设计质量门
检查维度:
- **执行案覆盖度**:是否逐条回应了执行案中每条行为规则?
@@ -70,7 +65,7 @@ description: "审查标准技能 — 4 道质量门标准、阶段对应标准
- **技术风险**:是否识别?
- **工作量与拆分建议**:是否给出工作量估算?拆分方式是否合理,每个子任务可独立验证?拆分后的任务集合是否完整覆盖实现方案?
### 质量门 3:美术资产验收门(⑤→⑥)
### 质量门 3:美术资产验收门
检查维度:
- **需求覆盖度**:逐项对照美术资源需求清单
@@ -78,7 +73,7 @@ description: "审查标准技能 — 4 道质量门标准、阶段对应标准
- **资产规格**:尺寸和格式是否符合需求?
- **缺失项处理**:未到位资产是否有明确处理方案?
### 质量门 4:程序实现验收门(⑥→⑦)
### 质量门 4:程序实现验收门
检查维度:
- **设计一致性**:实现是否与程序设计方案逐条一致?
@@ -90,17 +85,6 @@ description: "审查标准技能 — 4 道质量门标准、阶段对应标准
---
## 阶段对应标准
| 维度 | 原型阶段 | 批量生产阶段 |
|------|---------|------------|
| 完整性 | 核心行为必须完整,非核心可略过 | 全部必须完整 |
| 边界情况 | 影响核心玩法的必须处理 | 全部必须处理 |
| 美术资产 | 允许占位资源 | 正式资产,必须符合规格 |
| 代码质量 | 允许硬编码,快速实现 | 不允许硬编码,数据驱动,发布标准 |
---
## 判定规则
- **通过** → 发布通过评论 + 设置 `review:pass` 标签 + 返回结果(不关闭 Issue)
@@ -109,41 +93,10 @@ description: "审查标准技能 — 4 道质量门标准、阶段对应标准
---
## 审查记录格式
文件路径:`docs/plans/reviews/<task-ID>-审查记录.md`
```markdown
# [任务 ID] 审查报告
**审查日期**:[日期]
**审查对象**:[任务名] — [产出文档路径]
**宏观阶段**:[原型 / 批量生产]
**质量门类型**:[执行案 / 程序设计 / 美术资产 / 程序实现]
**审查者**:审查 Agent (ai-reviewer)
## 检查结果
| 检查项 | 结果 | 说明 |
|--------|------|------|
| [检查项] | ✅/❌ | [详情] |
## 判定
**通过 / 不通过** — [一句话总结]
## 问题清单(不通过时)
1. [具体问题,附文档位置引用]
```
---
## 审查后强制操作清单
审查完成后,**必须**逐项确认以下操作:
- [ ] 在 `docs/plans/reviews/<task-ID>-审查记录.md` 写了审查记录
- [ ] 使用 `--role reviewer` 在对应 Issue 上发布了审查结论评论(标注审查者身份)
- [ ] 更新了 Issue 的标签(通过→`review:pass`,不通过→`review:fail` + `status:blocked`)
- [ ] 将审查结果返回给了启动你的角色