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:
@@ -33,6 +33,7 @@ description: "Gitea 协作工具 — CLI 命令速查、认证机制、Assignee
|
||||
| 程序 | `dev` | game-dev |
|
||||
| 美术 | `artist` | (暂无独立 Agent) |
|
||||
| PM | `pm` | game-pm |
|
||||
| 审查 | `reviewer` | game-reviewer |
|
||||
|
||||
---
|
||||
|
||||
@@ -46,12 +47,13 @@ description: "Gitea 协作工具 — CLI 命令速查、认证机制、Assignee
|
||||
| 程序 | `ai-programmer` | `P-XXX` |
|
||||
| 美术 | `ai-artist` | `A-XXX` |
|
||||
| PM | `ai-pm` | (管理任务) |
|
||||
| 审查 | `ai-reviewer` | (审查操作,不拥有任务) |
|
||||
|
||||
---
|
||||
|
||||
## 4. 标签体系
|
||||
|
||||
14 个标准标签,通过 `node scripts/gitea.js label init` 初始化。
|
||||
19 个标准标签,通过 `node scripts/gitea.js label init` 初始化。
|
||||
|
||||
### status(任务状态)
|
||||
| 标签 | 含义 |
|
||||
@@ -60,20 +62,31 @@ description: "Gitea 协作工具 — CLI 命令速查、认证机制、Assignee
|
||||
| `status:ready` | 已就绪,可开始 |
|
||||
| `status:in-progress` | 进行中 |
|
||||
| `status:blocked` | 被阻塞 |
|
||||
| `status:in-review` | 审查中 |
|
||||
| `status:in-review` | 待审查(角色完成工作后设置) |
|
||||
| `status:done` | 已完成 |
|
||||
|
||||
### gate(质量门判定)
|
||||
### gate(质量门判定 — 旧标签,保留用于历史 Issue)
|
||||
| 标签 | 含义 |
|
||||
|------|------|
|
||||
| `gate:execution-pass` | 执行案质量门通过 |
|
||||
| `gate:execution-fail` | 执行案质量门未通过 |
|
||||
| `gate:tech-pass` | 程序设计质量门通过 |
|
||||
| `gate:tech-fail` | 程序设计质量门未通过 |
|
||||
| `gate:art-pass` | 美术资产验收门通过 |
|
||||
| `gate:art-fail` | 美术资产验收门未通过 |
|
||||
| `gate:impl-pass` | 程序实现验收门通过 |
|
||||
| `gate:impl-fail` | 程序实现验收门未通过 |
|
||||
| `gate:execution-pass/fail` | 执行案质量门 |
|
||||
| `gate:tech-pass/fail` | 程序设计质量门 |
|
||||
| `gate:art-pass/fail` | 美术资产验收门 |
|
||||
| `gate:impl-pass/fail` | 程序实现验收门 |
|
||||
|
||||
> 新工作流使用 `review:*` 标签替代 `gate:*`。旧 Issue 上的 gate 标签保留不动。
|
||||
|
||||
### review(审查结果 — 新标签)
|
||||
| 标签 | 含义 |
|
||||
|------|------|
|
||||
| `review:pass` | 审查已通过 ✅ |
|
||||
| `review:fail` | 审查未通过 ❌ |
|
||||
|
||||
### stage(开发阶段 — 新标签)
|
||||
| 标签 | 含义 |
|
||||
|------|------|
|
||||
| `stage:sketch` | 草图阶段任务 |
|
||||
| `stage:roadmap` | 总路线阶段任务 |
|
||||
| `stage:iteration` | 迭代阶段任务 |
|
||||
|
||||
> **注**:`pipeline:*` 和 `role:*` 标签已废弃并从 Gitea 上删除。如旧 Issue 上仍残留这些标签,忽略即可。
|
||||
|
||||
@@ -172,14 +185,16 @@ node scripts/gitea.js test
|
||||
| 概念 | Gitea 对应 | 说明 |
|
||||
|------|-----------|------|
|
||||
| 任务 (P-002) | Issue | 标题含任务 ID 前缀 |
|
||||
| 版本 (v0.1) | Milestone | 版本号即里程碑标题 |
|
||||
| 阶段/版本 | Milestone | 阶段名或版本号作为里程碑标题 |
|
||||
| 任务状态 | Label (`status:*`) | 6 种状态标签 |
|
||||
| 质量门结果 | Label (`gate:*`) | 8 种判定标签 |
|
||||
| 审查结果 | Label (`review:*`) | 通过/未通过 |
|
||||
| 开发阶段 | Label (`stage:*`) | 草图/总路线/迭代 |
|
||||
| 质量门结果 | Label (`gate:*`) | 旧标签,保留用于历史 Issue |
|
||||
| 角色归属 | Assignee | 通过 `--assignees` 指派 |
|
||||
| 流水线步骤 | Pipeline Tracker | Meta Issue 记录全局流水线状态 |
|
||||
| 当前进度 | Pipeline Tracker | Meta Issue 记录当前阶段和进度 |
|
||||
| 角色汇报 | Issue 评论 | 各角色在对应 Issue 下评论 |
|
||||
| 审查记录 | Issue 评论(摘要+链接)+ 本地 `docs/plans/reviews/` | 本地文件名格式 `<任务ID>-审查记录.md` |
|
||||
| 任务归档 | close Issue | 不需要本地 archive 文件 |
|
||||
| 任务归档 | close Issue | 用户确认后由 PM 关闭 |
|
||||
|
||||
---
|
||||
|
||||
@@ -199,11 +214,34 @@ node scripts/gitea.js test
|
||||
|
||||
## 8. Pipeline Tracker
|
||||
|
||||
Pipeline Tracker 是一个 **Meta Issue**,用于记录当前版本的全局流水线状态。
|
||||
Pipeline Tracker 是一个 **Meta Issue**,用于记录项目当前阶段和进度。
|
||||
|
||||
- 初始化:`pipeline init`(阶段开始时执行一次)
|
||||
### Tracker 正文格式
|
||||
|
||||
```markdown
|
||||
# 流水线进度追踪
|
||||
|
||||
## 当前阶段
|
||||
草图阶段 / 总路线阶段 / 迭代阶段
|
||||
|
||||
## 当前里程碑
|
||||
- 名称: <milestone title>
|
||||
- 状态: open/closed
|
||||
- Open Issues: X
|
||||
- Closed Issues: Y
|
||||
|
||||
## 阶段历史
|
||||
| 阶段 | 里程碑 | 进入日期 | 完成日期 |
|
||||
|------|--------|----------|----------|
|
||||
| 草图阶段 | 草图阶段 | YYYY-MM-DD | — |
|
||||
```
|
||||
|
||||
### 相关命令
|
||||
|
||||
- 初始化:`pipeline init`
|
||||
- 查看状态:`pipeline status`
|
||||
- 更新步骤:`pipeline update <number> --step <1-7> --status "描述"`
|
||||
- 阶段转换时直接编辑 Issue 正文更新「当前阶段」和「阶段历史」
|
||||
|
||||
---
|
||||
|
||||
@@ -258,26 +296,10 @@ node scripts/gitea.js --role <role> issue comment <number> --body "## 修改汇
|
||||
- path/to/output"
|
||||
```
|
||||
|
||||
### PM 审查后
|
||||
### PM 确认关闭任务(审查通过后)
|
||||
|
||||
```bash
|
||||
# 发布审查摘要评论
|
||||
node scripts/gitea.js --role pm issue comment <number> --body "## 质量门审查 [通过✅/未通过❌]
|
||||
|
||||
**质量门**:[类型]
|
||||
**审查日期**:YYYY-MM-DD
|
||||
**审查记录**:docs/plans/reviews/<task-ID>-审查记录.md
|
||||
|
||||
### 结论
|
||||
[一句话总结]
|
||||
|
||||
### 问题清单(不通过时)
|
||||
1. ..."
|
||||
|
||||
# 更新标签反映质量门结果
|
||||
node scripts/gitea.js --role pm issue labels <number> --set <gate-pass|gate-fail>,<status-*>,...
|
||||
|
||||
# 审查通过时关闭 Issue
|
||||
# 用户确认后关闭 Issue
|
||||
node scripts/gitea.js --role pm issue close <number> --body "## 任务完成 ✔
|
||||
|
||||
**完成日期**:YYYY-MM-DD
|
||||
@@ -292,17 +314,22 @@ node scripts/gitea.js --role pm issue close <number> --body "## 任务完成 ✔
|
||||
PM 在每次会话启动时按序执行:
|
||||
|
||||
```bash
|
||||
# 1. 读取当前里程碑
|
||||
node scripts/gitea.js --role pm milestone list --state open
|
||||
|
||||
# 2. 读取活跃任务
|
||||
node scripts/gitea.js --role pm issue list --milestone <当前版本>
|
||||
|
||||
# 3. 读取流水线状态
|
||||
# 1. 读取 Pipeline Tracker(确定当前阶段)
|
||||
node scripts/gitea.js --role pm pipeline status
|
||||
|
||||
# 4. 读取近期评论(按需)
|
||||
node scripts/gitea.js --role pm issue comments <number>
|
||||
# 2. 读取当前里程碑
|
||||
node scripts/gitea.js --role pm milestone list --state open
|
||||
|
||||
# 3. 读取活跃任务
|
||||
node scripts/gitea.js --role pm issue list --state open
|
||||
|
||||
# 4. 根据阶段调用对应技能:
|
||||
# 无进度 → project-initializer
|
||||
# 草图阶段 → stage-sketch
|
||||
# 总路线阶段 → stage-roadmap
|
||||
# 迭代阶段 → stage-iteration
|
||||
|
||||
# 5. 检查 review:pass 标签的 Issue → 请示用户是否关闭
|
||||
```
|
||||
|
||||
---
|
||||
@@ -312,30 +339,25 @@ node scripts/gitea.js --role pm issue comments <number>
|
||||
### 创建任务
|
||||
|
||||
```bash
|
||||
# 创建 Issue(必须指定 assignees)
|
||||
# 创建 Issue(必须指定 assignees 和 stage 标签)
|
||||
node scripts/gitea.js --role pm issue create \
|
||||
--title "D-001 交互系统执行案" \
|
||||
--body "## 任务信息\n- **任务ID**: D-001\n- **所属版本**: v0.1\n- **角色**: 策划\n- **预期产出**: docs/design/prototype/交互系统-执行案.md\n..." \
|
||||
--title "D-001 概念设计" \
|
||||
--body "## 任务信息\n- **任务ID**: D-001\n- **所属阶段**: 草图阶段\n- **角色**: 策划\n- **预期产出**: docs/design/概念草案.md\n..." \
|
||||
--milestone <id> \
|
||||
--assignees ai-designer
|
||||
|
||||
# 设置标签
|
||||
node scripts/gitea.js --role pm issue labels <number> --set <status-label-id>,<gate-label-id>
|
||||
# 设置标签(status + stage + role)
|
||||
node scripts/gitea.js --role pm issue labels <number> --set <status-label-id>,<stage-label-id>,<role-label-id>
|
||||
|
||||
# 设置依赖
|
||||
node scripts/gitea.js --role pm issue block <blocker_number> <new_number>
|
||||
```
|
||||
|
||||
### 关闭任务
|
||||
### 关闭任务(用户确认后)
|
||||
|
||||
```bash
|
||||
node scripts/gitea.js --role pm issue close <number> --body "## 任务完成 ✔\n**完成日期**: YYYY-MM-DD\n**产出**: path/to/output"
|
||||
```
|
||||
|
||||
### 更新流水线
|
||||
|
||||
```bash
|
||||
node scripts/gitea.js --role pm pipeline update <tracker_number> --step <1-7> --status "状态描述"
|
||||
# 审查通过 + 用户确认关闭后
|
||||
node scripts/gitea.js --role pm issue close <number> --body "## 任务完成 ✔\n**完成日期**: YYYY-MM-DD\n**产出**: path/to/output\n**审查记录**: docs/plans/reviews/<task-ID>-审查记录.md"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
Reference in New Issue
Block a user