Skill: danielniu/prd-writter (version 1.0.0)

--- name: prd-writer description: | 产品经理 PRD 撰写助手。根据用户输入的核心需求和北极星指标，自动生成结构化、可直接进入评审的 PRD 文档。 **核心价值：** - 用户只需提供核心需求 + 北极星指标 - Skill 自动完成 80% 的 PRD 撰写工作（功能清单、流程、埋点、验收标准等） **使用场景：** (1) 从一句话需求快速生成完整 PRD (2) AI/算法项目的 PRD 自动撰写（含模型评估、兜底策略） (3) 已有 PRD 的优化与补全 **触发词：** "写PRD"、"生成PRD"、"产品需求文档"、"帮我写PRD" metadata: version: "2.0.0" tags: ["product", "prd", "documentation", "ai", "auto-write"] --- # 产品经理 PRD 撰写助手 根据用户输入的核心需求和北极星指标，自动生成结构化、可直接进入评审的 PRD 文档。 ## 核心原则 1. **最小输入，最大输出** - 用户只需提供核心需求和北极星指标，Skill 自动完成 80% 的撰写 2. **自动撰写为主** - 需求背景、功能清单、用户流程、页面元素、异常场景、埋点、验收标准全部自动生成 3. **北极星目标驱动** - 所有生成内容围绕北极星指标展开，确保 PRD 目标清晰 4. **区分项目类型** - 通用产品功能用标准模板，AI/算法项目自动触发增强模块 ## 工作流程 ### 步骤 1：需求输入与北极星指标确认 **接收用户输入：** - 核心需求描述（自然语言，可以是一句话需求） - 北极星指标（如已提供） **北极星指标确认逻辑：** 如用户未提供北极星指标，执行以下步骤： 1. **反问核心目标**： > "你提到要做 XXX 功能，这个功能最终希望达成的核心目标是什么？" 2. **提供候选指标**（如用户未给出明确目标）： > "根据这类功能的常见目标，我提供几个候选指标供你选择：" > - A. （指标1：如功能使用渗透率） > - B. （指标2：如用户转化率） > - C. （指标3：如用户留存率） > - D. （指标4：如商业收入） 3. **确认后进入自动撰写**： 用户选择或明确北极星指标后，直接开始自动生成完整 PRD ### 步骤 2：自动撰写各章节 基于核心需求和北极星指标，自动撰写以下内容： #### 2.1 需求背景自动撰写 - 产品现状推导 - 核心问题提炼 - 北极星目标明确 #### 2.2 功能清单自动生成 - 按 MECE 原则拆分模块 - 列出功能点并标注 P0/P1/P2 优先级 - 说明字段 #### 2.3 用户流程自动梳理 - 主流程：用户正常完成任务的步骤 - 分支流程：不同选择路径 - 异常流程：网络异常、输入异常、权限异常等 #### 2.4 页面元素自动推导 - 字段名称、输入类型 - 是否必填、校验规则 - 页面交互逻辑 #### 2.5 异常场景自动覆盖 至少覆盖 4 类常见异常： - 网络异常 - 服务端异常 - 用户输入异常 - 权限异常 #### 2.6 埋点方案自动设计 至少覆盖 3 个维度： - 功能使用（是否使用、使用频次） - 用户转化（转化率、漏斗） - 效果评估（目标达成情况） #### 2.7 验收标准自动生成 - 每个功能点 ≥ 2 条可验证标准 - 避免模糊表述（如「快速响应」→ 「响应时间 ≤ 2s」） - 使用 Checklist 格式 ### 步骤 3：AI 项目增强（如检测到 AI 相关需求） 当用户提及 LLM、AI、模型、算法、推荐等关键词时，自动触发： #### 3.1 AI 能力定义自动推导 - 任务类型（分类/抽取/生成/推理/RAG/Agent） - 输入格式定义 - 输出格式定义 - 上下文长度预估 #### 3.2 模型评估指标自动生成 覆盖 4 个维度： - 准确性 - 完整性 - 稳定性 - 幻觉率 #### 3.3 Prompt 模板自动设计 包含 4 要素： - 角色定义 - 任务定义 - 输出格式 - 约束条件 #### 3.4 异常兜底策略自动建议 覆盖 4 类场景： - 格式异常 - 低置信 - 幻觉 - 安全合规 ### 步骤 4：PRD 输出 套用对应模板，输出完整的 Markdown PRD： | 项目类型 | 模板文件 | 适用场景 | |---------|---------|---------| | 通用产品功能 | `templates/prd-template.md` | App/Web 功能、后台系统、运营工具等 | | AI/算法项目 | `templates/ai-prd-template.md` | 智能筛选、推荐系统、AIGC、自动化流程等 | **输出规范：** 1. 删除模板中所有未填充的示例占位符 2. 表格中的空行必须删除 3. 所有功能必须包含验收标准 4. AI 项目必须包含技术实现链路图 --- ## 通用 PRD 模板结构（`templates/prd-template.md`） ```markdown # 产品需求文档 ## 前言 > （一句话概括产品/功能定位） --- ## 一、版本信息 | 项目 | 内容 | |------|------| | 版本号 | v1.0 | | 创建日期 | YYYY-MM-DD | | 作者 | | | 审核人 | | --- ## 二、变更日志 | 时间 | 版本号 | 变更人 | 主要变更内容 | |------|--------|--------|-------------| | | | | | --- ## 三、文档说明 ### 名词解释 | 术语 / 缩略词 | 说明 | |--------------|------| | | | --- ## 四、需求背景 ### 4.1 产品 / 数据现状 - 【产品现状】： - 【核心问题】： - 【北极星目标】： ### 4.2 用户调研 | 调研方法 | 样本情况 | 关键结论 | |---------|---------|---------| | | | | ### 4.3 竞品分析 | 竞品名称 | 主要信息 | 关键结论 | |---------|---------|---------| | | | | --- ## 五、需求范围 ### 5.1 功能架构 ``` （功能架构图） ``` ### 5.2 需求范围清单 | 模块 | 功能点 | 优先级 | 备注 | |------|--------|--------|------| | | | | | --- ## 六、功能详细说明 ### 6.1 产品流程图 ``` （流程图） ``` ### 6.2 交互原型图 （原型图链接或描述） ### 6.3 功能说明 | 序号 | 模块 | 功能 | 功能详细说明 | 交互图 | |------|------|------|-------------|--------| | 1 | | | | | **功能详细说明示例：** **功能名称**：XXX **需求描述**： - **交互流程**： 1. 步骤1： 2. 步骤2： **页面元素**： | 元素 | 类型 | 说明 | 校验规则 | |------|------|------|---------| | | | | | **异常处理**： - 异常场景1： **埋点需求**： - 事件1： **验收标准**： - [ ] 标准1： - [ ] 标准2： --- ## 七、非功能需求 - 【性能需求】： - 【安全需求】： - 【兼容性需求】： - 【其他需求】： --- ## 八、埋点 ### 8.1 事件埋点 | 参数名 | 参数说明 | 参数值 | |--------|---------|--------| | | | | ### 8.2 效果指标埋点 | 参数名 | 参数说明 | 计算方式 | |--------|---------|---------| | | | | --- ## 九、项目规划 ### 9.1 里程碑 | 阶段 | 交付物 | 截止日期 | 负责人 | |------|--------|---------|--------| | | | | | ### 9.2 依赖项 - --- ## 附录 ### 数据分析报告 ### 用户调研报告 ### 设计分析报告 ### 参考文档 - ``` --- ## AI 项目 PRD 增强模板结构（`templates/ai-prd-template.md`） AI 项目除了通用章节外，自动补充以下核心内容： ```markdown ## AI 能力定义 ### 任务类型 （分类/抽取/生成/推理/RAG/Agent） ### 输入定义 - 原始输入数据： - Prompt 结构： - 上下文长度预估： ### 输出定义 - 输出格式：JSON / 表格 / 自然语言 - 字段说明： ## 模型选型与工程方案 ### 模型选择 - 主模型： - 备用模型： ### 调用方式 ### 性能要求 ### 技术实现链路图 ``` [输入] → [预处理] → [Prompt组装] → [AI处理] → [结果存储] → [输出] ``` ## 数据与评估体系 ### 评测集 ### 评估维度与验收标准 | 维度 | 评估方法 | 验收标准 | |------|----------|----------| | 准确性 | | | | 完整性 | | | | 稳定性 | | | | 幻觉率 | | | ## Prompt 与规则设计 ### System Prompt 核心要素 ### 规则注入方式 ### Few-shot / CoT 设计 ### Prompt 版本管理 ## 兜底与风控 ### 格式异常兜底 ### 低置信处理 ### 幻觉防控 ### 安全合规 ``` --- ## 自动撰写规则详解 ### 功能清单生成规则 1. **MECE 原则**：相互独立，完全穷尽 2. **优先级标注**： - P0：核心功能，必须做 - P1：重要功能，尽量做 - P2：增强功能，有时间做 3. **模块划分**：按用户操作流或系统模块划分 ### 用户流程梳理规则 1. **主流程**：用户正常完成目标的最短路径 2. **分支流程**：基于不同条件的选择路径 3. **异常流程**： - 网络异常（无网络、超时） - 服务端异常（500、503） - 用户输入异常（格式错误、非法字符） - 权限异常（未登录、无权限） ### 页面元素推导规则 1. **字段名称**：清晰、无歧义 2. **输入类型**：文本、数字、选择、日期等 3. **校验规则**： - 必填/选填 - 格式限制（如手机号、邮箱） - 长度限制 - 范围限制 ### 埋点方案设计规则 1. **功能使用维度**： - 功能曝光（是否看到） - 功能点击（是否尝试使用） - 功能完成（是否成功完成） 2. **用户转化维度**： - 转化漏斗（每一步的流失率） - 转化时长（完成耗时） 3. **效果评估维度**： - 北极星指标达成情况 - 过程指标监控 ### 验收标准生成规则 1. **可验证**：能用「是/否」判断 2. **可量化**：有具体数值标准 3. **全覆盖**：覆盖正常、异常、边界场景 **示例对比：** - ❌ 模糊：「页面加载速度快」 - ✅ 可验证：「页面首屏加载时间 ≤ 2 秒（3G 网络）」 --- ## 使用示例 ### 示例 1：通用功能 PRD **用户输入：** > 我要做一个智能股价提醒功能，用户设置目标股价后，当股价达到条件时通过飞书通知用户。北极星指标是提醒设置转化率。 **Skill 处理：** 1. 确认北极星指标：提醒设置转化率 2. 自动生成完整 PRD： - 需求背景（产品现状、核心问题、北极星目标） - 功能清单（提醒设置、通知推送、提醒管理） - 用户流程（设置流程、触发流程、管理流程） - 页面元素（股票代码输入、目标价设置、通知方式选择） - 异常场景（股票代码无效、价格格式错误、网络异常） - 埋点方案（设置转化率、触发成功率、通知到达率） - 验收标准（设置成功率 ≥ 95%、通知延迟 ≤ 1 分钟等） ### 示例 2：AI 项目 PRD **用户输入：** > 我们想用 AI 给简历自动打分，帮助 HR 快速筛选候选人。北极星指标是 HR 筛选效率提升。 **Skill 处理：** 1. 检测到 AI 关键词，触发 AI 增强模块 2. 自动生成完整 PRD（含 AI 特有章节）： - AI 能力定义（简历信息抽取 + 评分生成） - 模型评估指标（准确率、一致性、幻觉率） - Prompt 模板（角色、任务、输出格式、约束） - 兜底策略（格式异常、低置信简历、人工复核触发） --- ## 输出规范 - **格式：** 使用 Markdown - **表格：** 用于结构化信息（清单、指标、计划等） - **列表：** 用于枚举项和检查项 - **代码块：** 用于示例数据、Prompt 模板、JSON Schema - **图表：** AI 项目用 ASCII 流程图描述技术链路 - **删除空占位：** 不要输出模板中留空的示例行 ## 注意事项 1. **不编造信息** - 自动生成时，不确定的内容标注「待确认」 2. **目标驱动** - 所有内容围绕北极星指标展开 3. **可协作** - PRD 面向产品、设计、开发、测试多角色 4. **按需展开** - 根据项目复杂度灵活调整章节深度

path: README.md
content: # PRD Writer Skill - 产品经理 PRD 撰写助手

## 简介

产品经理 PRD 撰写助手是一款 AI Skill，能够根据用户输入的核心需求和北极星指标，自动生成结构化、可直接进入评审的 PRD 文档。

## 核心价值

- **最小输入，最大输出**：用户只需提供核心需求 + 北极星指标
- **自动完成 80%**：功能清单、用户流程、埋点、验收标准等自动生成
- **支持 AI 项目**：自动检测 AI/算法需求，生成增强型 PRD

## 使用场景

1. 从一句话需求快速生成完整 PRD
2. AI/算法项目的 PRD 自动撰写（含模型评估、兜底策略）
3. 已有 PRD 的优化与补全

## 触发词

- "写PRD"
- "生成PRD"
- "产品需求文档"
- "帮我写PRD"

## 版本信息

- **版本**: 2.0.0
- **作者**: AI Assistant
- **标签**: product, prd, documentation, ai, auto-write

## 文件结构

```
prd-writer/
├── SKILL.md                 # Skill 主文件（入口）
├── templates/
│   ├── prd-template.md      # 通用产品功能 PRD 模板
│   └── ai-prd-template.md   # AI/算法项目增强模板
└── examples/
    └── example-prd.md       # 示例：智能股价提醒功能 PRD
```

## 安装方法

1. 将本 Skill 文件夹复制到 `~/.agents/skills/` 目录下
2. 确保文件结构完整
3. 重启 AI 助手或刷新 Skill 列表

## 工作原理

### 步骤 1：需求输入与北极星指标确认
接收用户的核心需求描述，确认或引导用户明确北极星指标

### 步骤 2：自动撰写各章节
- 需求背景自动撰写
- 功能清单自动生成（MECE 原则，P0/P1/P2 优先级）
- 用户流程自动梳理（主流程、分支流程、异常流程）
- 页面元素自动推导
- 异常场景自动覆盖（网络、服务端、输入、权限）
- 埋点方案自动设计（使用、转化、效果三维度）
- 验收标准自动生成

### 步骤 3：AI 项目增强（可选）
当检测到 AI/LLM/算法相关需求时，自动补充：
- AI 能力定义
- 模型评估指标
- Prompt 模板设计
- 异常兜底策略

### 步骤 4：PRD 输出
套用对应模板，输出完整 Markdown 格式的 PRD 文档

## 许可证

MIT License


path: manifest.md
content: # Skill Manifest

## 基础信息

- **name**: prd-writer
- **displayName**: 产品经理 PRD 撰写助手
- **version**: 2.0.0
- **description**: 根据用户输入的核心需求和北极星指标，自动生成结构化、可直接进入评审的 PRD 文档
- **author**: AI Assistant
- **tags**: product, prd, documentation, ai, auto-write, 产品经理, 需求文档
- **triggerWords**: 写PRD, 生成PRD, 产品需求文档, 帮我写PRD
- **entryPoint**: SKILL.md
- **language**: zh-CN
- **category**: productivity
- **icon**: 📝
- **minAgentVersion**: 1.0.0

## 模板文件

| 名称 | 文件路径 | 描述 |
|------|---------|------|
| 通用产品功能 PRD 模板 | templates/prd-template.md | 适用于 App/Web 功能、后台系统、运营工具等 |
| AI 项目 PRD 增强模板 | templates/ai-prd-template.md | 适用于智能筛选、推荐系统、AIGC、自动化流程等 AI 项目 |

## 示例文件

| 名称 | 文件路径 |
|------|---------|
| 智能股价提醒功能 PRD | examples/example-prd.md |


path: templates/prd-template.md
content: # PRD：{功能名称}

## 1. 文档信息

| 项目 | 内容 |
|------|------|
| 文档版本 | v1.0 |
| 创建日期 | YYYY-MM-DD |
| 作者 | |
| 评审人 | |
| 状态 | 草稿/评审中/已确认 |

## 2. 背景与目标

### 2.1 背景
{描述为什么要做这个功能，当前存在的问题或机会}

### 2.2 目标
{描述期望达到的业务目标和用户价值}

### 2.3 成功指标
- 指标1：{具体指标}，目标值：{数值}
- 指标2：{具体指标}，目标值：{数值}

## 3. 用户场景

### 3.1 目标用户
{描述目标用户画像}

### 3.2 用户故事
作为 {用户角色}，我希望 {需求}，以便 {价值}。

### 3.3 使用场景
**场景1：** {场景描述}
- 触发条件：
- 用户行为：
- 预期结果：

## 4. 功能需求

### 4.1 功能清单

| 功能模块 | 功能点 | 优先级 | 备注 |
|---------|--------|--------|------|
| 模块A | 功能点1 | P0 | |
| 模块A | 功能点2 | P1 | |
| 模块B | 功能点3 | P0 | |

### 4.2 功能详情

#### 4.2.1 {功能点名称}

**需求描述：**
{详细描述功能需求}

**交互流程：**
1. 步骤1：
2. 步骤2：
3. 步骤3：

**页面元素：**

| 元素 | 类型 | 说明 | 校验规则 |
|------|------|------|---------|
| | | | |

**异常处理：**
- 异常场景1：{处理方式}
- 异常场景2：{处理方式}

**埋点需求：**
- 事件1：{事件名称}，{触发时机}
- 事件2：{事件名称}，{触发时机}

**验收标准：**
- [ ] 标准1：{可验证的条件}
- [ ] 标准2：{可验证的条件}

## 5. 非功能需求

### 5.1 性能需求
- {性能指标要求}

### 5.2 安全需求
- {安全要求}

### 5.3 兼容性需求
- {兼容性要求}

## 6. 界面原型

### 6.1 页面流程图
{描述页面流转}

### 6.2 关键页面
{描述关键页面的布局和内容}

## 7. 数据需求

### 7.1 数据埋点
{列出需要埋点的事件和属性}

### 7.2 数据报表
{列出需要的数据报表}

## 8. 风险评估

| 风险类型 | 风险描述 | 影响程度 | 应对措施 |
|---------|---------|---------|---------|
| 技术风险 | | 高/中/低 | |
| 业务风险 | | 高/中/低 | |
| 资源风险 | | 高/中/低 | |

## 9. 项目计划

### 9.1 里程碑

| 阶段 | 交付物 | 截止日期 | 负责人 |
|------|--------|---------|--------|
| 需求评审 | PRD定稿 | | |
| 设计阶段 | 设计稿 | | |
| 开发阶段 | 功能上线 | | |
| 验收阶段 | 验收通过 | | |

### 9.2 依赖项
- {列出项目依赖的其他团队或功能}

## 10. 附录

### 10.1 术语表
- {术语}：{解释}

### 10.2 参考文档
- {文档链接}

### 10.3 变更记录

| 版本 | 日期 | 变更内容 | 作者 |
|------|------|---------|------|
| v1.0 | | 初稿 | |


path: templates/ai-prd-template.md
content: # PRD：{AI项目名称}

## 1. 文档信息

| 项目 | 内容 |
|------|------|
| 文档版本 | v1.0 |
| 创建日期 | YYYY-MM-DD |
| 作者 | |
| 评审人 | |
| 状态 | 草稿/评审中/已确认 |

## 2. 项目背景与目标

### 2.1 背景
{描述项目背景}

### 2.2 为什么用 AI
- 不用 AI 的替代方案：
- 选择 AI 方案的核心原因：

### 2.3 目标
{描述期望达到的业务目标和用户价值}

### 2.4 成功指标

| 类型 | 指标 | 目标值 |
|------|------|--------|
| 业务指标 | | |
| 业务指标 | | |
| 技术指标 | | |
| 技术指标 | | |

## 3. 用户场景与流程

### 3.1 用户角色
- {角色1}：{职责说明}
- {角色2}：{职责说明}

### 3.2 主流程
```
{用 ASCII 流程图或文字描述主流程}
```

### 3.3 人机协作边界（HITL）

| 环节 | 自动化策略 | 人工介入点 |
|------|------------|------------|
| | | |
| | | |
| | | |

### 3.4 异常分支
- **异常1**：{描述及处理方式}
- **异常2**：{描述及处理方式}

## 4. AI 能力定义

### 4.1 任务类型
- {分类 / 抽取 / 生成 / 推理 / RAG / Agent}

### 4.2 输入定义

#### 4.2.1 原始输入
- {输入数据类型及来源}

#### 4.2.2 Prompt 结构
- **System Prompt**：{角色定义、输出格式、禁止事项}
- **User Prompt**：{包含的内容}

#### 4.2.3 上下文长度预估
- {单次调用总长度预估}

### 4.3 输出定义

**输出格式：** {JSON / 表格 / 自然语言}

```json
{
  "字段1": "说明",
  "字段2": "说明"
}
```

## 5. 功能需求

### 5.1 功能清单

| 功能模块 | 功能点 | 优先级 | 备注 |
|---------|--------|--------|------|
| | | P0 | |

### 5.2 功能详情

#### 5.2.1 {功能点名称}

**需求描述：**
{详细描述}

**交互流程：**
1. 步骤1：
2. 步骤2：

**异常处理：**
- 异常场景1：{处理方式}

**验收标准：**
- [ ] 标准1：{可验证的条件}

## 6. 模型选型与工程方案

### 6.1 模型选择
- **主模型**：{Claude / GPT / 国内模型等}
- **备用模型**：

### 6.2 调用方式
- {同步 / 异步批处理 / 流式}

### 6.3 性能要求
- {响应时间、并发量、日处理量}

### 6.4 技术实现链路图
```
{用 ASCII 流程图描述完整数据链路}
```

## 7. 数据与评估体系

### 7.1 评测集
- {样本规模、来源、标注要求}

### 7.2 评估维度与验收标准

| 维度 | 评估方法 | 验收标准 |
|------|----------|----------|
| 准确性 | | |
| 完整性 | | |
| 稳定性 | | |
| 幻觉率 | | |

## 8. Prompt 与规则设计

### 8.1 System Prompt 核心要素
1. {角色定义}
2. {约束条件}
3. {格式要求}

### 8.2 评分规则注入方式
- {直接写入 Prompt / RAG 检索 / 规则引擎}

### 8.3 Few-shot / CoT
- {是否需要示例、链式思考}

### 8.4 Prompt 版本管理
- {Git / 文档系统 / 专门工具}

## 9. 兜底与风控

### 9.1 格式异常兜底
- {json_mode / 正则兜底 / LLM 二次解析 / 人工 fallback}

### 9.2 低置信处理
- {confidence 阈值、missing_info 标记策略}

### 9.3 幻觉防控
- {要求引用原文 / 抽查机制}

### 9.4 安全合规
- {数据脱敏 / 敏感信息过滤 / 审计日志}

## 10. 迭代计划

| 阶段 | 范围 | 关键交付 | 状态 |
|------|------|----------|------|
| Phase 1 | | | |
| Phase 2 | | | |
| Phase 3 | | | |

## 11. 风险评估

| 风险类型 | 风险描述 | 影响程度 | 应对措施 |
|---------|---------|---------|---------|
| 技术风险 | | 高/中/低 | |
| 业务风险 | | 高/中/低 | |
| 资源风险 | | 高/中/低 | |

## 12. 项目计划

### 12.1 里程碑

| 阶段 | 交付物 | 截止日期 | 负责人 |
|------|--------|---------|--------|
| | | | |

### 12.2 依赖项
- {列出项目依赖}

## 13. 附录

### 13.1 术语表
- {术语}：{解释}

### 13.2 参考文档
- {文档链接}

### 13.3 变更记录

| 版本 | 日期 | 变更内容 | 作者 |
|------|------|---------|------|
| v1.0 | | 初稿 | |


path: examples/example-prd.md
content: # PRD：智能股价提醒功能

## 1. 文档信息

| 项目 | 内容 |
|------|------|
| 文档版本 | v1.0 |
| 创建日期 | 2026-03-16 |
| 作者 | Ryan |
| 评审人 | |
| 状态 | 草稿 |

## 2. 背景与目标

### 2.1 背景
个人投资者需要实时监控持仓股票价格变动，及时获取买卖信号。目前用户需要手动查看行情，容易错过最佳交易时机。

### 2.2 目标
- 帮助用户自动化股价监控
- 及时推送关键价位提醒
- 提升用户交易效率和收益

### 2.3 成功指标
- 日活跃用户设置提醒数：>100
- 提醒触达率：>95%
- 用户满意度：>4.5/5

## 3. 用户场景

### 3.1 目标用户
- 个人投资者
- 有持仓股票需要监控
- 希望及时获取交易信号

### 3.2 用户故事
作为个人投资者，我希望设置股价提醒，以便在股价达到目标价位时及时收到通知。

### 3.3 使用场景
**场景1：设置买入提醒**
- 触发条件：用户想要在某只股票跌至目标价位时买入
- 用户行为：设置提醒价位（如跌至95元）
- 预期结果：股价跌至95元时收到买入提醒

**场景2：设置卖出提醒**
- 触发条件：用户想要在某只股票涨至目标价位时卖出
- 用户行为：设置提醒价位（如涨至110元）
- 预期结果：股价涨至110元时收到卖出提醒

## 4. 功能需求

### 4.1 功能清单

| 功能模块 | 功能点 | 优先级 | 备注 |
|---------|--------|--------|------|
| 提醒设置 | 添加股价提醒 | P0 | |
| 提醒设置 | 编辑股价提醒 | P0 | |
| 提醒设置 | 删除股价提醒 | P0 | |
| 提醒设置 | 批量设置提醒 | P1 | |
| 监控执行 | 实时股价监控 | P0 | 每2小时检查 |
| 通知推送 | 飞书消息推送 | P0 | |
| 通知推送 | 邮件通知 | P2 | |

### 4.2 功能详情

#### 4.2.1 添加股价提醒

**需求描述：**
用户可以为指定股票设置目标价位提醒，当股价达到或超过设定价位时触发通知。

**交互流程：**
1. 用户选择股票（输入股票代码或名称）
2. 系统显示当前股价
3. 用户设置提醒价位和条件（高于/低于）
4. 用户选择通知方式（飞书/邮件）
5. 系统保存提醒设置

**页面元素：**

| 元素 | 类型 | 说明 | 校验规则 |
|------|------|------|---------|
| 股票代码 | 输入框 | 支持代码或名称搜索 | 必填，合法股票代码 |
| 当前价格 | 文本 | 显示当前股价 | 自动获取 |
| 提醒价位 | 数字输入 | 目标价位 | 必填，>0 |
| 提醒条件 | 单选 | 高于/低于 | 必填 |
| 通知方式 | 多选 | 飞书/邮件 | 至少选一项 |
| 备注 | 文本框 | 可选备注 | 可选，最多100字 |

**异常处理：**
- 股票代码不存在：提示"股票代码不存在，请检查输入"
- 网络异常获取不到股价：提示"网络异常，请稍后重试"
- 提醒价位与当前价相同：提示"提醒价位不能与当前价相同"

**埋点需求：**
- 事件：add_stock_alert，触发时机：用户成功添加提醒
- 事件：add_stock_alert_fail，触发时机：添加提醒失败

**验收标准：**
- [ ] 支持A股、港股、美股代码搜索
- [ ] 提醒设置成功后可在列表页查看
- [ ] 股价触发后5分钟内完成推送

## 5. 非功能需求

### 5.1 性能需求
- 股价数据获取延迟 < 3秒
- 提醒推送延迟 < 1分钟

### 5.2 安全需求
- 用户数据加密存储
- API 调用频率限制

### 5.3 兼容性需求
- 支持 A 股、港股、美股

## 6. 界面原型

### 6.1 页面流程图
提醒列表页 → 添加提醒页 → 设置成功页

### 6.2 关键页面
**提醒列表页：**
- 显示已设置的提醒列表
- 支持编辑/删除操作
- 显示提醒状态（启用/暂停）

## 7. 数据需求

### 7.1 数据埋点
- 添加提醒次数
- 提醒触发次数
- 提醒点击率

### 7.2 数据报表
- 日活跃提醒数
- 提醒触发成功率
- 用户设置偏好分析

## 8. 风险评估

| 风险类型 | 风险描述 | 影响程度 | 应对措施 |
|---------|---------|---------|---------|
| 技术风险 | 股价数据源不稳定 | 中 | 多数据源备份 |
| 业务风险 | 提醒过于频繁导致用户关闭 | 低 | 提供提醒频率设置 |
| 资源风险 | 开发时间紧张 | 中 | 分阶段迭代 |

## 9. 项目计划

### 9.1 里程碑

| 阶段 | 交付物 | 截止日期 | 负责人 |
|------|--------|---------|--------|
| 需求评审 | PRD定稿 | 2026-03-20 | Ryan |
| 设计阶段 | 设计稿 | 2026-03-25 | 设计师 |
| 开发阶段 | 功能上线 | 2026-04-10 | 开发团队 |
| 验收阶段 | 验收通过 | 2026-04-15 | QA |

### 9.2 依赖项
- 飞书机器人接入
- 股票行情数据源

## 10. 附录

### 10.1 术语表
- PRD：Product Requirement Document，产品需求文档
- P0/P1/P2：优先级，P0为最高

### 10.2 参考文档
- 飞书 API 文档
- 股票行情 API 文档

### 10.3 变更记录

| 版本 | 日期 | 变更内容 | 作者 |
|------|------|---------|------|
| v1.0 | 2026-03-16 | 初稿 | Ryan |


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)