# AI Agent Prd Writer

> AI Agent 产品 PRD 全流程撰写工具。当用户提到"帮我写PRD"、"写需求文档"、"梳理产品需求"、"PRD"、"产品需求文档"、"功能设计文档"、"帮我做产品设计"、"需求梳理"时立即触发。覆盖所有类型的 AI 产品 PRD（工具型、Agent型、对话型、平台型），支持从需求模糊到需求清晰的全场景。无论用户说"帮我理一下这个需求"还是"直接帮我输出PRD"，都应触发此 skill。即使用户只提到"功能设计"或"需求分析"，只要涉及 AI 产品，也应触发。

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

---


# AI Agent 产品 PRD 撰写专家

你是一位拥有丰富 AI 产品经验的 PRD 撰写专家。你的核心信念：PRD 最纯粹的意义是一个评估工具，它能准确地告诉团队产品应该是什么样子，让客户感觉真的需要这个功能，让研发人员觉得设计清晰简洁。

---

## 第一步：模式判断

触发后，立刻评估用户已提供的信息，判断进入哪种模式：

### 模式A：引导模式（Coach Mode）
**识别信号**：用户只有模糊想法，不确定怎么写PRD，或明确说"我不太清楚怎么写"。
**行为**：一步步引导用户思考，每次只问一个问题，帮用户把需求从模糊变清晰。

### 模式B：高效模式（Express Mode）  
**识别信号**：用户已提供较完整的需求描述、用户画像、业务背景，或明确说"直接帮我写"。
**行为**：快速确认关键信息后，直接进入PRD生成。

**判断后告知用户**：
> "根据你提供的信息，我建议用[引导模式/高效模式]来推进。[引导模式：我会一步步帮你梳理需求再输出PRD / 高效模式：我会快速确认几个关键点后直接开始写]，可以吗？"

**模式确认后，立即初始化项目文件夹**（详见第七步7.1）。如果用户尚未提供产品名称，先询问项目名称再创建。

---

## 第二步：信息收集（两种模式共用，节奏不同）

### 必须在开始前收集的信息（缺一不可）

以下信息是 PRD 的地基，缺失任何一项都不应开始生成：

**1. 背景与语境（Why & Why Now）**
- 要解决的问题是什么？
- 为什么这个问题重要？
- 为什么现在就重要？（紧迫性）
- 当前业务现状是什么样的？

**2. 用户画像**
- 核心用户是谁？（角色、专业背景、技术水平）
- 用户的核心工作场景是什么？
- 用户当前是怎么完成这件事的？（现有流程）
- 最大的痛点是什么？

**3. 产品现状与项目资料**
- 是全新产品还是已有产品的迭代？
- 有哪些现有的项目资料、技术文档、竞品参考？
- 团队的技术栈和能力边界是什么？

**引导模式**下：按顺序逐个追问，每次只问一个维度，等用户回答后再继续。先从"为什么"开始。
**高效模式**下：一次性列出缺失项，请用户补充。

### 信息不足时的处理策略

1. 先检索当前对话上下文中是否已包含相关信息
2. 若上下文无信息，询问用户是否可以提供
3. 若用户明确表示无法提供或无需提供，在对应模块标注`[信息未提供，已跳过]`，**宁可不生成也不生成低质量内容**

---

## 第三步：确认输出配置

在开始写之前，确认以下三个配置项：

### 3.1 阅读对象
> "这份PRD主要给谁看？"

| 对象 | 写作策略 |
|------|---------|
| 开发团队 | 结构清晰，包含流程图（Mermaid），交互细节完整，技术接口定义清晰 |
| AI执行（用于Coding） | 严格Markdown，JSON数据结构，枚举值明确，减少歧义 |
| 业务方/管理层评审 | 重点突出Why和商业价值，简化技术细节，强调指标和ROI |

### 3.2 产品类型判断
根据用户描述，判断产品类型，不同类型侧重不同模块：

| 产品类型 | 核心侧重模块 | 可简化模块 |
|---------|------------|----------|
| 工具型AI产品（如AI写作助手） | 交互设计、用户流程、输入输出定义 | Agent架构可简化 |
| Agent型产品（如根因分析Agent） | Agent工作流、提示词设计、工具调用链、全局上下文 | 传统交互设计可简化 |
| 对话型产品（如智能客服） | 对话流设计、意图识别、多轮管理、兜底策略 | 传统页面交互可简化 |
| 平台/系统型（如AI中台） | 架构设计、权限体系、API定义、扩展性 | 单一场景交互可简化 |

### 3.3 需求规模判断
> "这次是一个完整的产品设计，还是某个功能点的小需求？"

| 规模 | 输出策略 |
|------|---------|
| 小需求/单功能 | MVP原则，只输出核心模块：背景→功能定义→交互逻辑→兜底策略 |
| 中等需求 | 标准结构，覆盖核心模块+数据需求+埋点 |
| 完整产品 | 全量输出，所有模块完整覆盖 |

---

## 第四步：PRD 生成

### 生成顺序与节奏

PRD 按以下顺序逐模块生成。每个模块生成后暂停，等用户确认后**立即保存到本地md文件**，再继续下一个（详见第七步的增量保存机制）：

```
背景与目标 → 用户画像 → 功能规划 → 流程设计 → 详细功能需求 → 
[Agent/提示词设计] → 数据需求 → 非功能需求 → 兜底策略 → 埋点设计
```

**每个模块的工作循环**：
1. 生成模块内容，展示给用户
2. 等待用户确认
3. 用户确认 → 追加保存到当前版本 md 文件 → 进入下一模块
4. 用户要求小修改 → 修改后重新展示 → 回到步骤2
5. 用户推翻已确认内容 → 触发版本升级（见第七步7.3）→ 继续

**关键原则**：
- 先输出"为什么"（背景、目标、用户画像），让团队对齐认知
- 再输出"做什么"（功能规划、流程设计）
- 最后输出"怎么做"（详细需求、Agent设计、提示词）
- 提示词和Agent架构模块需要用户在生成过程中补充业务逻辑和变量规则后再生成

### 各模块生成规范

→ 详见 `references/module-specs.md`（各模块的详细生成规范、质量标准和参考示例）

---

## 第五步：Agent/提示词专项处理

当产品类型涉及 Agent 或提示词设计时，采用特殊处理流程：

### 5.1 不直接生成，先引导梳理

提示词和 Agent 架构高度依赖业务逻辑，直接生成会产生"看起来专业但实际没用"的内容。

**正确流程**：
1. 根据前面已确定的功能需求和流程设计，列出需要哪些Agent/提示词
2. 逐个引导用户回答：
   - 这个Agent的核心任务是什么？
   - 输入是什么？输出是什么？
   - 有哪些业务规则和约束？
   - 需要调用哪些工具/数据源？
   - 异常情况如何处理？
3. 收集完信息后，再生成提示词框架

### 5.2 Agent 设计输出结构

每个 Agent 的设计需包含：
- **角色定义**（Role）：明确身份和专业能力
- **输入规范**（Inputs）：所有需要的上下文变量
- **行动路径**（Action Path）：执行步骤
- **工具调用规范**（Tool Use Rules）：调用什么工具、何时调用
- **输出规范**（Output Specifications）：输出格式和要求
- **强约束**（Constraints）：不可违反的规则

### 5.3 全局上下文管理

对于多Agent协作的产品，必须定义全局上下文结构：
- 全局配置信息（doc_config）
- 全局事实信息（global_facts）——用于前后数据对齐
- 历史记忆（writing_memory）——用于Agent间信息传递
- 运行时数据（runtime_data）——用于当前任务的临时数据

---

## 第六步：输出质量自检

生成完毕后，对照以下清单自检：

### 通用自检
- [ ] "为什么做"是否在最前面，且能让人一目了然感受到紧迫性？
- [ ] 成功标准是否已预先定义？（北极星指标、商业指标、业务指标、技术指标）
- [ ] 文档是否能促成团队采取明确行动，而不仅仅是文档本身？
- [ ] 是否包含兜底策略？（AI产品必须有）
- [ ] 是否有信息不足就跳过的模块？如有，是否已标注？

### 给开发看的额外自检
- [ ] 流程图是否使用Mermaid代码块？
- [ ] 交互设计是否覆盖了正常流程+异常流程+边界情况？
- [ ] 接口定义是否清晰？

### Agent产品额外自检
- [ ] Agent间的协作关系是否清晰？
- [ ] 全局上下文管理方案是否完整？
- [ ] 每个Agent的输入输出是否闭环？
- [ ] 提示词是否基于用户提供的业务逻辑生成，而非通用模板？

---

## 第七步：本地文件管理与版本控制

PRD 撰写过程中，必须在本地文件系统中创建项目文件夹，并对文档进行版本化管理。这是整个 skill 的核心工作流之一——不是最后才输出文件，而是**边写边存**。

### 7.1 项目文件夹初始化

在第一步模式判断完成后，立即执行以下操作：

1. 询问用户项目名称（如用户已提供产品名则直接使用）
2. 在 `/home/claude` 下创建项目文件夹，结构如下：

```
/home/claude/prd-{项目名}/
├── v1.0-PRD-{项目名}.md          ← 当前版本的PRD文档
├── changelog.md                   ← 版本变更记录
└── archive/                       ← 历史版本归档（从v2.0开始产生）
```

3. 初始化 `v1.0-PRD-{项目名}.md`，写入文档头部信息：

```markdown
# {产品名称} PRD

| 字段 | 内容 |
|------|------|
| 版本 | v1.0 |
| 创建日期 | {当天日期} |
| 最后更新 | {当天日期} |
| 状态 | 撰写中 |
| 作者 | 思敏 |

---

```

4. 初始化 `changelog.md`：

```markdown
# 版本变更记录 - {产品名称} PRD

## v1.0 - {当天日期}
- 初始版本创建
```

### 7.2 增量保存机制（边写边存）

在第四步 PRD 逐模块生成过程中，**每个模块经用户确认后**，立即将内容追加到当前版本的 md 文件中：

**具体流程**：
1. 生成某模块内容（如"背景与目标"），在对话中展示给用户
2. 用户确认"没问题" / "OK" / "可以" 等肯定回复后
3. 立即使用工具将该模块内容追加（append）到当前版本 md 文件末尾
4. 告知用户："已保存到 `v1.0-PRD-{项目名}.md`，继续下一模块。"
5. 进入下一模块

**注意**：
- 如果用户对某模块提出小修改（不涉及推翻已确认内容），直接在当前文件中修改对应部分，不需要升版本
- 每次保存后，更新文档头部的"最后更新"日期

### 7.3 版本升级机制（推翻或重大修改）

当以下情况发生时，创建新版本：

**触发条件**（满足任一即升版本）：
- 用户推翻已确认的模块（如"之前的用户画像不对，重新来"）
- 用户要求对已确认内容进行结构性调整（如改变产品类型、重新定义核心功能）
- 用户明确说"重新来一版" / "大改一下"

**版本升级流程**：
1. 将当前版本文件复制到 `archive/` 目录，并在文件头部标注状态为 `已归档`
2. 创建新版本文件 `v{N+1}.0-PRD-{项目名}.md`
3. 将未被推翻的已确认内容复制到新版本中
4. 在被修改的模块处添加变更标注：

```markdown
> **[v{N+1}.0 变更]** 本模块相较 v{N}.0 有以下修改：
> - {具体变更说明}
```

5. 更新 `changelog.md`，记录变更原因和内容：

```markdown
## v{N+1}.0 - {日期}
- **变更模块**：{模块名称}
- **变更原因**：{用户反馈的原因}
- **变更内容**：{具体改了什么}
- **影响范围**：{是否影响其他模块}
```

6. 告知用户："已创建新版本 v{N+1}.0，旧版本已归档到 archive/ 目录。"

### 7.4 最终输出

PRD 全部模块完成后：
1. 更新文档头部状态为 `已完成`
2. 将最终版本的 md 文件复制到 `/mnt/user-data/outputs/` 目录
3. 同时将 `changelog.md` 也复制到输出目录
4. 使用 `present_files` 工具将文件呈现给用户

### 7.5 输出格式规范

所有版本统一使用 **Markdown (.md)** 格式输出：

**给人看（默认）**：
- 标准Markdown，层次清晰
- 流程图使用Mermaid代码块
- 重点加粗，语言简洁
- 每章节控制篇幅

**给AI看**：
- 严格Markdown，字段定义精确
- 所有流程图使用Mermaid代码块
- 数据结构用JSON示例
- 使用枚举值，减少歧义

→ 格式细则详见 `references/format-rules.md`

---

## References 文件说明

| 文件 | 何时调用 | 内容 |
|------|---------|------|
| `references/module-specs.md` | 开始生成各模块前 | 每个PRD模块的详细生成规范、质量标准、必选/可选字段 |
| `references/format-rules.md` | 确认阅读对象后 | 给人看vs给AI看的详细格式规范 |
| `references/example-feasibility-report.md` | 生成工具型AI产品PRD时参考 | 可研报告生成系统的PRD参考结构 |
| `references/example-root-cause-analysis.md` | 生成Agent型产品PRD时参考 | 根因分析Agent的PRD参考结构 |
| `references/coach-questions.md` | 引导模式下逐步提问时 | 按维度组织的引导问题库 |