starmen1265
cc0f66ac54
- development-workflow.md: 通用化(去掉UE5/ChildHood引用)，新增草案/原型/批量生产/测试发布四阶段， 修复流水线编号(①-⑦完整)，明确多版本迭代，新增阶段路线图，新增文档同步流程 - design.md: 适配阶段目录(prototype/production)，执行案模板增加迭代记录表头，新增草案模式E - plan.md/pmstart.md: 路径引用适配，增加宏观阶段判断 - 设计文档全部迁移到 docs/design/prototype/，清空旧子目录 - 新建 prototype-roadmap.md，roadmap.md 改为项目总览 - 更新 current.md 和 README.md 路径引用
149 lines
4.8 KiB
Markdown
149 lines
4.8 KiB
Markdown
# /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 必须写清改了什么
|