---
name: mp
description: 增量修改 PRD.md，根据用户指令在现有内容基础上更新产品需求文档。
---

# Modify PRD

当用户调用 `/mp` 时，执行以下步骤：

## 1. 读取目标文档

读取以下文件：

1. `doc/PRD.md` - 目标文档（必须存在）
2. `doc/RequirementsDoc.md` - 上游参考文档
3. `doc/review-PRD-claude.md` - 评审报告（如果存在，自动作为修改依据）

如果 PRD.md 不存在，提示用户：
> PRD.md 不存在，请先使用 `/wp` 生成产品需求文档。

## 2. 确定修改来源

按以下优先级确定修改内容：

### 2.1 用户提供了修改指令

如果用户在调用 `/mp` 时附带了参数或说明，直接使用该指令。

### 2.2 自动检测评审报告

如果用户未提供修改指令，**自动检测** `doc/review-PRD-claude.md` 是否存在：

- **存在**：读取评审报告，提取其中的问题清单（Critical / Major / Minor），作为本次修改的依据。向用户确认：
  > 检测到评审报告 `doc/review-PRD-claude.md`，包含 X 个问题。是否根据评审报告进行修改？

- **不存在**：询问用户：
  > 请说明需要修改的内容，或先运行 `/rp` 生成评审报告。

### 2.3 支持的修改来源

- 具体的修改描述（如"在功能需求中增加用户权限管理模块"）
- 评审报告（自动检测或手动指定路径）
- 对应的 RequirementsDoc 变更（如"/mr 已更新需求，请同步 PRD"）

## 3. 修改原则

### 3.1 增量修改
- 保留原有内容结构和格式
- 仅修改/新增指定部分
- 不删除未明确要求删除的内容

### 3.2 新增内容标记

对于新增的段落或章节，使用 HTML 注释标记：

```markdown
<!-- NEW START -->
新增内容...
<!-- NEW END -->
```

对于行内新增，使用：
```markdown
原有内容 <!-- NEW --> 新增内容
```

### 3.3 修改内容标记

对于修改的内容，保留原文作为注释：

```markdown
<!-- MODIFIED: 原内容为 "xxx" -->
修改后的内容
```

### 3.4 与 RequirementsDoc 一致性

- 所有 PRD 内容必须可追溯到 RequirementsDoc
- 如果修改涉及新功能，先确认 RequirementsDoc 中已有对应需求
- 如果 RequirementsDoc 未包含相关需求，提醒用户先更新需求文档

## 4. 执行修改

按照用户指令修改文档：

1. 定位到需要修改的位置
2. 执行增量修改
3. 添加相应的标记
4. 保持文档格式一致性
5. 确保修改内容与 RequirementsDoc 一致

### 4.1 修改类型处理

| 修改类型 | 处理方式 |
|----------|----------|
| 新增功能点 | 在对应功能模块表格中添加行，关联用户故事 |
| 新增用户故事 | 在 2.2 用户故事列表中添加，分配 US-xxx ID |
| 修改优先级 | 更新功能点优先级，必要时调整用户故事分类 |
| 修改验收标准 | 更新对应功能点的验收标准列 |
| 新增模块 | 在 3.2 功能详情中添加新的子章节 |
| 修改非功能需求 | 在对应章节更新指标或要求 |

## 5. 保存并验证

1. 保存修改后的文档到 `doc/PRD.md`
2. 使用 git diff 展示变更内容
3. 向用户确认修改是否符合预期

## 6. 输出摘要

向用户展示修改摘要：
- 修改位置（章节/行号）
- 修改类型（新增/修改/删除）
- 修改内容概要
- 与 RequirementsDoc 的一致性确认

---

## 注意事项

- PRD 依赖于 RequirementsDoc，修改时需确保与上游文档一致
- 修改 PRD 后，下游文档（FeatureSummary、DevelopmentPlan 等）可能需要同步更新
- 保持现有文档风格（标题层级、表格格式、列表样式）
- 用户故事 ID 必须唯一且连续（US-001, US-002...）
- 所有功能点必须关联到用户故事
- 重大修改建议先运行 `/rp` 评审确认影响范围
- 修改完成后，建议用户运行 `/rf` 检查下游文档一致性

## 标记清理

当用户确认修改无误后，可手动删除 `<!-- NEW -->` 和 `<!-- MODIFIED -->` 标记，或保留作为变更历史参考。

通过 git 可追溯完整修改历史。

## 质量检查

修改 PRD 后，自查以下项目：

- [ ] 修改内容与 RequirementsDoc 一致
- [ ] 新增用户故事有唯一 ID
- [ ] 新增功能点关联到用户故事
- [ ] 新增功能点有明确优先级和验收标准
- [ ] 标记格式正确（`<!-- NEW -->` / `<!-- MODIFIED -->`）
- [ ] 文档结构完整，格式一致