核心用法
prd-workflow 是一个完整的 PRD（产品需求文档）生成工作流，通过 OpenClaw AI 驱动的多轮深度访谈模式，将模糊需求转化为结构化文档。核心使用方式：
用 prd-workflow 生成[需求描述]的 PRD
支持 6 种流程模板：
- full：完整 10 步流程（环境检查→访谈→拆解→PRD→评审→流程图→UI 设计→原型→导出→质量审核）
- lite：快速版（4 步核心）
- review-only / export-only / design-only：单环节执行
- check：仅环境检查
4 种执行模式
| 模式 | 用途 | 典型场景 |
|------|------|---------|
| `auto`（默认） | 正常执行完整流程 | 首次生成 PRD |
| `iteration` | 迭代修改，创建新版本 | 追加功能、修改逻辑 |
| `fresh` | 清空重来 | 需求完全变化、环境混乱 |
| `rollback` | 恢复到历史版本 | 迭代效果不佳、误操作恢复 |
深度访谈机制
关键特性：由 OpenClaw AI 直接执行，不调用代码模块，采用 "vertical slicing" 逐个提问策略：
- 每次只问一个问题，获取回答后再问下一个
- 覆盖 6 大维度（产品定位、核心功能、合规要求、技术约束、业务目标、用户场景）
- 至少 16 个问题，构建完整的
sharedUnderstanding - 自动探索设计树分支，解析决策依赖关系
---
显著优点
1. 金融场景深度优化
- 内置合规检查点：风险测评、适当性管理、冷静期设置等金融合规要求自动识别
- 专业 PRD 结构：采用
prd_template.js强制约束的标准格式，包含验收标准（Given-When-Then）、异常处理等金融级文档要求
2. 全流程自动化
- 10 步无缝衔接：从模糊需求到可交付 Word 文档的端到端自动化
- 内置 5 个专业技能：htmlPrototype（原型）、mermaid-flow（流程图）、prd-export（Word 导出）、requirement-reviewer（评审）、ui-ux-pro-max（UI 设计）
- 智能路由：
smart_router.js自动识别需求类型，编排最优执行路径
3. 企业级版本管理
- 三级隔离架构：用户 ID → 需求名称 → 版本号，确保多用户、多项目并行不冲突
- 自动版本迭代：
iteration模式自动创建 v1→v2 版本链，支持任意版本回滚 - 变更追踪：
requirement_diff.js自动对比需求变更，生成变更摘要
4. 质量保障机制
- 环境前置检查：
precheck_module.js在流程开始前检测依赖（mermaid-cli、Chrome、Python3），避免运行时崩溃 - 流程降级策略：依赖缺失时自动降级（如无 Chrome 则跳过截图），保证核心功能可用
- 质量门禁：
quality_gates.js多环节校验，v3.0.0+ 新增图片渲染服务统一输出
5. 输出标准化
- 双格式交付：Markdown（PRD.md）+ Word（PRD.docx）
- 图表自动嵌入：Mermaid 流程图自动渲染为 PNG 并嵌入 Word
- 设计系统输出：tokens.json 设计令牌 + HTML 可交互原型
---
潜在缺点与局限性
1. 依赖环境较重
- 必需依赖：Node.js、Python3、mermaid-cli、Chrome/Puppeteer
- 安装复杂度：v2.8.7+ 虽有 postinstall 自动安装，但首次配置仍需多环境协调
- 平台差异：macOS/Windows/Linux 的 Chrome 路径检测可能存在边缘情况
2. 执行时间较长
- 完整流程：10 步全执行通常需 5-15 分钟（含 AI 多轮访谈）
- 访谈不可跳过：即使需求明确，
full/lite模式仍强制 16+ 问题的深度访谈 - 不适合紧急需求：简单功能建议使用
prd-generator快速模式
3. 金融垂直领域局限
- 通用性折损：深度优化的金融合规检查点对非金融场景可能冗余
- 领域知识固化：合规检查点基于常规金融监管要求，新型金融产品（如 DeFi、Web3）可能需要手动扩展
4. 版本管理学习成本
- 概念复杂：
userId/projectName/.versions三级路径需理解隔离逻辑 - 回滚粒度：仅支持完整版本回滚，不支持单文件或片段级恢复
5. AI 访谈的不可控性
- 提问质量依赖模型：OpenClaw AI 的追问深度、分支探索能力受底层模型影响
- 无人工干预接口：访谈过程中无法人工指定跳过某维度或加速结束
---
适合人群
| 用户类型 | 匹配场景 |
|---------|---------|
| **金融产品经理** | 银行理财、保险、基金等需合规文档的产品需求 |
| **企业级 BA（业务分析师）** | 复杂多模块系统，需完整需求追溯与版本管理 |
| **交付型项目团队** | 客户要求正式 PRD + 流程图 + Word 的交付物 |
| **需求管理规范化团队** | 需建立统一 PRD 模板与质量门禁的组织 |
| **AI 辅助需求探索** | 需求模糊，需结构化引导澄清的场景 |
不适合：
- 个人开发者快速记录灵感
- 技术方案设计（推荐
technical-spec） - 紧急 1 小时内需要产出的场景
---
常规风险
1. 数据安全风险（S 级关注）
- 路径安全：v2.8.0+ 已实施
sanitizePath()过滤../、\等危险字符，但自定义userId注入仍需注意 - 多用户隔离：三级隔离架构理论上安全，但共享文件系统权限配置不当可能导致跨用户访问
- 建议：生产环境部署时限制
~/.openclaw/workspace/output/目录权限
2. 依赖失效风险
- Chrome 检测失败：v3.0.0 系统 Chrome 自动检测可能在特殊环境（Docker、CI/CD）失效
- mermaid-cli 版本漂移：mmdc 命令行参数变更可能导致流程图渲染失败
- 缓解：
precheck模式提前暴露问题，quality_gates降级执行
3. AI 生成质量风险
- 幻觉问题：PRD 中的业务规则、计算公式需人工校验
- 合规遗漏：内置检查点覆盖常规监管，地方性、行业特殊规定需人工补充
- 建议：
review-only模式强制人工评审环节，金融场景建议法务合规二次审核
4. 版本数据丢失风险
- fresh 模式误用：
fresh模式清空所有中间结果，无二次确认机制 - rollback 目标错误：未指定
version时回滚到上一版本，可能非用户预期 - 建议：关键版本手动备份
.versions/目录至外部存储
5. 输出格式兼容性
- Word 样式限制：
prd-export生成的 docx 为基础样式，企业 Branding 需后续调整 - Mermaid 复杂图支持：时序图、ER 图在 Word 中的渲染质量低于网页
- 建议：高要求场景使用
design-only模式配合专业设计工具二次加工