---
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 技能接管