# 产品市场契合度规划插件

`Claude Code` `产品验证` `MVP` `创业工具` `市场调研`

# Plan PMF

一个 Claude Code 插件，引导你从创意走向验证。定义你的理想客户画像（ICP），打磨价值主张，规划 MVP 范围，然后验证——通过落地页、Mom Test 对话，或 BMAD 方法。

作者：**Adi Shmorak，P/MF 侦探**

## 为什么要做这个

大多数开发者直接跳到写代码。Plan PMF 强迫你先回答那些难题——这是为谁做的？他们为什么会在意？你能构建的最小可证明的东西是什么？输出结果是一组 `pmf/` 文件，Claude 在为你的产品构建任何内容时都会参考这些文件。

## 安装

```bash
/install github:adidacta/pmf-detective
```

## 工作原理

Plan PMF 引导你完成 4 个章节，然后路由到执行阶段：

```
1. ICP（理想客户画像）  → pmf/icp.md           （假设）
2. 价值主张             → pmf/value-prop.md     （假设）
3. MVP PRD              → pmf/mvp.md            （假设）
4. 验证计划             → pmf/validation-plan.md （决定如何测试）
   │
   ├─→ 落地页     （注册 / 预购）
   ├─→ 用户触达   （Mom Test 对话）
   └─→ 构建与测试 （BMAD 方法）
```

前 3 个章节都是假设。验证计划决定如何测试这些假设，并将你路由到正确的执行路径。

## 快速开始

告诉 Claude 你需要什么：

- "帮我定义我的 ICP"
- "为我的产品创建价值主张"
- "定义我的 MVP"
- "帮我构建一个落地页"

或使用斜杠命令：

| 命令 | 功能 |
|------|------|
| `/plan-pmf` | 构建完整的上下文层（引导式流程） |
| `/pmf-status` | 检查上下文完成状态 |
| `/update-icp` | 优化你的 ICP |
| `/update-value-prop` | 优化你的价值主张 |
| `/update-mvp` | 优化你的 MVP 范围 |
| `/generate-assets landing` | 根据你的上下文生成落地页 |

## 4 个章节

### 1. ICP（理想客户画像）

定义你的客户是谁。生成 3 个假设，并行研究每一个，帮助你选出最强的：

- 他们是谁（角色 + 筛选条件）
- 他们的痛点（通过 5 个为什么，挖掘到情感根源）
- 他们如何描述痛点（用于文案的自我认同语言）
- 在哪里找到他们（渠道、社群、意见领袖、Newsletter）

**输出：** `pmf/icp.md`

### 2. 价值主张（钩子 + 磁铁）

打磨能让你的 ICP 停下来并采取行动的信息：

- **钩子（Callout）** —— 身份 + 场景 + 痛点，让他们说"说的就是我"
- **磁铁（Magnet）** —— 吸引他们行动的理想未来图景
- 生成 4 个角度（痛点导向、愿景导向、行动导向、身份导向）——由你选择

**输出：** `pmf/value-prop.md`

### 3. MVP PRD

从核心"顿悟时刻"反向推导，确定要构建的范围：

- **顿悟时刻（Aha Moment）** —— 让用户说"这就是我需要它的原因"的那个关键体验
- **通往顿悟的路径** —— 从起点到顿悟时刻的逆向工程步骤
- **功能与需求** —— 产品在每个步骤必须交付的内容
- **范围之外** —— v1 版本不包含的内容

输出是一份高层级的 PRD，任何 AI 编程助手都可以将其作为项目背景使用。

**输出：** `pmf/mvp.md`

### 4. 验证计划

在全力押注之前，决定如何测试你的假设：

- 总结你的 3 个核心假设（ICP、价值主张、顿悟时刻）
- 选择验证方法
- 定义 通过 / 迭代 / 转向 的判断阈值
- 路由到正确的执行技能

**输出：** `pmf/validation-plan.md`

## 执行路径

完成验证计划后，Plan PMF 将你路由到三条路径之一：

### 落地页
根据你的上下文文件生成一个 React + Vite 落地页。使用你的钩子、磁铁、顿悟路径、CTA 和 ICP 语言。包含 SEO 和社交标签。

```
/generate-assets landing
```

### 用户触达 + Mom Test
创建一份外联计划，包含 Mom Test 访谈问题。以你的 ICP 渠道、语言和痛点为基础。

### 构建与测试（BMAD 方法）
将你的 PMF 上下文桥接到 [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD)，用于 AI 驱动的开发。你的 `pmf/` 文件成为产品定义——BMAD 负责架构、迭代规划和实现。

## 上下文层

所有输出都保存在项目的 `pmf/` 文件夹中：

```
pmf/
├── icp.md              # 你的客户是谁
├── value-prop.md       # 他们为何在意（钩子 + 磁铁）
├── mvp.md              # MVP 范围——顿悟时刻、功能与需求
├── validation-plan.md  # 如何测试 + 成功阈值
└── outreach-plan.md    # （对话路径）Mom Test 问题 + 渠道
```

Claude 在为你的产品构建任何内容时都会参考这些文件——落地页、文案、功能、架构、文档。

**是否应该提交 `pmf/`？** 是的。这些文件是你的产品上下文。提交它们意味着每个团队成员和每个 Claude 会话都共享相同的基础。随着验证中的学习，持续更新它们。

## 使用建议

- **在章节之间执行 Compact。** 运行 `/plan-pmf` 时，在章节之间按提示使用 `/compact`。每个章节的输出都保存到了文件中，因此之前章节的对话历史可以安全裁剪。更短的上下文 = 更好的响应质量。
- **每个章节可独立运行。** 你不必在一个会话中完成完整流程。使用 `/update-icp`、`/update-value-prop` 或 `/update-mvp` 单独处理各个章节。

## 设计原则

- **每次一个问题** —— 永不让人不知所措，始终保持专注
- **"不确定"永远是一个选项** —— 不确定性会转化为待后续研究的开放问题
- **并行研究** —— ICP 假设同步进行研究
- **有主见的框架** —— 钩子 + 磁铁、5 个为什么、Mom Test、顿悟路径
- **AI 原生输出** —— 每个文件都结构化为 Claude 在构建时可参考的格式

## 反馈

问题、建议或反馈：**adi@adidacta.com**

## 致谢

- 钩子 + 磁铁价值主张框架
- Rob Fitzpatrick 的《妈妈测试》（访谈方法论）
- BMad Code 的 [BMAD Method](https://github.com/bmad-code-org/BMAD-METHOD)（构建与测试路径）

## 许可证

MIT —— 详见 [LICENSE](LICENSE)。