| name | pm-alpha-prd-writer |
| description | PRD文档撰写规范。包含背景与目标、功能规格（含DICOM Tag映射表模板）、接口规范、验收标准（Gherkin格式）。适用于产品经理编写标准化产品需求文档，确保开发、测试团队对需求理解一致。当需要撰写或审核PRD文档时使用此skill。 |
PRD文档撰写规范
标准化产品需求文档模板，确保需求传递清晰、无歧义、可执行、可测试。
文档结构概览
PRD文档
├── 1. 背景与目标
├── 2. 功能规格
│ ├── 2.1 功能概述
│ ├── 2.2 用户故事
│ ├── 2.3 功能流程图
│ ├── 2.4 业务规则
│ └── 2.5 DICOM Tag映射表
├── 3. 接口规范
│ ├── 3.1 内部API
│ └── 3.2 外部集成
├── 4. 验收标准
│ └── Gherkin格式场景
├── 5. 非功能需求
└── 6. 附录
1. 背景与目标
1.1 文档信息
| 字段 | 内容 |
|---|
| 文档编号 | PRD-YYYYMMDD-XXX |
| 版本号 | v1.0 |
| 作者 | [产品经理姓名] |
| 创建日期 | YYYY-MM-DD |
| 最后更新 | YYYY-MM-DD |
1.2 背景描述
编写规范：说明业务背景、市场/用户需求来源、现有问题或优化机会
背景：
[描述当前的业务痛点或市场机会]
- 用户/客户遇到的问题：...
- 现有解决方案的不足：...
- 期望达成的目标：...
1.3 目标定义
业务目标（BO）
用户目标（UO）
1.4 成功标准
- 主要 KPI：[列出关键指标]
- 验收里程碑：[列出关键节点]
2. 功能规格
2.1 功能概述
功能清单
| 功能编号 | 功能名称 | 优先级 | 模块归属 |
|---|
| F-001 | | P0/P1/P2 | |
| F-002 | | P0/P1/P2 | |
功能依赖关系
┌─────────────────┐
│ 依赖功能 │
│ (前置条件) │
└────────┬────────┘
↓
┌─────────────────┐
│ 当前功能 │
│ (本PRD范围) │
└────────┬────────┘
↓
┌─────────────────┐
│ 被依赖功能 │
│ (后续支持) │
└─────────────────┘
2.2 用户故事
故事模板
用户故事编号：US-XXX
标题：[简洁描述]
作为 [角色]
我希望 [功能/行为]
以便 [获得的收益/价值]
验收标准：
- Given [前置条件]
- When [触发动作]
- Then [预期结果]
优先级：P0/P1/P2/P3
工作量：X 人/天
示例用户故事
用户故事编号：US-001
标题：放射科医生调阅患者历史检查影像
作为 放射科医生
我希望 在写报告时快速调阅患者的历史检查影像
以便 对比病情变化，支持诊断决策
验收标准：
- Given 我正在为患者A编写CT报告
- When 我点击"调阅历史"按钮
- Then 系统展示患者A过去30天内所有DICOM影像序列
- And 支持双击打开任意序列进行对比
优先级：P0
工作量：3 人/天
2.3 功能流程图
流程图符号规范
开始/结束 → 圆角矩形 (Terminator)
处理步骤 → 矩形 (Process)
判断分支 → 菱形 (Decision)
数据存储 → 波浪线矩形 (Data)
连接线 → 箭头 (Flow)
泳道图（跨角色流程）
┌──────────────┬──────────────┬──────────────┐
│ 医生 │ 系统 │ PACS │
├──────────────┼──────────────┼──────────────┤
│ │ │ │
│ 1. 选择患者 │ │ │
│ ↓ │ │ │
│ │ 2. 查询患者 │ │
│ │ ↓ │ │
│ │ │ 3. 返回影像列表│
│ │ ↓ │ │
│ 4. 查看影像 │ │ │
│ │ │ │
└──────────────┴──────────────┴──────────────┘
2.4 业务规则
规则清单
规则描述模板
**规则编号**：BR-XXX
**规则名称**：[简洁名称]
**规则描述**：
[详细描述业务规则逻辑]
**触发条件**：[在什么情况下此规则生效]
**业务影响**：
- 如果违反此规则：[后果]
- 如果遵守此规则：[收益]
**例外情况**：[是否有特殊豁免场景]
2.5 DICOM Tag映射表模板
适用于PACS/RIS系统功能开发
Tag映射表格式
## DICOM Tag 映射表
### 2.5.1 [功能名称] - Tag 读取映射
| Tag | Name | VR | 描述 | 读/写 | 必填 | 默认值 | 备注 |
|-----|------|----|----|----|----|----|-----|
| (0010,0010) | PatientName | PN | 患者姓名 | R/W | Y | - | 脱敏处理 |
| (0010,0020) | PatientID | LO | 患者ID | R/W | Y | - | 唯一标识 |
| (0010,0030) | PatientBirthDate | DA | 出生日期 | R | N | - | YYMMDD格式 |
| (0008,0020) | StudyDate | DA | 检查日期 | R | Y | - | 研究级日期 |
| (0008,0060) | Modality | CS | 设备类型 | R | Y | - | CT/MR/DX... |
| (0020,0010) | StudyInstanceUID | UI | 研究UID | R/W | Y | - | 唯一标识 |
| (0008,1030) | StudyDescription | LO | 检查描述 | R | N | - | - |
常用Tag参考表
| Tag | Name | VR | 说明 |
|---|
| 患者信息 | PatientName | PN | 患者姓名 |
| PatientID | LO | 患者ID |
| PatientBirthDate | DA | 出生日期 |
| PatientSex | CS | 性别 |
| 检查信息 | StudyDate | DA | 检查日期 |
| StudyTime | TM | 检查时间 |
| Modality | CS | 设备类型 |
| StudyDescription | LO | 检查描述 |
| AccessionNumber | SH | 检查号 |
| 序列信息 | SeriesInstanceUID | UI | 序列UID |
| SeriesNumber | IS | 序列号 |
| 图像信息 | SOPInstanceUID | UI | 图像UID |
| InstanceNumber | IS | 图像序号 |
SOP Class支持矩阵
| SOP Class | 支持操作 | C-ECHO | C-FIND | C-GET | C-MOVE |
|---|
| CT Image Storage | 是 | ✅ | ✅ | ✅ | ✅ |
| MR Image Storage | 是 | ✅ | ✅ | ✅ | ✅ |
| Print Management | 否 | ✅ | ❌ | ❌ | ❌ |
3. 接口规范
3.1 内部API规范
API模板
### API-XXX: [接口名称]
**接口描述**：[简要说明接口用途]
**请求信息**
- URL：/api/v1/{resource}
- Method：GET/POST/PUT/DELETE
- Content-Type：application/json
**请求头**
| 参数 | 类型 | 必填 | 说明 |
|-----|------|-----|------|
| | | | |
**请求参数**
| 参数 | 类型 | 必填 | 说明 |
|-----|------|-----|------|
| | | | |
**请求示例**
```json
{
"key": "value"
}
响应格式
{
"code": 200,
"message": "success",
"data": {}
}
响应码定义
| 响应码 | 说明 |
|---|
| 200 | 成功 |
| 400 | 请求参数错误 |
| 401 | 未授权 |
| 404 | 资源不存在 |
| 500 | 服务器错误 |
错误码定义
| 错误码 | 说明 | 处理建议 |
|---|
| E001 | 参数缺失 | 检查必填参数 |
| E002 | 权限不足 | 申请权限 |
### 3.2 外部系统集成
#### 集成矩阵
| 外部系统 | 集成方式 | 数据流向 | 关键Tag/字段 | 备注 |
|---------|---------|---------|-------------|------|
| | | | | |
---
## 4. 验收标准（Gherkin格式）
### 4.1 Gherkin语法规范
#### 关键字定义
- **Feature**：功能特性
- **Scenario**：场景
- **Given**：前置条件
- **When**：触发动作
- **Then**：预期结果
- **And**：并列条件
- **But**：转折条件
- **Background**：共享前置条件
- **Scenario Outline**：参数化场景
- **Examples**：示例数据
### 4.2 验收标准模板
```gherkin
# 验收标准文档 - [功能名称]
## Feature: [功能名称]
### Background:
Given [共享的前置条件]
And [其他前置条件]
---
### Scenario: [场景001] - [场景名称]
**用户角色**：[医生/护士/管理员/...]
**前置条件**：
- Given [条件1]
- And [条件2]
**操作步骤**：
- When [动作1]
- And [动作2]
**预期结果**：
- Then [结果1]
- And [结果2]
**验收要点**：
- [ ] [具体检查项1]
- [ ] [具体检查项2]
---
### Scenario: [场景002] - [异常场景名称]
**前置条件**：
- Given [异常条件]
**操作步骤**：
- When [触发动作]
**预期结果**：
- Then [错误提示/处理方式]
**错误码**：[具体错误码]
4.3 完整示例
# 验收标准 - 患者影像调阅功能
## Feature: PACS影像调阅
### Background:
Given 系统已登录用户 "Dr. Zhang" (角色: 放射科医生)
And 患者 "Zhang San" 存在（PatientID: P12345）
And 该患者有3个历史检查（CT/2024-01-15, MR/2024-02-20, CT/2024-03-10）
---
### Scenario: UC-001 - 正常调阅患者历史检查
**用户角色**：放射科医生
**前置条件**：
- Given 当前在为患者 "Zhang San" 编写CT报告
- And 检查日期为 2024-03-10
**操作步骤**：
- When 点击 "调阅历史" 按钮
- And 选择时间范围 "过去90天"
**预期结果**：
- Then 系统展示3条历史检查记录
- And 每条记录显示：检查日期、设备类型、检查描述、序列数量
- And 默认选中最近一次同类检查（CT/2024-03-10）
**验收要点**：
- [ ] 历史检查列表按时间倒序排列
- [ ] 支持按设备类型筛选
- [ ] 支持按检查日期范围筛选
- [ ] 双击记录可打开影像查看器
---
### Scenario: UC-002 - 跨设备对比调阅
**前置条件**：
- Given 当前在为患者 "Zhang San" 编写CT报告
**操作步骤**：
- When 选择 CT/2024-03-10 和 MR/2024-02-20 进行对比
- And 点击 "开启对比模式"
**预期结果**：
- Then 影像查看器左右分屏显示两个检查
- And 支持同步滚动/缩放
---
### Scenario: UC-003 - 无权限访问患者数据
**前置条件**：
- Given 当前用户无 "急诊ICU" 病区数据访问权限
**操作步骤**：
- When 尝试调阅该病区患者影像
**预期结果**：
- Then 系统提示 "无权访问该患者数据"
- And 不返回任何影像信息
- And 记录审计日志（用户、时间、访问的患者ID、操作类型）
---
### Scenario Outline: UC-004 - 多患者批量调阅
**前置条件**：
- Given 系统存在 <患者列表> 个患者
- And 每个患者有 <检查数量> 个历史检查
**操作步骤**：
- When 批量选择这些患者
- And 点击 "调阅历史"
**预期结果**：
- Then 系统在 <响应时间> 内返回所有历史检查
- And 展示总数量为 <总检查数>
**Examples**:
| 患者列表 | 检查数量 | 响应时间 | 总检查数 |
|---------|---------|---------|---------|
| 10 | 5 | <3s | 50 |
| 50 | 10 | <10s | 500 |
5. 非功能需求
5.1 性能指标
| 指标 | 要求 | 测试方法 |
|---|
| 响应时间 | P95 < Xs | 压力测试 |
| 并发数 | 支持 N 用户同时在线 | 负载测试 |
| 吞吐量 | QPS >= X | 性能测试 |
5.2 安全需求
5.3 兼容性需求
5.4 可靠性需求
6. 附录
6.1 术语表
| 术语 | 定义 |
|---|
| DICOM | 医学数字影像和通信标准 |
| PACS | 影像归档和通信系统 |
| RIS | 放射信息系统 |
| HIS | 医院信息系统 |
6.2 参考文档
| 文档 | 位置/链接 |
|---|
| 技术方案设计 | [链接] |
| 数据库设计 | [链接] |
| 测试用例 | [链接] |
6.3 变更记录
| 版本 | 日期 | 作者 | 变更内容 |
|---|
| v1.0 | YYYY-MM-DD | | 初稿创建 |
