# Product Discovery Intentspec

> AI辅助产品发现与文档生成技能。当用户想要创建新产品、进行产品规划、编写PRD文档或意图工程文档时使用。适用于从零开始的产品发现、功能设计、需求文档编写等场景。触发词包括：产品发现、PRD、意图工程、IntentSpec、用户研究、机会评估、产品规划、需求文档、功能设计、用户故事。

- Skill: `yamsfeer/product-discovery-intentspec` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add yamsfeer/product-discovery-intentspec`
- Raw SKILL.md: https://api.skillmd.com/api/skills/yamsfeer/product-discovery-intentspec/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Product & Planning
- Author: yamsfeer (https://skillmd.com/u/yamsfeer)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/yamsfeer/product-discovery-intentspec

---


# AI 辅助产品发现与文档生成

这个 skill 帮助你系统性地完成从机会发现到 IntentSpec 的完整产品流程，生成专业的 PRD 和意图工程文档。

## 使用场景

- 想要创建新产品，但不知道从哪里开始
- 需要进行系统性的用户研究和机会评估
- 编写结构化的 PRD（产品需求文档）
- 编写详细的 IntentSpec（意图工程规范）
- 理解 PRD 和 IntentSpec 的关系与区别

## 核心能力

1. **6 阶段产品发现流程**
   - 机会发现（Opportunity Discovery）
   - 机会评估（Opportunity Assessment）
   - 用户研究（User Research）
   - 解决方案设计（Solution Design）
   - PRD 文档编写（PRD Writing）
   - IntentSpec 编写（IntentSpec Writing）

2. **方法论集成**
   - 定性研究、情感分析聚类
   - RICE 评分、TAM/SAM/SOM 分析
   - Persona、JTBD、用户场景
   - Kano 模型、MoSCoW、SMART 原则
   - 用户故事地图、User Story、AC
   - 五部分 IntentSpec 格式

3. **案例参考**
   - 电商 APP 完整案例
   - 支付功能 IntentSpec 案例
   - 笔记应用产品发现案例

## 工作流程

### 阶段 1：机会发现（Opportunity Discovery）

**目标**：从用户摩擦信号中发现真实痛点

**方法论**：
- 定性研究：爬取 Reddit、App Store 差评、社交媒体
- 情感分析聚类：提取高频问题模式，标记情绪强度
- 输出：高价值问题列表（提及次数、情绪强度、现有 workaround）

**关键原则**：
- 去用户抱怨的地方找问题，而不是看 Product Hunt 上的解决方案
- 提取"试图做 X 但遇到 Y 困难"的句式
- 愤怒程度越高，说明付费意愿越强

### 阶段 2：机会评估（Opportunity Assessment）

**目标**：选择最值得投入的机会

**方法论**：
- RICE 评分 = Reach × Impact × Confidence ÷ Effort
- 市场规模验证：TAM（总市场）、SAM（可服务市场）、SOM（可获得市场）
- 竞品分析：定价、用户痛点、差异化空间

**输出**：
- RICE 评分表
- 市场规模估算
- 差异化定位假设

### 阶段 3：用户研究（User Research）

**目标**：深度理解"谁"和"为什么"

**方法论**：
- Persona（用户画像）：基本信息、行为特征、痛点、目标
- JTBD（Jobs-to-be-Done）：从功能视角转换到用户目标视角
- 用户场景（User Scenarios）：背景、触发、痛点、期望

**核心问题**：
- 谁会为这个产品付费？
- 他们在什么场景下使用？
- 成功对他们意味着什么？

### 阶段 4：解决方案设计（Solution Design）

**目标**：将问题转化为具体产品功能

**方法论**：
- Kano 模型分类：基本需求、期望需求、兴奋需求、次要需求
- MoSCoW 优先级：Must/Should/Could/Won't Have
- MVP 定义：SMART 原则（Specific, Measurable, Achievable, Relevant, Time-bound）

**输出**：
- 功能分类表
- 优先级清单
- MVP 范围定义

### 阶段 5：PRD 文档编写

**目标**：结构化描述产品功能

**方法论**：用户故事地图（User Story Mapping）

**PRD 结构**：

```
PRD 文档
├── 1. 产品愿景（Product Vision）
├── 2. 目标用户（Target Users）
│   └── Persona 描述
├── 3. 功能需求（Functional Requirements）← 核心章节
│   └── 用户故事地图
│       ├── 用户活动（横向：浏览发现、下单购买等）
│       ├── 用户任务（纵向：具体步骤）
│       └── 功能点（系统支持）
├── 4. 非功能需求（Non-functional Requirements）
│   ├── 性能要求（P95 响应时间等）
│   ├── 安全要求
│   └── 兼容性要求
└── 5. 附录
```

**用户故事格式**：
> 作为 [角色]，我想 [功能]，以便 [价值]

**验收标准（AC）格式**：
```
Given [前置条件]
When [用户操作]
Then [系统响应]
And [附加条件]
```

### 阶段 6：IntentSpec 编写

**目标**：为核心功能编写可执行的详细规范

**方法论**：五部分 IntentSpec 格式

**IntentSpec 结构**：

```markdown
## 1. 目标（Goal）
- 观察到的现象（数据/用户反馈）
- 影响评估（损失/机会成本）
- 依据来源（访谈、数据分析、竞品分析）

## 2. 用户目标（User Job）
- 从用户角度描述待完成的工作
- 不是"系统要提供什么"，而是"用户想达成什么"

## 3. 成果（Outcomes）
- 业务指标（当前值 → 目标值）
- 功能要求（具体、可验证）
- 必须是可衡量的状态变化

## 4. 边缘情况（Edge Cases）
- 网络中断、服务不可用
- 用户误操作、边界输入
- 并发、重复操作
- 降级方案

## 5. 验证（Validation）
- 自动化测试清单
- 手动测试清单
- 上线监控指标
- 发布成功标准
```

## PRD 与 IntentSpec 的关系

```
产品文档体系
├── PRD（产品级）
│   ├── 描述"有哪些功能"
│   ├── 面向：产品经理、设计师、开发团队
│   ├── 粒度：功能模块级别
│   └── 更新频率：每个版本一次
│
└── IntentSpec（功能级）
    ├── 描述"这个功能具体怎么做"
    ├── 面向：开发人员、AI 助手
    ├── 粒度：单个功能详细规范
    └── 更新频率：开发前定稿

关系：PRD 中的每个核心功能 → 链接到一份 IntentSpec
```

| 维度 | PRD | IntentSpec |
|------|-----|------------|
| 范围 | 整个产品 | 单个核心功能 |
| 目标读者 | 全员 | 开发人员 |
| 详细程度 | 中等 | 高（包含所有边界情况）|
| 成功标准 | 功能完整性 | 可执行、可验证 |
| AI 可执行度 | 部分 | 高（可直接生成代码）|

## 参考案例

### 案例 1：电商 APP（闪电购）

**产品发现过程**：
- 机会发现：下沉市场女性用户购物体验差（数据：退货率 25%）
- 机会评估：RICE 得分 85 分，TAM 3 万亿
- 用户研究：Persona"小丽"，JTBD"30 秒内完成决策"
- 解决方案：Kano 分类（短视频是兴奋需求），MVP 8 周

**PRD 核心**：
- 用户旅程：浏览发现 → 下单购买 → 收货售后 → 再次购买
- 核心功能：视频流推荐、SKU 选择器、30 秒退款
- 非功能需求：P95 播放首帧 < 500ms

**IntentSpec 示例**：支付系统
- 目标：支付完成率从 82% 提升到 91%
- 边缘情况：12 种异常场景（网络中断、重复点击、渠道不可用等）
- 验证：7 天后支付完成率 ≥ 91%，无 P0/P1 故障

### 案例 2：笔记应用（MindRecall）

**产品发现过程**：
- 机会发现：Reddit/App Store 差评分析，"知识分散"提及 1,247 次
- 机会评估：RICE 得分 84 分，PKM 市场 $80 亿
- 用户研究：3 个 Persona（研究员小李、顾问王哥、学习者小美）

**PRD 核心**：
- 用户旅程：保存内容 → 组织整理 → 搜索使用 → 分享导出
- 核心功能：自然语言搜索、AI 自动关联
- 非功能需求：搜索响应 P95 < 500ms

**IntentSpec 示例**：自然语言搜索
- 目标：平均搜索时间从 4.5 分钟降至 30 秒
- 边缘情况：搜索词模糊、服务不可用、内容无文字等 6 种场景
- 验证：搜索成功率 ≥ 80%，语义匹配准确率 ≥ 85%

### 案例 3：支付功能 IntentSpec

**为什么单独写支付功能的 IntentSpec**：
- 支付是电商的核心交易环节，失败代价极高
- 边界情况复杂（网络、并发、渠道、风控）
- 需要精确的成功指标和监控

**关键边缘情况**：
| 场景 | 预期行为 |
|------|----------|
| 用户网络中断 | 15 秒超时，保留订单 30 分钟 |
| 连续快速点击支付 | 前端防抖 500ms，按钮禁用 |
| 支付渠道不可用 | 自动尝试备用渠道或提示更换 |
| 同一订单多窗口支付 | 幂等处理，防止重复扣款 |
| 支付成功但回调延迟 | 轮询订单状态，自动跳转 |

## 使用建议

### 何时使用完整 6 阶段流程

- 从零开始的新产品
- 进入新市场/新用户群
- 需要验证核心假设

### 何时跳过某些阶段

- 已有明确用户反馈：从阶段 3（用户研究）开始
- 竞品分析已完成：从阶段 2（机会评估）开始
- 功能优化：直接进入阶段 6（IntentSpec）

### 文档编写顺序

```
1. 先写 PRD 的功能需求章节（用户故事地图）
2. 确定核心功能（P0 优先级）
3. 为核心功能编写 IntentSpec
4. 回到 PRD，添加 IntentSpec 链接
5. 完善 PRD 的其他章节（愿景、非功能需求等）
```

## 输出质量检查清单

**PRD 检查**：
- [ ] 用户故事是否覆盖了完整用户旅程？
- [ ] 每个用户故事是否有验收标准（AC）？
- [ ] 非功能需求是否具体可衡量？
- [ ] 功能优先级是否明确？

**IntentSpec 检查**：
- [ ] 目标是否有数据支撑？
- [ ] 成果是否可衡量？
- [ ] 边缘情况是否全面？
- [ ] 验证方案是否可执行？
- [ ] 如果交给 AI 开发，是否无需追问？

## 工具与模板

### 快速启动模板

**PRD 模板**：见 `references/prd-template.md`

**IntentSpec 模板**：见 `references/intentspec-template.md`

### 常用指标参考

**性能指标**：
- P95 响应时间（95% 请求在此时间内完成）
- 系统可用性（如 99.9% = 年停机 < 8.76 小时）
- 首帧时间、加载时间

**业务指标**：
- 转化率、留存率、NPS
- CAC（获客成本）、LTV（用户生命周期价值）
- DAU/MAU、客单价

**优先级标记**：
- P0：必须有（Must Have）
- P1：应该有（Should Have）
- P2：可以有（Could Have）

## 最佳实践

1. **基于证据，而非假设**
   - 每个结论都要有数据来源
   - 明确标注哪些是假设，并计划如何验证

2. **从用户问题出发，而非解决方案**
   - 先理解用户要解决什么问题
   - 再思考产品如何解决这个问题

3. **详细程度与阶段匹配**
   - 早期：快速验证假设，文档可以简略
   - 后期：开发前，IntentSpec 必须详细完整

4. **保持更新**
   - 上线后根据数据反馈更新文档
   - 形成"发现 → 构建 → 验证 → 迭代"的闭环

## 参考资源

- 《用户故事地图》- Jeff Patton
- 《启示录》- Marty Cagan
- 《精益创业》- Eric Ries
- Pathmode Intent Engineering Playbook