# 📌 完整指令参考手册

> 本文档包含所有项目管理相关指令的详细说明和使用示例。

---

## 一、项目初始化指令

### @项目管理 初始化项目工作区

**功能**: 为项目创建 `.apm/` 工作区，初始化所有管理文件。

**语法**:
```
@项目管理 初始化项目工作区
【项目名称】：[项目名]
【项目描述】：[一句话描述核心功能]
【预期周期】：[开发周期，如 21天]
【团队规模】：[人数，可选]
【技术栈】：[主要技术，可选]
```

**示例**:
```
@项目管理 初始化项目工作区
【项目名称】：私域银行 v2.0
【项目描述】：流量池管理 + 分润计算 + 一键提现
【预期周期】：30天
【团队规模】：3人
【技术栈】：Next.js + FastAPI + MongoDB
```

---

## 二、需求管理指令

### @项目管理 拆解需求

**功能**: 将需求描述拆解为可执行任务。

**语法**:
```
@项目管理 拆解需求
【需求描述】：[具体需求内容]
【优先级】：[P0/P1/P2/P3，可选]
【截止时间】：[目标完成时间，可选]
```

### @项目管理 变更需求

**功能**: 记录需求变更并评估影响。

**语法**:
```
@项目管理 变更需求
【原需求】：[原始需求描述]
【新需求】：[变更后需求]
【变更原因】：[原因说明]
```

---

## 三、进度管理指令

### @项目管理 更新进度

**功能**: 更新任务完成状态。

**语法**:
```
@项目管理 更新进度
【完成内容】：[已完成的工作描述]
【遇到问题】：[可选，遇到的阻碍]
【下一步计划】：[可选，接下来的工作]
```

**自动识别规则**:
| 关键词 | 动作 |
|:---|:---|
| "完成了"/"写完了" | 状态 → ✅ Done |
| "开始做"/"在做" | 状态 → 🔄 In Progress |
| "遇到问题"/"卡住了" | 状态 → ❌ Blocked |
| "取消"/"不做了" | 状态 → 🚫 Cancelled |

### @项目管理 查看进度

**功能**: 展示当前项目进度概览。

**语法**:
```
@项目管理 查看进度
【详细程度】：[概览/详细/甘特图，可选]
```

---

## 四、目录展开指令

### @项目管理 展开目录[N]

**功能**: 按照开发模板展开指定目录的内容。

**语法**:
```
@项目管理 展开目录[N]
【内容】：[具体要求]
```

**目录对照表**:

| N | 目录 | 角色 | 核心输出 |
|:---:|:---|:---|:---|
| 1 | 需求 | CFO + 产品负责人 | 业务需求文档、成本估算 |
| 2 | 架构 | CTO + 架构师 | 系统架构图、技术选型 |
| 3 | 原型 | UI/UX 设计师 | 页面结构、交互流程 |
| 4 | 前端 | 前端主程 | 组件代码、页面代码 |
| 5 | 接口 | API 架构师 | API 文档、Mock 数据 |
| 6 | 后端 | Python 架构师 | 后端代码、服务逻辑 |
| 7 | 数据库 | DBA | ER 图、集合设计 |
| 8 | 部署 | DevOps | 部署脚本、CI/CD |
| 9 | 手册 | 技术文档专家 | 用户手册、FAQ |
| 10 | 管理 | 高级 PM | 执行表、甘特图 |

### @项目管理 全量展开

**功能**: 一键展开所有 1-10 目录文档。

**语法**:
```
@项目管理 全量展开
【项目名称】：[项目名]
【核心功能】：[功能列表]
【目标用户】：[用户群体]
【预期规模】：[日活/数据量]
```

---

## 五、联动更新指令

### @联动 [源]→[目标]

**功能**: 基于源文档更新目标文档，保持一致性。

**常用联动**:
```
@联动 需求→架构：基于需求文档生成系统架构
@联动 架构→接口：基于架构设计生成 API 文档
@联动 接口→前端：基于 API 生成前端调用代码
@联动 接口→后端：基于 API 生成后端实现代码
@联动 数据库→后端：基于 ER 图生成 Model 定义
@联动 全量更新：基于变更同步所有相关文档
```

---

## 六、风险管理指令

### @项目管理 风险评估

**功能**: 评估当前项目风险。

### @项目管理 添加风险

**功能**: 记录新识别的风险。

**语法**:
```
@项目管理 添加风险
【风险描述】：[风险内容]
【可能性】：[高/中/低]
【影响程度】：[高/中/低]
【应对策略】：[处理方案]
```

---

## 七、复盘指令

### @项目管理 生成复盘报告

**功能**: 基于项目执行情况生成复盘报告。

### @项目管理 站会纪要

**功能**: 生成站会纪要。

**语法**:
```
@项目管理 站会纪要
【今日进展】：[完成的工作]
【明日计划】：[计划的工作]
【阻碍事项】：[遇到的问题]
```

---

## 八、提示词管理指令

### @项目管理 保存提示词

**功能**: 将常用提示词保存到提示词库。

**语法**:
```
@项目管理 保存提示词
【分类】：[需求/架构/开发/管理/部署/其他]
【名称】：[提示词名称]
【内容】：[提示词内容]
```

### @项目管理 列出提示词

**功能**: 查看提示词库内容。

### @项目管理 使用提示词

**功能**: 调用已保存的提示词。

---

## 九、对话上下文指令

### @项目管理 记录决策

**功能**: 记录重要决策到对话记录。

### @项目管理 生成会话摘要

**功能**: 生成当前对话的摘要，用于会话切换。

### @项目管理 加载上下文

**功能**: 从对话记录中加载历史上下文。

---

## 十、可视化指令

### @项目管理 生成甘特图

**功能**: 基于执行表生成甘特图。

### @项目管理 生成燃尽图

**功能**: 生成任务燃尽图数据。

### @项目管理 生成进度报告

**功能**: 生成可分享的进度报告。

---

## 十一、快捷指令汇总

| 指令 | 简写 | 功能 |
|:---|:---|:---|
| `@项目管理 查看进度` | `@进度` | 查看当前进度 |
| `@项目管理 更新进度` | `@更新` | 更新任务状态 |
| `@项目管理 拆解需求` | `@拆解` | 需求转任务 |
| `@项目管理 生成甘特图` | `@甘特图` | 生成甘特图 |
| `@项目管理 风险评估` | `@风险` | 评估项目风险 |
| `@项目管理 站会纪要` | `@站会` | 生成站会纪要 |
| `@项目管理 生成复盘报告` | `@复盘` | 生成复盘报告 |

---

## 十二、自然语言支持

除了结构化指令，系统也支持自然语言交互：

| 自然语言输入 | 识别为 |
|:---|:---|
| "登录功能写完了" | 更新对应任务为 ✅ |
| "现在进度怎么样" | 查看进度 |
| "加个新功能..." | 添加需求 |
| "遇到问题了..." | 标记阻塞 |
| "这个项目做完了" | 触发复盘 |

---

> **提示**: 所有指令都支持中文，使用时可以根据实际情况灵活调整参数。