starmen1265
6ba07318be
- 简化 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）
138 lines
4.0 KiB
Markdown
138 lines
4.0 KiB
Markdown
---
|
||
name: "project-initializer"
|
||
description: "项目初始化技能 — 检查版本管理/项目管理配置、初始化 Gitea 标签/里程碑/任务。仅在项目无进度时由 PM 调用。"
|
||
---
|
||
|
||
# 项目初始化
|
||
|
||
> 本技能处理项目冷启动。在 PM 上下文中运行，完成后 PM 直接感知初始化结果。
|
||
> 仅在无 Pipeline Tracker 或无里程碑时触发。
|
||
|
||
---
|
||
|
||
## 初始化流程
|
||
|
||
### 步骤 1：版本管理确认
|
||
|
||
逐项确认以下内容：
|
||
|
||
1. **SSH 仓库地址**：确认 `git remote -v` 中的仓库地址正确
|
||
2. **角色 Gitea 账号**：确认以下账号存在且可访问
|
||
- `starmen1265`（用户）
|
||
- `ai-pm`
|
||
- `ai-designer`
|
||
- `ai-programmer`
|
||
- `ai-artist`
|
||
- `ai-reviewer`
|
||
3. **SSH key 配置**：运行 `ssh -T git@micecola.top -p 2223` 测试连接
|
||
- 失败 → 引导用户生成并配置 SSH key
|
||
|
||
### 步骤 2：项目管理配置
|
||
|
||
确认以下配置就绪：
|
||
|
||
1. **Token 文件**：`scripts/.gitea-tokens.json` 存在且包含所有角色 token
|
||
- `pm`、`designer`、`dev`、`artist`、`reviewer`
|
||
2. **Token 文件已忽略**：`.gitignore` 中包含 `scripts/.gitea-tokens.json`
|
||
3. **Gitea CLI 可用**：`node scripts/gitea.js --role pm test` 运行通过
|
||
|
||
缺失时引导用户配置。
|
||
|
||
### 步骤 3：现有代码与需求检查
|
||
|
||
**情况 A：有现有代码和需求**
|
||
- 探索 `docs/` 和 `Content/` 目录结构
|
||
- 读取现有设计文档
|
||
- 生成迁移方案：
|
||
- 哪些文档可直接映射到新阶段
|
||
- 哪些需要拆分或重写
|
||
- 哪些可以作为已有产出直接关闭任务
|
||
- 将迁移方案提交用户确认后执行
|
||
|
||
**情况 B：无现有代码（全新项目）**
|
||
- 建议用户手动准备开发环境：
|
||
1. 安装 UE 5.7.4
|
||
2. 创建第三人称/第一人称/顶视角模板项目
|
||
3. 添加插件：BlockoutStarterPack、LowpolyCharacter
|
||
4. 启用 PythonEditorPlugins 插件
|
||
- 等待用户确认环境就绪
|
||
|
||
### 步骤 4：Gitea 初始化
|
||
|
||
依次执行（所有操作需用户确认后再执行）：
|
||
|
||
```bash
|
||
# 1. 创建标准标签
|
||
node scripts/gitea.js --role pm label init
|
||
|
||
# 2. 创建 Pipeline Tracker Issue
|
||
node scripts/gitea.js --role pm issue create \
|
||
--title "Pipeline Tracker" \
|
||
--body "# 流水线进度追踪
|
||
|
||
## 当前阶段
|
||
草图阶段
|
||
|
||
## 当前里程碑
|
||
- 名称: 草图阶段
|
||
- 状态: open
|
||
- Open Issues: 1
|
||
- Closed Issues: 0
|
||
|
||
## 阶段历史
|
||
| 阶段 | 里程碑 | 进入日期 | 完成日期 |
|
||
|------|--------|----------|----------|
|
||
| 草图阶段 | 草图阶段 | $(date +%Y-%m-%d) | — |" \
|
||
--labels "stage:sketch,role:pm,status:in-progress"
|
||
|
||
# 3. 创建草图阶段里程碑
|
||
node scripts/gitea.js --role pm milestone create \
|
||
--title "草图阶段" \
|
||
--description "概念设计与技术可行性验证"
|
||
|
||
# 4. 创建第一个任务：概念设计
|
||
node scripts/gitea.js --role pm issue create \
|
||
--title "D-001 概念设计" \
|
||
--body "## 任务信息
|
||
|
||
- **任务ID**: D-001
|
||
- **所属阶段**: 草图阶段
|
||
- **角色**: 策划
|
||
|
||
## 预期产出
|
||
|
||
产出概念草案 \`docs/design/概念草案.md\`，包含以下 7 个必填字段：
|
||
1. 一句话概述（这是什么游戏）
|
||
2. 核心玩法（玩家做什么）
|
||
3. 美术风格
|
||
4. 目标平台
|
||
5. 灵感来源
|
||
6. 核心假设（为什么好玩）
|
||
7. 范围约束（MVP 包含什么）
|
||
|
||
## 质量标准
|
||
|
||
- 每个字段有明确的、不含糊的描述
|
||
- 美术风格有参考图或参考作品
|
||
- 核心假设可验证（能通过原型验证）" \
|
||
--milestone "草图阶段" \
|
||
--labels "stage:sketch,role:design,status:ready" \
|
||
--assignees "ai-designer"
|
||
```
|
||
|
||
### 步骤 5：确认完成
|
||
|
||
初始化完成后向用户报告：
|
||
- ✅ 版本管理配置状态
|
||
- ✅ 项目管理配置状态
|
||
- ✅ Gitea 初始化结果（标签数、Pipeline Tracker Issue 编号、里程碑、首个任务编号）
|
||
- 📋 建议下一步：启动策划角色开始概念设计
|
||
|
||
---
|
||
|
||
## 注意事项
|
||
|
||
- 每一步都需要用户确认后才执行，不自动推进
|
||
- 如果中途失败（如 Gitea 连接失败），报告具体错误并建议修复方案
|
||
- 初始化完成后，PM 进入草图阶段，后续由 stage-sketch 技能接管
|