docs(review): P-008交互系统程序设计质量门审查通过+美术调研+工作流完善
- P-008 交互系统技术设计审查通过,审查记录 docs/plans/reviews/P-008-review.md - D-001 关卡执行案审查通过,审查记录 docs/plans/reviews/D-001-review.md - 新增 AI 美术调研参考图(我的暑假/放学后少年/真实场景/美术风格) - 新增关卡执行案、白模搭建指南和搭建报告 - 完善工作流技能:质量门审查、Agent记忆、需求分析 - 更新交互系统和角色控制系统技术设计文档 - 清理过时参考文档
This commit is contained in:
@@ -1,6 +1,6 @@
|
||||
---
|
||||
name: "gitea-collab"
|
||||
description: "Gitea 协作工具 — CLI 命令速查、认证机制、标签体系、Issue/Milestone/Pipeline 操作规范、角色汇报模板"
|
||||
description: "Gitea 协作工具 — CLI 命令速查、认证机制、Assignee 映射、标签体系、Issue/Milestone/Pipeline 操作规范、角色汇报模板"
|
||||
---
|
||||
|
||||
# Gitea 协作工具
|
||||
@@ -36,9 +36,22 @@ description: "Gitea 协作工具 — CLI 命令速查、认证机制、标签体
|
||||
|
||||
---
|
||||
|
||||
## 3. 标签体系
|
||||
## 3. Assignee 映射
|
||||
|
||||
23 个标准标签,通过 `node scripts/gitea.js label init` 初始化。
|
||||
创建任务时通过 `--assignees` 指派给对应角色的 Gitea 用户。
|
||||
|
||||
| 角色 | `--assignees` 值 | 任务 ID 前缀 |
|
||||
|------|-----------------|-------------|
|
||||
| 策划 | `ai-designer` | `D-XXX` |
|
||||
| 程序 | `ai-programmer` | `P-XXX` |
|
||||
| 美术 | `ai-artist` | `A-XXX` |
|
||||
| PM | `ai-pm` | (管理任务) |
|
||||
|
||||
---
|
||||
|
||||
## 4. 标签体系
|
||||
|
||||
14 个标准标签,通过 `node scripts/gitea.js label init` 初始化。
|
||||
|
||||
### status(任务状态)
|
||||
| 标签 | 含义 |
|
||||
@@ -50,23 +63,6 @@ description: "Gitea 协作工具 — CLI 命令速查、认证机制、标签体
|
||||
| `status:in-review` | 审查中 |
|
||||
| `status:done` | 已完成 |
|
||||
|
||||
### pipeline(流水线步骤)
|
||||
| 标签 | 对应步骤 |
|
||||
|------|---------|
|
||||
| `pipeline:3-execution` | ③ 执行案 |
|
||||
| `pipeline:4-tech-design` | ④ 程序设计 |
|
||||
| `pipeline:5-art` | ⑤ 美术产出 |
|
||||
| `pipeline:6-impl` | ⑥ 程序实现 |
|
||||
| `pipeline:7-retro` | ⑦ 版本复盘 |
|
||||
|
||||
### role(角色归属)
|
||||
| 标签 | 角色 |
|
||||
|------|------|
|
||||
| `role:design` | 策划 |
|
||||
| `role:dev` | 程序 |
|
||||
| `role:art` | 美术 |
|
||||
| `role:pm` | PM |
|
||||
|
||||
### gate(质量门判定)
|
||||
| 标签 | 含义 |
|
||||
|------|------|
|
||||
@@ -79,21 +75,23 @@ description: "Gitea 协作工具 — CLI 命令速查、认证机制、标签体
|
||||
| `gate:impl-pass` | 程序实现验收门通过 |
|
||||
| `gate:impl-fail` | 程序实现验收门未通过 |
|
||||
|
||||
> **注**:旧 Issue 上可能仍有 `pipeline:*` 和 `role:*` 标签,这些已不再使用,保留不管即可。
|
||||
|
||||
---
|
||||
|
||||
## 4. 命令速查
|
||||
## 5. 命令速查
|
||||
|
||||
### issue
|
||||
|
||||
```bash
|
||||
# 列出 Issue
|
||||
node scripts/gitea.js --role <role> issue list --milestone <标题> [--state open|closed|all] [--labels <id,...>] [--json]
|
||||
# 列出 Issue(支持按 assignee 过滤)
|
||||
node scripts/gitea.js --role <role> issue list --milestone <标题> [--state open|closed|all] [--labels <id,...>] [--assigned <用户名>] [--json]
|
||||
|
||||
# 查看 Issue 详情
|
||||
node scripts/gitea.js --role <role> issue get <number> [--json]
|
||||
|
||||
# 创建 Issue
|
||||
node scripts/gitea.js --role <role> issue create --title "..." --body "..." --milestone <id>
|
||||
# 创建 Issue(必须指定 assignees)
|
||||
node scripts/gitea.js --role <role> issue create --title "..." --body "..." --milestone <id> --assignees <用户名,...>
|
||||
|
||||
# 更新 Issue
|
||||
node scripts/gitea.js --role <role> issue update <number> --title "..." --body "..."
|
||||
@@ -169,24 +167,23 @@ node scripts/gitea.js test
|
||||
|
||||
---
|
||||
|
||||
## 5. 数据映射
|
||||
## 6. 数据映射
|
||||
|
||||
| 概念 | Gitea 对应 | 说明 |
|
||||
|------|-----------|------|
|
||||
| 任务 (P-002) | Issue | 标题含任务 ID 前缀 |
|
||||
| 版本 (v0.1) | Milestone | 版本号即里程碑标题 |
|
||||
| 任务状态 | Label (`status:*`) | 6 种状态标签 |
|
||||
| 流水线步骤 | Label (`pipeline:*`) | 5 种步骤标签 |
|
||||
| 角色归属 | Label (`role:*`) | 4 种角色标签 |
|
||||
| 质量门结果 | Label (`gate:*`) | 8 种判定标签 |
|
||||
| 角色归属 | Assignee | 通过 `--assignees` 指派 |
|
||||
| 流水线步骤 | Pipeline Tracker | Meta Issue 记录全局流水线状态 |
|
||||
| 角色汇报 | Issue 评论 | 各角色在对应 Issue 下评论 |
|
||||
| 流水线总览 | Pipeline Tracker Meta Issue | 单个 Issue 记录全局流水线状态 |
|
||||
| 审查记录 | Issue 评论(摘要+链接)+ 本地 `docs/plans/reviews/` | 本地保留详细结构化文档 |
|
||||
| 任务归档 | close Issue | 不需要本地 archive 文件 |
|
||||
|
||||
---
|
||||
|
||||
## 6. 任务 ID 规范
|
||||
## 7. 任务 ID 规范
|
||||
|
||||
格式:`[角色前缀]-[三位数字]`
|
||||
|
||||
@@ -200,7 +197,7 @@ node scripts/gitea.js test
|
||||
|
||||
---
|
||||
|
||||
## 7. Pipeline Tracker
|
||||
## 8. Pipeline Tracker
|
||||
|
||||
Pipeline Tracker 是一个 **Meta Issue**,用于记录当前版本的全局流水线状态。
|
||||
|
||||
@@ -210,7 +207,7 @@ Pipeline Tracker 是一个 **Meta Issue**,用于记录当前版本的全局流
|
||||
|
||||
---
|
||||
|
||||
## 8. 角色汇报模板
|
||||
## 9. 角色汇报模板
|
||||
|
||||
各角色完成工作后,在对应 Issue 下评论汇报。
|
||||
|
||||
@@ -246,19 +243,51 @@ node scripts/gitea.js --role dev issue comment <number> --body "## 程序汇报
|
||||
- ..."
|
||||
```
|
||||
|
||||
### 审查修改后汇报(审查退回修改后使用)
|
||||
|
||||
```bash
|
||||
node scripts/gitea.js --role <role> issue comment <number> --body "## 修改汇报 — YYYY-MM-DD
|
||||
|
||||
**任务ID**: <ID>
|
||||
**修改原因**: 质量门审查退回
|
||||
|
||||
### 修改内容
|
||||
- [对应审查意见第X条]:[具体修改内容]
|
||||
|
||||
### 修改后产出
|
||||
- path/to/output"
|
||||
```
|
||||
|
||||
### PM 审查后
|
||||
|
||||
```bash
|
||||
# 发布审查摘要评论
|
||||
node scripts/gitea.js --role pm issue comment <number> --body "审查结论..."
|
||||
node scripts/gitea.js --role pm issue comment <number> --body "## 质量门审查 [通过✅/未通过❌]
|
||||
|
||||
**质量门**:[类型]
|
||||
**审查日期**:YYYY-MM-DD
|
||||
**审查记录**:docs/plans/reviews/<task-ID>-review.md
|
||||
|
||||
### 结论
|
||||
[一句话总结]
|
||||
|
||||
### 问题清单(不通过时)
|
||||
1. ..."
|
||||
|
||||
# 更新标签反映质量门结果
|
||||
node scripts/gitea.js --role pm issue labels <number> --set <gate-pass|gate-fail>,<status-*>,...
|
||||
|
||||
# 审查通过时关闭 Issue
|
||||
node scripts/gitea.js --role pm issue close <number> --body "## 任务完成 ✔
|
||||
|
||||
**完成日期**:YYYY-MM-DD
|
||||
**产出**:path/to/output
|
||||
**审查记录**:docs/plans/reviews/<task-ID>-review.md"
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 9. PM 会话启动命令序列
|
||||
## 10. PM 会话启动命令序列
|
||||
|
||||
PM 在每次会话启动时按序执行:
|
||||
|
||||
@@ -278,19 +307,20 @@ node scripts/gitea.js --role pm issue comments <number>
|
||||
|
||||
---
|
||||
|
||||
## 10. PM 任务管理命令序列
|
||||
## 11. PM 任务管理命令序列
|
||||
|
||||
### 创建任务
|
||||
|
||||
```bash
|
||||
# 创建 Issue
|
||||
# 创建 Issue(必须指定 assignees)
|
||||
node scripts/gitea.js --role pm issue create \
|
||||
--title "P-XXX 任务标题" \
|
||||
--body "## 任务信息\n- **任务ID**: P-XXX\n- **所属版本**: vX.X\n..." \
|
||||
--milestone <id>
|
||||
--title "D-001 交互系统执行案" \
|
||||
--body "## 任务信息\n- **任务ID**: D-001\n- **所属版本**: v0.1\n- **角色**: 策划\n- **预期产出**: docs/design/prototype/interaction-system-execution.md\n..." \
|
||||
--milestone <id> \
|
||||
--assignees ai-designer
|
||||
|
||||
# 设置标签
|
||||
node scripts/gitea.js --role pm issue labels <number> --set <label_ids>
|
||||
node scripts/gitea.js --role pm issue labels <number> --set <status-label-id>,<gate-label-id>
|
||||
|
||||
# 设置依赖
|
||||
node scripts/gitea.js --role pm issue block <blocker_number> <new_number>
|
||||
@@ -310,19 +340,37 @@ node scripts/gitea.js --role pm pipeline update <tracker_number> --step <1-7> --
|
||||
|
||||
---
|
||||
|
||||
## 11. 其他角色读取命令
|
||||
## 12. 其他角色读取命令
|
||||
|
||||
### 程序查看任务
|
||||
|
||||
```bash
|
||||
# 查看分配给自己的任务
|
||||
node scripts/gitea.js --role dev issue list --assigned ai-programmer --milestone <当前版本>
|
||||
|
||||
# 查看流水线状态
|
||||
node scripts/gitea.js --role dev pipeline status
|
||||
node scripts/gitea.js --role dev issue list --milestone <当前版本>
|
||||
|
||||
# 查看 Issue 详情
|
||||
node scripts/gitea.js --role dev issue get <number>
|
||||
```
|
||||
|
||||
### 策划查看任务
|
||||
|
||||
```bash
|
||||
node scripts/gitea.js --role designer issue list --labels <role-label-id>
|
||||
# 查看分配给自己的任务
|
||||
node scripts/gitea.js --role designer issue list --assigned ai-designer --milestone <当前版本>
|
||||
|
||||
# 查看 Issue 详情
|
||||
node scripts/gitea.js --role designer issue get <number>
|
||||
```
|
||||
|
||||
### 美术查看任务
|
||||
|
||||
```bash
|
||||
# 查看分配给自己的任务
|
||||
node scripts/gitea.js --role artist issue list --assigned ai-artist --milestone <当前版本>
|
||||
|
||||
# 查看 Issue 详情
|
||||
node scripts/gitea.js --role artist issue get <number>
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user