PRD Workflow（完整 PRD 工作流）

版本: v4.2.5
作者: gotomanutd
更新日期: 2026-04-08
ClawHub: clawhub install prd-workflow

🎯 定位

一站式 PRD 生成技能 - 从模糊需求到完整 PRD 文档 + 流程图 + Word 导出

🔄 2 阶段执行模式

prd-workflow 采用2 阶段执行模式，正确理解这是使用本技能的关键！

阶段 0：访谈（OpenClaw AI 手动执行）

CODEBLOCK0

为什么需要阶段 0？

• - ✅ 访谈需要和用户实时交互（逐个提问 → 等用户回答 → 追问）
• ✅ 这是同步交互，不是异步任务
• ✅ 子代理无法进行访谈（不能等待用户回答）
• ✅ 所以访谈必须在当前会话由 OpenClaw AI 自己完成

核心指令：
CODEBLOCK1

访谈维度（6 个维度，16-50 个问题）：

访谈完成条件：

• - ✅ 至少问了 16 个问题
• ✅ 覆盖了 6 个维度
• ✅ 构建了完整的 sharedUnderstanding
• ✅ 用户确认理解正确

输出格式：

{
  "sharedUnderstanding": {
    "summary": "需求总结",
    "productPositioning": { "targetUsers": "目标用户", ... },
    "coreFeatures": ["核心功能 1", "核心功能 2"],
    "complianceRequirements": ["合规要求 1", "合规要求 2"]
  },
  "keyDecisions": [
    { "id": "d1", "topic": "决策主题", "decision": "决策内容", "rationale": "决策理由" }
  ],
  "questions": [
    { "question": "问题", "answer": "答案", "followUp": "追问" }
  ]
}

阶段 1：工作流（executeForAI 自动执行）

CODEBLOCK3

执行流程：
CODEBLOCK4

关键区分：

• - 访谈过程：OpenClaw AI 手动执行（在 executeForAI 之前）
• interview_module：代码模块，只检查 interview.json（在 executeForAI 之内）

📋 是否需要访谈？

判断流程：

CODEBLOCK5

场景对比：

🚀 使用方法

⚠️ 重要提示

正确启动方式：
CODEBLOCK6

错误方式：
CODEBLOCK7

为什么：

• - /skill 命令用于查看技能说明（类似 man 命令）
• 自然语言调用（"用 XXX 做 YYY"）才会真正执行技能代码
• prd-workflow 是工作流引擎，需要调用 executeForAI 才能启动完整流程

基础用法

完整流程示例

场景 1：首次生成（无文档）

CODEBLOCK8

场景 2：首次生成（有详细业务文档）

CODEBLOCK9

场景 3：迭代修改（已有访谈结果）

CODEBLOCK10

❌ 错误调用方式

错误 1：使用 /skill 命令

CODEBLOCK11

原因：/skill 命令只读取 SKILL.md 说明，不执行代码。

错误 2：启动子代理执行

CODEBLOCK12

原因：子代理无法进行阶段 0（访谈需要和用户实时交互）。

错误 3：跳过访谈直接调用

CODEBLOCK13

原因：interview_module 会检查 interview.json 是否存在。

💻 调用示例（开发者）

CODEBLOCK14

📁 输出位置（三级隔离）

隔离架构：
CODEBLOCK15

完整文件清单：

{用户 ID}/
└── {需求名称}/
    ├── interview.json            # 阶段 0：访谈结果
    ├── decomposition.json        # 阶段 1：需求拆解
    ├── prd.json                  # 阶段 1：PRD 生成
    ├── review.json               # 阶段 1：评审报告
    ├── flowchart.mmd             # 阶段 1：流程图
    ├── design.json               # 阶段 1：UI 设计
    ├── prototype/                # 阶段 1：HTML 原型
    ├── PRD.md                    # 阶段 1：PRD 文档
    ├── PRD.docx                  # 阶段 1：Word 导出
    └── .versions/                # 版本管理

🔧 执行方式（OpenClaw AI 必读）

⚠️ OpenClaw AI 必须执行

如果你是 OpenClaw AI，请务必理解以下内容：

阶段 0：访谈过程（你手动执行）

核心指令：
CODEBLOCK17

执行方式：

1. 1. 你自己提问：不要调用 interview_module 或其他代码
2. 逐个提问：一次问一个问题，等用户回答后再问下一个（vertical slicing）
3. 追问深度：根据用户回答追问细节，不要停留在表面
4. 探索分支：走每个设计分支，"如果选择 A，那么需要决定 X、Y、Z"
5. 构建理解：将所有问答整理成 sharedUnderstanding
6. 保存结果：写入 INLINECODE14

访谈技巧：

• - ✅ 设计树探索：走每个分支的设计决策（"如果选择 A，那么需要决定 X、Y、Z"）
• ✅ 依赖关系解析：resolve 决策之间的依赖（"这个决策依赖于前面的 X 决定"）
• ✅ 代码库探索：能查代码就不问
• ✅ 共享理解确认：总结并确认（"让我总结一下...以上理解是否准确？"）

阶段 1：调用工作流

访谈完成后，调用 executeForAI 继续执行：

CODEBLOCK18

❌ 不要做

1. 1. ❌ 不要直接调用 executeForAI 跳过访谈（interview.json 不存在会报错）
2. ❌ 不要使用硬编码的示例数据
3. ❌ 不要只问 1-2 个问题就结束
4. ❌ 不要跳过多轮问答直接生成 PRD
5. ❌ 不要在子代理中调用 executeForAI（无法进行访谈）

⚙️ 执行模式

支持 4 种执行模式，通过 options.mode 参数指定：

1️⃣ auto 模式（默认）

用途：正常执行完整流程

使用场景：

• - 首次生成 PRD
• 从零开始的需求

调用示例：
CODEBLOCK19

执行流程：

1. 解析用户需求
2. 生成执行计划（interview → decomposition → prd → ...）
3. 检查已有结果（跳过已完成的技能）
4. 执行剩余技能
5. 返回结果

2️⃣ iteration 模式（迭代）

用途：在现有 PRD 基础上追加/修改需求

使用场景：

• - 追加新功能（"追加社保测算功能"）
• 修改现有逻辑（"修改风险测评规则"）
• 优化已有描述

调用示例：
CODEBLOCK21

执行流程：

1. 分析需求变更（对比新旧需求）
2. 创建当前版本备份（v1 → v2）
3. 强制执行 decomposition（重新拆解）
4. 强制执行 prd（更新 PRD）
5. 可选：执行后续技能（review/flowchart 等）
6. 返回新版本号

3️⃣ fresh 模式（全新）

用途：清空重来，删除所有中间结果

使用场景：

• - 之前的执行结果混乱，需要重新开始
• 需求完全变化，旧结果无用
• 调试/测试需要干净环境

调用示例：
CODEBLOCK23

执行流程：

1. 清空输出目录（除 .versions 外）
2. 删除所有中间 JSON 文件
3. 删除 PRD.md
4. 从头开始执行完整流程

4️⃣ rollback 模式（回滚）

用途：恢复到历史版本

使用场景：

• - 迭代后效果不好，想恢复旧版本
• 对比不同版本的效果
• 误操作后恢复

调用示例：
CODEBLOCK25

执行流程：

1. 备份当前版本（自动创建 backup-xxx）
2. 恢复指定版本的文件
3. 更新当前 PRD.md
4. 返回成功消息

模式对比表

| 模式 | 用途 | 清空数据 | 创建版本 | 典型场景 |
|------|------|---------|---------|---------|
| auto | 正常执行 | ❌ | ❌ | 首次生成 |
| iteration | 迭代修改 | ❌ | ✅ | 追加/修改需求 |
| fresh | 清空重来 | ✅ | ❌ | 重新开始 |
| rollback | 恢复版本 | ❌ | ✅（备份） | 回滚操作 |

📋 PRD 结构（prd_template.js 强制约束）

实际输出结构：

CODEBLOCK27

🔧 核心代码文件

🎯 适用场景

✅ 推荐使用

场景	说明
需求模糊	用户只有大致想法，需要深度澄清
复杂业务

涉及多个模块/系统的复杂功能 |

❌ 不推荐

场景	推荐替代
简单功能	INLINECODE29（快速模式）
紧急需求

prd-generator（5 模块） |

📊 版本历史

🔒 安全说明

⚠️ ClawHub 安全扫描可能误报"Suspicious"

误报原因：

• - 本技能打包了 6 个依赖技能到 skills/ 目录（正常功能）
• 工作流脚本调用内置技能（正常功能，自动化编排）
• 包含 Python/Node.js 脚本（正常功能，技能执行需要）

实际安全检查：

• - ✅ 无二进制文件 - 已清理所有 .pyc
• ✅ 无外部 API 调用 - 全部本地执行
• ✅ 无敏感数据 - 无 API Key/密码
• ✅ 无系统文件访问 - 只在 workspace 内操作

结论：可以安全使用，误报不影响功能。

📖 参考资料

• - Matt Pocock Skills: github.com/mattpocock/skills

• - OpenClaw Skills: