# /pmstart — 项目启动入口

每次工作会话的起点。执行 git 同步、检查更新、展示待办、建议下一步。

> **定位**：轻量快速入口，可在对话中途随时触发。深度审查请使用 `/plan`。

---

## 执行步骤

### Step 0：加载上下文

1. 执行 `git pull origin <当前分支名>` 拉取远端最新内容
2. 执行 `git status --short --branch` 获取分支名、同步状态和工作区变更
3. 执行 `git log --oneline -5` 查看最近 5 条提交记录
4. 读取 `docs/GIT-GUIDE-LITE.md`，将其中 Git 规范作为本次会话的操作依据

记录 pull 结果，用于 Step 1 判断。

### Step 1：检查更新

根据 Step 0 的 pull 结果判断：

- **无远端更新**（Already up to date）→ 跳到 **Step 3**
- **有远端更新** → 进入 **Step 2**

### Step 2：Review 更新内容

**2a. 列出变更摘要**

查看提交记录和变更文件列表：

- `git log --oneline <旧HEAD>..HEAD` 查看新提交
- `git diff <旧HEAD>..HEAD --stat` 查看变更文件列表
- 按角色归类变更（策划产出 / 程序产出 / 美术产出 / 计划文档 / 其他）

**2b. 评估影响**

对照 `docs/plans/current.md` 中的任务清单，评估：

1. **新产出**：其他角色是否提交了新的产出文件？（设计文档、技术方案、美术资产）
2. **质量门触发**：新产出是否处于需要 PM 审查的阶段？如果需要 → 标记为「建议使用 `/plan` 进行审查」
3. **进度标记**：已完成的任务是否需要更新 `[ ]` → `[x]`？
4. **优先级调整**：任务优先级是否需要因新产出而调整？

**2c. 决策**

- **不需要修改 current.md** → 输出变更摘要，跳到 **Step 3**
- **需要修改 current.md** → 进入 **2d**

**2d. 展示拟定变更，等用户确认**

向用户展示：

1. 远端更新了什么（按角色归类）
2. 建议对 `current.md` 做哪些修改（具体到每一行的增/删/改）
3. 如果涉及质量门审查，建议后续使用 `/plan`

等待用户反馈：

| 用户反馈 | 处理 |
|----------|------|
| **确认** | 按拟定内容更新 `current.md` → 提议提交并推送到远端 |
| **有其他想法** | 按用户的想法修改 → 提议提交并推送到远端 |

提交推送后，继续 **Step 3**。

### Step 3：展示 TODO + 建议下一步

1. 读取 `docs/plans/current.md`，展示未完成任务（仅 `[ ]` 未勾选项）
2. 读取 `docs/development-workflow.md`，判断当前宏观阶段（草案/原型/批量生产/测试发布）和流水线阶段
3. 综合分析后给出建议：
   - 接下来由**哪个角色**做什么**具体任务**（附理由）
   - 如果需要深度审查（质量门、流水线诊断）→ 建议使用 `/plan`
   - 给出具体命令建议

---

## 输出格式

### 标准输出（无更新 或 无需修改）

```markdown
## 📡 同步状态

**分支**: main ↑ synced
**工作区**: 干净 / 有 N 个未提交修改
**最近提交**:
- `abc1234` commit message 1
- `def5678` commit message 2
- ...

## 📋 当前 TODO

**开发阶段**: 原型
**流水线阶段**: ④执行案（①②③基本就绪）

- [ ] 任务1 — ④执行案
- [ ] 任务2 — ④执行案
- ...

## 🎯 建议下一步

**建议角色**: [策划/程序/美术]
**建议任务**: [具体任务描述]
**理由**: [为什么是这个任务]
**命令**: `/design` 或 `/dev` 或 `/art`
```

### 有更新需确认时的输出

```markdown
## 📡 同步状态

**分支**: main ↑ pulled (N new commits)
**工作区**: 干净

### 📥 远端更新摘要

**策划产出**:
- 新增 `docs/design/prototype/interaction-system-execution.md`
- 更新 `docs/design/prototype/collection-system.md`

**其他**:
- ...

### 📝 建议更新 current.md

1. 将 `[ ] 产出交互系统执行案` → `[x]` （文件已存在）
2. 新增任务：`[ ] 执行案质量门审查` （执行案阶段完成，需审查）
3. ⚠️ 建议：执行案已就绪，建议使用 `/plan` 进行质量门审查

---
等待确认后执行更新和推送。
```

---

## Git 操作规范（来自 GIT-GUIDE-LITE.md）

以下规范在本次会话中自动生效，后续所有 Git 操作必须遵守：

- **分支策略**：轻量 Feature Branch。从 `main` 切出 `feature/`、`fix/`、`prototype/` 分支开发，完成后合并回 `main` 并删除。`main` 永远可玩可编译。
- **分支命名**：`<类型>/<小写连字符描述>`，如 `feature/player-movement`、`fix/camera-clipping`
- **提交格式**：`<type>(<scope>): <中文描述>`，subject ≤ 50 字符
- **Type**：`feat` `fix` `art` `level` `audio` `bp` `refactor` `config` `docs` `wip`
- **Scope**（可选）：`player` `enemy` `combat` `ui` `camera` `inventory` `dialogue` `quest` `save` `audio` `animation` `ai` `level` `vfx`
- **UE5**：蓝图与 C++ 分开提交；`.uasset`/`.umap` 无法 diff，commit message 必须写清改了什么