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:
@@ -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`)
|
||||
- [ ] 将审查结果返回给了启动你的角色
|
||||
|
||||
Reference in New Issue
Block a user