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:
2026-06-07 01:54:02 +08:00
parent dec183ff02
commit 8011cb6472
276 changed files with 5630 additions and 1633 deletions
+91 -43
View File
@@ -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>
```