---
name: "project-initializer"
description: "项目初始化技能 — 检查版本管理/项目管理配置、初始化 Gitea 标签/里程碑。仅在项目无进度时由 PM 调用。"
---

# 项目初始化

> 本技能处理项目冷启动。在 PM 上下文中运行，完成后 PM 直接感知初始化结果。
> 仅在无 Pipeline Tracker 或无里程碑时触发。

---

## 初始化流程

### 版本管理确认

逐项确认以下内容：

1. **SSH 仓库地址**：确认 `git remote -v` 中的仓库地址正确
2. **角色 Gitea 账号**：确认以下 AI 角色账号存在且可访问
   - `ai-pm`
   - `ai-designer`
   - `ai-programmer`
   - `ai-artist`
   - `ai-reviewer`

   如不确定账号是否存在，通过 Token 文件或 API 验证。

3. **SSH key 配置**：测试 SSH 连接（命令参数中的主机和端口需向用户确认）
   - 失败 → 引导用户生成并配置 SSH key

### 项目管理配置

确认以下配置就绪：

1. **配置文件**：`.claude/skills/gitea-pm/gitea-config.json` 存在且包含：
   - `host`、`port`、`repoOwner`、`repoName`
   - `roles` 中所有角色的 `assignee` 和 `token`
2. **配置文件已忽略**：`.gitignore` 中包含 `gitea-config.json`
3. **Gitea CLI 可用**：`node .claude/skills/gitea-pm/gitea.js --role pm test` 运行通过

缺失时引导用户配置。

### 现有代码与需求检查

**情况 A：有现有代码和需求**
- 探索 `docs/` 和 `Content/` 目录结构
- 读取现有设计文档
- 生成迁移方案：
  - 哪些文档可直接映射到新阶段
  - 哪些需要拆分或重写
  - 哪些可以作为已有产出直接关闭任务
- 将迁移方案提交用户确认后执行

**情况 B：无现有代码（全新项目）**
- 建议用户准备开发环境：
  1. 安装对应版本的 UE
  2. 创建模板项目
  3. 添加所需插件
- **不等待就绪**，继续往下执行。只要在迭代阶段开始前环境准备就绪即可。

### Gitea 初始化

依次执行（所有操作需用户确认后再执行）：

```bash
# 1. 创建标准标签（从 gitea-config.json 读取定义）
node .claude/skills/gitea-pm/gitea.js --role pm label init

# 2. 创建 Pipeline Tracker Issue
node .claude/skills/gitea-pm/gitea.js --role pm pipeline init

# 3. 创建草图阶段里程碑
node .claude/skills/gitea-pm/gitea.js --role pm milestone create \
  --title "草图阶段" \
  --description "概念设计与技术可行性验证"
```

### 确认完成

初始化完成后向用户报告：
- ✅ 版本管理配置状态
- ✅ 项目管理配置状态
- ✅ Gitea 初始化结果（标签数、Pipeline Tracker Issue 编号、里程碑）
- 📋 建议下一步：进入草图阶段，由 stage-sketch 技能接管

---

## 注意事项

- 每一步都需要用户确认后才执行，不自动推进
- 如果中途失败（如 Gitea 连接失败），报告具体错误并建议修复方案
- 初始化完成后，PM 进入草图阶段，后续由 stage-sketch 技能接管
- **不创建首个任务** — 任务创建由 PM 根据阶段技能的逻辑来执行