write-prd

PRD — 产品需求文档

将产品愿景和研究成果转化为清晰、可执行的工程规范。生成遵循 8 个章节结构的 PRD-[product-name].md 输出文件。

输出文件命名： PRD-[product-name].md（例如：PRD-sso-invite-flow.md）

参数解析

PRODUCT = "$ARGUMENTS"  # Product name or feature, e.g., "SSO invite flow"

步骤 0：明确范围

AskUserQuestion(
  questions=[{
    "question": "What type of PRD?",
    "header": "PRD Scope",
    "options": [
      {"label": "Full PRD (Recommended)", "description": "All 8 sections with research, stories, and release plan"},
      {"label": "Lightweight spec", "description": "Summary, objectives, user stories only"},
      {"label": "User stories only", "description": "INVEST stories with acceptance criteria"},
      {"label": "Update existing PRD", "description": "I have a PRD file to iterate on"}
    ],
    "multiSelect": false
  }]
)

任务管理

# 1. Create main task IMMEDIATELY
TaskCreate(subject="Write PRD: {PRODUCT}", description="8-section PRD with user stories and acceptance criteria", activeForm="Writing PRD for {PRODUCT}")

# 2. Create subtasks for each phase
TaskCreate(subject="Scope clarification", activeForm="Clarifying PRD scope")                       # id=2
TaskCreate(subject="Research and memory check", activeForm="Researching prior PRDs")               # id=3
TaskCreate(subject="Draft 8-section PRD", activeForm="Drafting PRD sections")                      # id=4
TaskCreate(subject="Write user stories and acceptance criteria", activeForm="Writing user stories") # id=5
TaskCreate(subject="Write output file", activeForm="Writing PRD file")                             # id=6

# 3. Set dependencies for sequential phases
TaskUpdate(taskId="3", addBlockedBy=["2"])  # Research needs scope first
TaskUpdate(taskId="4", addBlockedBy=["3"])  # Drafting needs research context
TaskUpdate(taskId="5", addBlockedBy=["4"])  # Stories need draft structure
TaskUpdate(taskId="6", addBlockedBy=["5"])  # Output needs all sections done

# 4. Update status as you progress
TaskUpdate(taskId="2", status="in_progress")  # When starting
TaskUpdate(taskId="2", status="completed")    # When done — repeat for each subtask

记忆集成

# Search for prior PRDs and product decisions
mcp__memory__search_nodes(query="{PRODUCT} PRD requirements")

# After PRD is written, store key decisions
mcp__memory__create_entities(entities=[{
  "name": "PRD-{product-slug}",
  "entityType": "document",
  "observations": ["PRD written for {PRODUCT}", "Key objectives: ..."]
}])

PRD 的 8 个章节模板

加载 Read("references/prd-template.md")，查看包含全部 8 个章节（摘要、联系人、背景、目标、市场细分、价值主张、解决方案、发布）、优先级和 NFR 类别的完整模板。

用户故事与验收标准

加载 Read("references/user-stories-guide.md")，查看 INVEST 标准、故事格式、Gherkin 验收标准，以及就绪定义／完成定义。

价值主张画布

加载 Read("references/value-prop-canvas-guide.md")，查看画布模板和契合度检查流程。每个价值图谱项目都必须对应一项任务、痛点或收益。

继续／终止门槛标准

从规则中加载：Read("rules/strategy-go-no-go.md")，查看阶段门槛标准和评分阈值（继续 >= 7.0 | 有条件继续 5.0-6.9 | 终止 < 5.0）。

规则（按需加载）

• research-requirements-prd.md — INVEST 用户故事、PRD 模板、优先级、DoR/DoD
• strategy-value-prop.md — 价值主张画布、JTBD 框架、契合度评估
• strategy-go-no-go.md — 阶段门槛标准、评分、构建／购买／合作决策矩阵

参考资料

• output-templates.md — PRD、商业案例和战略制品的结构化 JSON 输出架构
• value-prop-canvas-guide.md — 详细的价值主张画布引导指南

输出

生成 PRD 后，将其写入磁盘：

Write(f"PRD-{product_slug}.md", prd_content)
TaskUpdate(status="completed")

计划模式文件名（CC 2.1.111+）： 如果此技能在写入 PRD 前进入计划模式（通过 EnterPlanMode），CC 2.1.111 会使用提示词主体而非随机词语为生成的计划文件命名。若要获得简洁的文件名，请在计划模式提示词中加入产品标识（例如 EnterPlanMode("PRD: authentication-rework") → plans/prd-authentication-rework.md）。在 2.1.111 之前，计划文件名为 plans/swift-cobra.md 等——请根据需要检查并重命名。

链接：后续步骤

PRD 获批后，将其验收标准分解为可运行目标，然后开始实施：

prd-to-goal PRD-{product-slug}.md   # → one copy-pasteable `/goal until …, or stop after N turns` line
implement PRD-{product-slug}.md

prd-to-goal 会将下方的继续／终止门槛和验收标准归纳为单个以 AND 连接的布尔断言，使 PRD 能驱动自主 /goal 运行，而无需手动通读。

相关技能

• ork:user-research — 在编写 PRD 前，加深对用户的理解（用户画像、旅程地图、访谈）
• ork:prd-to-goal — 将此 PRD 的验收标准归纳为一行 /goal until …, or stop after N turns
• ork:implement — 执行 PRD 中的实施计划
• ork:brainstorm — 在确定 PRD 范围前，探索备选方案
• ork:assess — 评估 PRD 的质量和完整性

---

版本： 2.0.0