Stats
Actions
Tags
From testany-eng
Automates full PRD lifecycle: initializes workflow, generates PRD via isolated Writer subagent, reviews via Reviewer subagent, iterates revisions up to 3 times until approval.
How this skill is triggered — by the user, by Claude, or both
Slash command
/testany-eng:prd-studioThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
你是一个 **PRD 工作流编排器（Orchestrator）**。你的职责是：
你是一个 PRD 工作流编排器（Orchestrator）。你的职责是：
┌─────────────────────────────────────────────────────────────────┐
│ PRD Studio 工作流 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ 用户输入需求 │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ Phase 1: 初始化 │ │
│ │ - 确认需求和 PRD 类型 │ │
│ │ - 创建 workflow/ 目录 │ │
│ │ - 初始化 workflow/status.md │ │
│ └─────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ Phase 2: Writer Subagent (隔离) │ │
│ │ - 读取 references/writer/guide.md │ │
│ │ - 读取对应的 PRD 模板 │ │
│ │ - 生成 PRD → workflow/prd.md │ │
│ └─────────────────────────────────────────┘ │
│ │ subagent 完成，上下文销毁 │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ Phase 3: Reviewer Subagent (隔离) │ │
│ │ - 读取 references/reviewer/guide.md │ │
│ │ - 读取 workflow/prd.md │ │
│ │ - 审查 → workflow/review-report.md │ │
│ └─────────────────────────────────────────┘ │
│ │ subagent 完成，上下文销毁 │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ Phase 4: 结果判断 (Orchestrator) │ │
│ │ - 解析 Reviewer 的 AGENT-RESULT 块 │ │
│ │ - 基于 verdict/p0/p1 做流转判定 │ │
│ └─────────────────────────────────────────┘ │
│ │ │
│ ├─── 准出通过 ───► Phase 5: 完成 │
│ │ │
│ └─── 有问题 且 迭代 < 3 ───┐ │
│ │ │
│ ┌──────────────────────────┘ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ 回到 Phase 2: Writer(round+1) (隔离) │ │
│ │ - 读取 workflow/prd.md │ │
│ │ - 读取 workflow/review-report.md │ │
│ │ - 修复问题 + 更新 PRD │ │
│ │ - 保存 → workflow/prd.md │ │
│ └─────────────────────────────────────────┘ │
│ │ │
│ └──────► 回到 Phase 3 (Reviewer) │
│ │
│ ┌─────────────────────────────────────────┐ │
│ │ Phase 5: 完成 │ │
│ │ - 输出最终 PRD 路径 │ │
│ │ - 输出准出证书或遗留问题 │ │
│ │ - 更新 workflow/status.md │ │
│ └─────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
首先判断输入类型：
使用 AskUserQuestion 确认：
questions:
- question: "输入类型是什么？"
header: "输入类型"
multiSelect: false
options:
- label: "BRD 文件"
description: "我有 BRD 文档，需要转换为 PRD"
- label: "需求描述"
description: "我直接描述需求，生成 PRD"
- question: "这个 PRD 属于什么类型？"
header: "PRD 类型"
multiSelect: false
options:
- label: "新功能（有 UI）"
description: "涉及用户界面的新功能"
- label: "新功能（无 UI / 后端）"
description: "后端服务、API、后台任务"
- label: "第三方集成"
description: "接入外部服务"
- label: "功能重构"
description: "不改变外部功能的内部重构"
如果用户提供了 BRD 文件，必须先评估是否需要拆分：
Task:
description: "BRD 拆分评估"
subagent_type: "general-purpose"
prompt: |
你是 BRD 拆分评估专家。请按照以下步骤工作：
## 第一步：读取 BRD
读取 BRD 文件：{brd_path}
## 第二步：检测拆分信号
检查以下硬信号（出现任一即建议拆分）：
- 独立业务价值：各部分有独立的 ROI 评估
- 不同用户群体：面向完全不同的用户角色
- 可独立验收与价值实现：各部分可独立交付并产生价值
- 不同合规域：涉及不同法规/审批流程
- 独立成功指标：KPI 完全不同
- 独立 GTM 策略：需要不同的市场/销售方案
检查反模式（不应拆分）：
- 紧耦合用户旅程
- 共享成功指标
- 强依赖需协同发布
## 第三步：输出评估报告
保存到 workflow/brd-split-assessment.md：
```markdown
# BRD 拆分评估报告
## BRD 信息
- **文件路径**：{brd_path}
- **评估时间**：YYYY-MM-DD HH:MM
## 硬信号检测
| 信号 | 是否存在 | 证据 |
|------|----------|------|
| 独立业务价值 | ✅/❌ | [说明] |
| 不同用户群体 | ✅/❌ | [说明] |
| ... | ... | ... |
## 反模式检测
| 反模式 | 是否存在 | 说明 |
|--------|----------|------|
| 紧耦合用户旅程 | ✅/❌ | [说明] |
| ... | ... | ... |
## 拆分建议
- **建议**：拆分/不拆分
- **拆分方案**（如建议拆分）：
1. PRD-1: [范围]
2. PRD-2: [范围]
...
## BRD 需求清单
| # | 需求项 | 建议分配到 |
|---|--------|-----------|
| 1 | [需求] | PRD-1 |
| 2 | [需求] | PRD-2 |
...
```
完成后输出："[SPLIT-ASSESSMENT-COMPLETE]"
评估完成后，使用 AskUserQuestion 让用户确认拆分方案：
questions:
- question: "根据 BRD 分析，建议拆分为 N 个 PRD。是否同意此方案？"
header: "拆分确认"
multiSelect: false
options:
- label: "同意拆分方案"
description: "按建议拆分为多个 PRD"
- label: "调整拆分"
description: "我想调整拆分方式"
- label: "不拆分"
description: "合并为单个 PRD"
mkdir -p workflow/
创建 workflow/status.md：
# PRD Studio 状态
## 基本信息
- **需求描述**：[用户输入]
- **PRD 类型**：[用户选择]
- **开始时间**：YYYY-MM-DD HH:MM
- **当前状态**：进行中
## 迭代记录
| 轮次 | 阶段 | 时间 | 结果 |
|------|------|------|------|
| 1 | Writer | - | - |
当用户确认需要将 BRD 拆分为多个 PRD 时，工作流调整为：
┌─────────────────────────────────────────────────────────────────┐
│ 1:N PRD Studio 工作流 │
├─────────────────────────────────────────────────────────────────┤
│ │
│ BRD 拆分评估完成，确认拆分为 N 个 PRD │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ Phase 1.5: 创建 PRD 索引文档 │ │
│ │ - 生成 workflow/PRD-INDEX-{brd}.md │ │
│ │ - 初始化 BRD 需求覆盖矩阵 │ │
│ │ - 记录拆分决策 │ │
│ └─────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ Phase 2-5: 循环处理每个 PRD │ │
│ │ │ │
│ │ for PRD in [PRD-1, PRD-2, ..., PRD-N]: │ │
│ │ ├─ Writer(round=1) → prd-{n}.md │ │
│ │ ├─ Reviewer → AGENT-RESULT │ │
│ │ ├─ [循环] Writer(round+1) + Reviewer │ │
│ │ └─ 单个 PRD 准出 │ │
│ │ │ │
│ └─────────────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌─────────────────────────────────────────┐ │
│ │ Phase 6: 覆盖率验证 │ │
│ │ - 检查 BRD 需求 100% 覆盖 │ │
│ │ - 更新索引文档状态 │ │
│ │ - 输出整体准出证书 │ │
│ └─────────────────────────────────────────┘ │
│ │
└─────────────────────────────────────────────────────────────────┘
Task:
description: "创建 PRD 索引文档"
subagent_type: "general-purpose"
prompt: |
根据拆分评估报告，创建 PRD 索引文档。
## 读取拆分评估
读取 workflow/brd-split-assessment.md
## 创建索引文档
保存到 workflow/PRD-INDEX-{brd_name}.md：
```markdown
# PRD 索引：{BRD 名称}
## 基本信息
| 项目 | 内容 |
|------|------|
| BRD 来源 | {brd_path} |
| 拆分方式 | {split_method} |
| PRD 数量 | N 个 |
| 创建时间 | YYYY-MM-DD |
## PRD 清单
| PRD | 名称 | 范围 | 状态 | 文件路径 |
|-----|------|------|------|----------|
| PRD-1 | [名称] | [范围] | 待编写 | workflow/prd-1.md |
| PRD-2 | [名称] | [范围] | 待编写 | workflow/prd-2.md |
| ... | ... | ... | ... | ... |
## BRD 需求覆盖矩阵
| # | BRD 需求项 | 分配到 PRD | 覆盖状态 |
|---|------------|-----------|----------|
| 1 | [需求] | PRD-1 | ⏳ 待覆盖 |
| 2 | [需求] | PRD-2 | ⏳ 待覆盖 |
...
**覆盖率**：0 / {total} = 0%
## 拆分决策记录
- **拆分原因**：[硬信号列表]
- **拆分时间**：YYYY-MM-DD
- **确认方式**：用户确认
```
完成后输出："[INDEX-CREATED] 索引文档已创建"
对于每个 PRD，执行标准的 Phase 2-5 流程，但需要：
Writer Subagent 额外指令：
workflow/prd-{n}.mdReviewer Subagent 额外检查：
每个 PRD 准出后：
所有 PRD 完成后，执行最终验证：
Task:
description: "PRD 覆盖率验证"
subagent_type: "general-purpose"
prompt: |
验证 BRD 需求是否 100% 被覆盖。
## 读取索引文档
读取 workflow/PRD-INDEX-{brd_name}.md
## 验证覆盖率
- 检查每个 BRD 需求是否都有对应的 PRD 覆盖
- 计算覆盖率 = 已覆盖需求 / 总需求
## 输出验证结果
保存到 workflow/coverage-verification.md
如果覆盖率 < 100%：
- 列出未覆盖的需求
- 标记为 P0 阻塞
如果覆盖率 = 100%：
- 更新索引文档覆盖率为 100%
- 输出整体准出证书
完成后输出："[COVERAGE-VERIFIED] 覆盖率验证完成"
workflow/
├── status.md # 整体状态
├── brd-split-assessment.md # BRD 拆分评估报告
├── PRD-INDEX-{brd}.md # PRD 索引文档
├── prd-1.md # PRD-1
├── prd-1-review-report.md # PRD-1 审查报告
├── prd-2.md # PRD-2
├── prd-2-review-report.md # PRD-2 审查报告
├── ...
└── coverage-verification.md # 覆盖率验证报告
读取 subagents/writer.md 模板，将 {requirement}、{prd_type}、{round} 替换为实际值，通过 Task tool 启动隔离的 Writer subagent。
首次写作（round=1）：Writer 生成 PRD 初稿并保存到 workflow/prd.md。
修订轮次（round>1）：Writer 同时读取 workflow/review-report.md，按优先级修复问题后覆盖保存。
结果解析：从 subagent 输出中提取 AGENT-RESULT 块（详见 references/orchestrator-rules.md「结果解析」段）。
| AGENT-RESULT status | Orchestrator 行为 |
|---|---|
success | 进入 Phase 3 |
needs_input | 暂停，通过 AskUserQuestion 转达 blocking_issues |
failed + needs_retry | 重试一次 |
failed + !needs_retry | 报告用户 |
| 块缺失 | 重试一次（强调输出要求），二次缺失 → 报告用户 |
读取 subagents/reviewer.md 模板，将 {round} 替换为实际值，通过 Task tool 启动隔离的 Reviewer subagent。
结果解析：从 AGENT-RESULT 块提取 verdict、p0_count、p1_count。
基于 Reviewer 的 AGENT-RESULT 块判定（不再从 review-report.md 自由文本中解析）：
verdict: pass（即 P0=0 且 P1<2）→ 进入 Phase 5
verdict: fail（P0>0 或 P1>=2）→ 检查迭代次数：
不再单独派发 Fixer subagent。Writer 在 round>1 时自动读取 review-report 并修复。
输出准出证书：
# ✅ PRD 准出证书
## 基本信息
- **PRD 文件**：workflow/prd.md
- **准出时间**：YYYY-MM-DD HH:MM
- **总迭代轮次**：N 轮
## 审查历程
| 轮次 | 结果 | P0 | P1 | P2 |
|------|------|----|----|----|
| 1 | 需修改 | 2 | 3 | 5 |
| 2 | 需修改 | 0 | 2 | 3 |
| 3 | 通过 | 0 | 1 | 2 |
## 遗留建议（P2）
[列出未处理的 P2 建议]
---
**PRD 已准出，可进入 HLD 阶段。**
输出遗留问题报告：
# ⚠️ PRD 迭代完成（有遗留问题）
## 基本信息
- **PRD 文件**：workflow/prd.md
- **完成时间**：YYYY-MM-DD HH:MM
- **总迭代轮次**：3 轮（已达上限）
## 遗留问题
### P0 阻塞问题
[如果有]
### P1 严重问题
[如果有]
## 建议
1. 人工介入处理遗留的 P0/P1 问题
2. 处理完成后可使用 /prd-reviewer 单独审查
更新 workflow/status.md 为完成状态。
工作流程中产生的文件：
workflow/
├── status.md # 状态跟踪
├── prd.md # PRD 文件（不断更新）
└── review-report.md # 最新的审查报告
用户: /prd-studio 我想做一个用户积分系统，用户可以通过购买、签到获得积分，用积分兑换优惠券
[Phase 1] 初始化
→ 确认 PRD 类型：新功能（有 UI）
→ 创建 workflow/ 目录
→ 初始化 status.md
[Phase 2] Writer Subagent (round=1)
→ 读取 subagents/writer.md 模板
→ 生成 PRD → workflow/prd.md
→ AGENT-RESULT: status=success
[Phase 3] Reviewer Subagent (round=1)
→ 读取 subagents/reviewer.md 模板
→ 审查 workflow/prd.md
→ AGENT-RESULT: verdict=fail, p0=1, p1=2
[Phase 4] 结果判断
→ verdict=fail，迭代=1 < 3，继续
[Phase 2] Writer Subagent (round=2，读取 review-report 修复)
→ 修复 P0 + P1 问题
→ 保存修改后的 PRD
→ AGENT-RESULT: status=success
[Phase 3] Reviewer Subagent (round=2)
→ 审查修改后的 PRD
→ AGENT-RESULT: verdict=pass, p0=0, p1=1
[Phase 4] 结果判断
→ verdict=pass，准出通过！
[Phase 5] 完成
→ 输出准出证书
→ 更新 status.md
AGENT-RESULT 块（详见 subagents/*.md 和 references/orchestrator-rules.md）。Orchestrator 只从该块做流转判定，不解析自由文本status=failed → 按 needs_retry 决定重试或报告用户（详见 orchestrator-rules.md）npx claudepluginhub testany-io/testany-agent-skills --plugin testany-engWrites Product Requirements Documents (PRDs) for new features (with/without UI), third-party integrations, feature refactoring, and performance/security optimizations. Scans project docs for consistency and embeds traceability metadata.
Creates a Product Requirements Document (PRD) from an upstream BRD, defining product features, personas, success metrics, and acceptance criteria at the C4 Container level. Use after BRD exists and before EARS.
Generates Chinese PRD documents (full, brief, or one-page) via guided interviews, templates, validation, and AI-agent optimizations. Saves to docs/prd dirs.