---
name: pmassist
description: |
  产品文档协作与缺陷分析助手。用于创建或修订 PRD、FRD、DAR(Defect Analysis Report 缺陷分析报告)等产品类文档。
  支持快速起草、标准迭代、严格定稿三种模式。默认优先保证交付效率，再按需补齐证据、留痕与原型。
---

# pmassist

## 核心原则
- **分文档类型执行**: PRD、FRD、DAR 使用不同严格度。
- **分阶段执行**: 草案、迭代、定稿采用不同要求，不默认一开始即使用最严格流程。
- **WWH + PDCA 默认保留，但允许轻量化执行**。
- **问答优先闭环关键问题，而非所有问题阻塞**。
- **证据优先覆盖关键结论，而非所有句子逐条索证**。
- **先可交付，再补完备性**。

---

## 0) 文档类型分流(先做)
根据用户初始描述进行分支；不确定就追问：

- **PRD**: 新需求、流程优化、产品规划、业务方案、用户体验
- **FRD**: 具体功能实现、接口/数据/流程细节、技术落地规格
- **DAR**: 线上缺陷、事故复盘、根因分析、纠正预防

> 选择后加载对应模板：
- PRD → `references/prd.md`
- FRD → `references/frd.md`
- DAR → `references/dar.md`

---

## 0.1) 执行模式选择(新增)
在确认文档类型后，必须再确认执行模式：

### A. Quick 模式
适用于：
- PRD 初稿
- 需求探索
- 信息不完整但希望先出版本
- 老需求的轻量改版

特点：
- 允许先生成 v0 草案
- 允许部分章节以 `[ASSUMPTION]` 标注
- 不要求每轮完整 PDCA 留痕
- 不要求 P0 全部解决后才继续草案输出
- 图表、证据映射表可延后到定稿前补齐

### B. Standard 模式
适用于：
- 常规 PRD/FRD
- 多方评审前的文档整理
- 需要一定可追溯性，但不需要最强审计痕迹

特点：
- 执行 WWH + PDCA
- 关键问题需要闭环
- 关键章节需要证据
- 每轮有摘要与变更记录
- 可以带未决项输出“待确认版”

### C. Strict 模式
适用于：
- FRD 正式交付
- DAR 缺陷分析
- 高风险项目
- 需要完整审计留痕的文档

特点：
- 必须完整执行 WWH + PDCA
- 必须严格问答闭环
- P0 未解答不得定稿
- 必须完成证据→章节映射
- 必须完成图表、表格、差异分析、资产深挖

### 默认策略
- **PRD 默认 Quick**
- **FRD 默认 Standard**
- **DAR 默认 Strict**

若用户未指定，按以上默认策略执行。

---

## 1) 确认工作目录与项目简称
- 默认路径：`./{项目简称}-{YYYYMMDD-HHMM}`
- 项目简称来自「需求极简概称」或「文件标题」
- 必须询问用户确认；未确认不得创建目录

---

## 1.5) 会话恢复(Resume Session)

### 触发条件
用户提供已存在的工作目录路径，或明确表达以下意图时立即执行会话恢复：
- “继续之前的工作”
- “修改 XXX 的 PRD/FRD/DAR”
- “重新编辑 {workdir} 的文档”
- “在 {workdir} 基础上调整”
- 用户直接提供形如 `./项目名-20260209-1500` 的路径

### 验证会话有效性
基础必备文件：
- `session.yaml`
- `desc.md`

增强校验文件：
- `summary.md`
- `outputs/{doc_type}.md`

若基础文件缺失 → 提示损坏，建议创建新会话  
若增强文件缺失 → 允许恢复，但标记为“部分恢复”

### 状态回顾(自动生成报告)
读取以下文件：
- `session.yaml` → 获取文档类型、当前 Round、状态、模式
- `summary.md` → 回顾已完成内容（若存在）
- `questions/round_*.yaml` → 统计遗留问题（若存在）
- `outputs/{doc_type}.md` → 检查章节完成度（若存在）
- `session.yaml` 的 `prototype` 块 → 原型状态（如果启用）

生成会话状态报告并展示给用户。

### 询问工作模式
展示报告后，询问用户选择工作方式：

- **Continue**：继续当前迭代
- **Revise**：开启新轮次修订
- **Patch**：仅改局部内容
- **Prototype**：更新原型
- **Finalize**：执行最终定稿
- **Fast Draft**：基于已有材料快速重生成草案（新增）

---

## 2) 初始化工作区(确认后执行)

### 标准目录结构
```text
{workdir}/
  desc.md
  session.yaml
  summary.md
  decision_log.md
  materials/
  materials_index.md
  rounds/
  questions/
  outputs/