# Pm Alpha Prd Writer > PRD文档撰写规范。包含背景与目标、功能规格（含DICOM Tag映射表模板）、接口规范、验收标准（Gherkin格式）。适用于产品经理编写标准化产品需求文档，确保开发、测试团队对需求理解一致。当需要撰写或审核PRD文档时使用此skill。 - Skill: `fengqiliu/pm-alpha-prd-writer` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add fengqiliu/pm-alpha-prd-writer` - Raw SKILL.md: https://api.skillmd.com/api/skills/fengqiliu/pm-alpha-prd-writer/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Product & Planning - Author: fengqiliu (https://skillmd.com/u/fengqiliu) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/fengqiliu/pm-alpha-prd-writer --- # 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 用户故事 #### 故事模板 ```markdown 用户故事编号：US-XXX 标题：[简洁描述] 作为 [角色] 我希望 [功能/行为] 以便 [获得的收益/价值] 验收标准： - Given [前置条件] - When [触发动作] - Then [预期结果] 优先级：P0/P1/P2/P3 工作量：X 人/天 ``` #### 示例用户故事 ```markdown 用户故事编号：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-001 | | | | #### 规则描述模板 ```markdown **规则编号**：BR-XXX **规则名称**：[简洁名称] **规则描述**： [详细描述业务规则逻辑] **触发条件**：[在什么情况下此规则生效] **业务影响**： - 如果违反此规则：[后果] - 如果遵守此规则：[收益] **例外情况**：[是否有特殊豁免场景] ``` ### 2.5 DICOM Tag映射表模板 > 适用于PACS/RIS系统功能开发 #### Tag映射表格式 ```markdown ## 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模板 ```markdown ### API-XXX: [接口名称] **接口描述**：[简要说明接口用途] **请求信息** - URL：/api/v1/{resource} - Method：GET/POST/PUT/DELETE - Content-Type：application/json **请求头** | 参数 | 类型 | 必填 | 说明 | |-----|------|-----|------| | | | | | **请求参数** | 参数 | 类型 | 必填 | 说明 | |-----|------|-----|------| | | | | | **请求示例** ```json { "key": "value" } ``` **响应格式** ```json { "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 完整示例 ```gherkin # 验收标准 - 患者影像调阅功能 ## 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 安全需求 - [ ] 数据加密：传输过程使用 TLS 1.2+ - [ ] 访问控制：基于角色的权限控制（RBAC） - [ ] 审计日志：记录所有敏感操作 - [ ] 敏感数据脱敏：患者姓名、ID等展示时脱敏 ### 5.3 兼容性需求 - [ ] 浏览器兼容：Chrome/Firefox/Edge/Safari 最新版本 - [ ] 操作系统兼容：Windows 10+, macOS 11+ - [ ] 设备兼容：桌面端/移动端响应式适配 ### 5.4 可靠性需求 - [ ] 系统可用性：99.9% - [ ] 数据备份：每日增量备份，每周全量备份 - [ ] 故障恢复：RTO < 4小时，RPO < 1小时 --- ## 6. 附录 ### 6.1 术语表 | 术语 | 定义 | |-----|------| | DICOM | 医学数字影像和通信标准 | | PACS | 影像归档和通信系统 | | RIS | 放射信息系统 | | HIS | 医院信息系统 | ### 6.2 参考文档 | 文档 | 位置/链接 | |-----|---------| | 技术方案设计 | [链接] | | 数据库设计 | [链接] | | 测试用例 | [链接] | ### 6.3 变更记录 | 版本 | 日期 | 作者 | 变更内容 | |-----|------|-----|---------| | v1.0 | YYYY-MM-DD | | 初稿创建 |