4.2 KiB
4.2 KiB
name, description
| name | description |
|---|---|
| pmassist | 产品文档协作与缺陷分析助手。用于创建或修订 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.yamldesc.md
增强校验文件：
summary.mdoutputs/{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) 初始化工作区(确认后执行)
标准目录结构
{workdir}/
desc.md
session.yaml
summary.md
decision_log.md
materials/
materials_index.md
rounds/
questions/
outputs/