Back to Details

write-prd

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

PRD — Product Requirements Document

PRD — 产品需求文档

Translate product vision and research into clear, actionable engineering specifications. Produces 
PRD-[product-name].md
output files following an 8-section structure.
Output file naming: 
PRD-[product-name].md
(e.g., 
PRD-sso-invite-flow.md
)
将产品愿景和研究成果转化为清晰、可落地的工程规范。生成遵循8部分结构的
PRD-[product-name].md
输出文件。
输出文件命名规则： 
PRD-[product-name].md
（例如：
PRD-sso-invite-flow.md
）

Argument Resolution

参数解析

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

STEP 0: Scope Clarification

步骤0：范围澄清

python
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", "markdown": "```\nFull PRD (8 sections)\n─────────────────────\n1. Executive Summary\n2. Problem Statement\n3. Objectives & KPIs\n4. User Stories (INVEST)\n5. Functional Requirements\n6. Non-Functional Requirements\n7. Release Plan\n8. Appendices\n```"},
      {"label": "Lightweight spec", "description": "Summary, objectives, user stories only", "markdown": "```\nLightweight Spec\n────────────────\n1. Summary (1 paragraph)\n2. Objectives (3-5 bullets)\n3. User Stories\n\nBest for: internal tools,\nsmall features, quick specs\n```"},
      {"label": "User stories only", "description": "INVEST stories with acceptance criteria", "markdown": "```\nUser Stories Only\n─────────────────\nAs a [role], I want [goal]\nso that [benefit].\n\nAcceptance Criteria:\nGiven... When... Then...\n\nINVEST: Independent,\nNegotiable, Valuable,\nEstimable, Small, Testable\n```"},
      {"label": "Update existing PRD", "description": "I have a PRD file to iterate on", "markdown": "```\nUpdate Existing PRD\n───────────────────\n→ Read current PRD file\n→ Identify gaps/changes\n→ Preserve approved sections\n→ Track change history\n```"}
    ],
    "multiSelect": false
  }]
)
python
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", "markdown": "```\nFull PRD (8 sections)\n─────────────────────\n1. Executive Summary\n2. Problem Statement\n3. Objectives & KPIs\n4. User Stories (INVEST)\n5. Functional Requirements\n6. Non-Functional Requirements\n7. Release Plan\n8. Appendices\n```"},
      {"label": "Lightweight spec", "description": "Summary, objectives, user stories only", "markdown": "```\nLightweight Spec\n────────────────\n1. Summary (1 paragraph)\n2. Objectives (3-5 bullets)\n3. User Stories\n\nBest for: internal tools,\nsmall features, quick specs\n```"},
      {"label": "User stories only", "description": "INVEST stories with acceptance criteria", "markdown": "```\nUser Stories Only\n─────────────────\nAs a [role], I want [goal]\nso that [benefit].\n\nAcceptance Criteria:\nGiven... When... Then...\n\nINVEST: Independent,\nNegotiable, Valuable,\nEstimable, Small, Testable\n```"},
      {"label": "Update existing PRD", "description": "I have a PRD file to iterate on", "markdown": "```\nUpdate Existing PRD\n───────────────────\n→ Read current PRD file\n→ Identify gaps/changes\n→ Preserve approved sections\n→ Track change history\n```"}
    ],
    "multiSelect": false
  }]
)

Task Management

任务管理

python
TaskCreate(
  subject="Write PRD: {PRODUCT}",
  description="8-section PRD with user stories and acceptance criteria",
  activeForm="Writing PRD for {PRODUCT}"
)
python
TaskCreate(
  subject="Write PRD: {PRODUCT}",
  description="8-section PRD with user stories and acceptance criteria",
  activeForm="Writing PRD for {PRODUCT}"
)

Memory Integration

记忆集成

python
undefined
python
undefined

Search for prior PRDs and product decisions

Search for prior PRDs and product decisions

mcp__memory__search_nodes(query="{PRODUCT} PRD requirements")
mcp__memory__search_nodes(query="{PRODUCT} PRD requirements")

After PRD is written, store key decisions

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: ..."] }])
undefined
mcp__memory__create_entities(entities=[{ "name": "PRD-{product-slug}", "entityType": "document", "observations": ["PRD written for {PRODUCT}", "Key objectives: ..."] }])
undefined

The 8-Section PRD Template

8-section PRD模板

Load 
Read("${CLAUDE_SKILL_DIR}/references/prd-template.md")
for the full template with all 8 sections (Summary, Contacts, Background, Objective, Market Segments, Value Propositions, Solution, Release), priority levels, and NFR categories.
加载
Read("${CLAUDE_SKILL_DIR}/references/prd-template.md")
获取包含全部8个章节（摘要、联系人、背景、目标、细分市场、价值主张、解决方案、发布）、优先级等级以及非功能需求（NFR）类别的完整模板。

User Stories & Acceptance Criteria

用户故事与验收标准

Load 
Read("${CLAUDE_SKILL_DIR}/references/user-stories-guide.md")
for INVEST criteria, story format, Gherkin acceptance criteria, and Definition of Ready/Done.
加载
Read("${CLAUDE_SKILL_DIR}/references/user-stories-guide.md")
获取INVEST准则、故事格式、Gherkin验收标准以及就绪/完成定义（Definition of Ready/Done）。

Value Proposition Canvas

价值主张画布

Load 
Read("${CLAUDE_SKILL_DIR}/references/value-prop-canvas-guide.md")
for the canvas template and fit check process. Every Value Map item must correspond to a Job, Pain, or Gain.
加载
Read("${CLAUDE_SKILL_DIR}/references/value-prop-canvas-guide.md")
获取画布模板和适配检查流程。每个价值映射项必须对应一个用户任务、痛点或收益。

Go/No-Go Gate Criteria

上线/不上线评审门准则

Load from rules: 
Read("${CLAUDE_SKILL_DIR}/rules/strategy-go-no-go.md")
for stage gate criteria and scoring thresholds (Go >= 7.0 | Conditional 5.0-6.9 | No-Go < 5.0).
从规则文件加载：
Read("${CLAUDE_SKILL_DIR}/rules/strategy-go-no-go.md")
获取阶段评审门准则和评分阈值（上线 ≥7.0 | 有条件上线 5.0-6.9 | 不上线 <5.0）。

Rules (Load On-Demand)

规则（按需加载）

  • research-requirements-prd.md — INVEST user stories, PRD template, priority levels, DoR/DoD
  • strategy-value-prop.md — Value proposition canvas, JTBD framework, fit assessment
  • strategy-go-no-go.md — Stage gate criteria, scoring, build/buy/partner decision matrix
  • research-requirements-prd.md — INVEST用户故事、PRD模板、优先级等级、DoR/DoD
  • strategy-value-prop.md — 价值主张画布、JTBD框架、适配评估
  • strategy-go-no-go.md — 阶段评审门准则、评分、自研/采购/合作决策矩阵

References

参考资料

  • output-templates.md — Structured JSON output schemas for PRD, business case, and strategy artifacts
  • value-prop-canvas-guide.md — Detailed value proposition canvas facilitation guide
  • output-templates.md — PRD、商业案例和战略工件的结构化JSON输出 schema
  • value-prop-canvas-guide.md — 详细的价值主张画布引导指南

Output

输出

After generating the PRD, write it to disk:
python
Write(f"PRD-{product_slug}.md", prd_content)
TaskUpdate(status="completed")
生成PRD后，将其写入磁盘：
python
Write(f"PRD-{product_slug}.md", prd_content)
TaskUpdate(status="completed")

Chain: Next Steps

流程链：后续步骤

After PRD is approved, chain into implementation:
/ork:implement PRD-{product-slug}.md
PRD获批后，进入实施流程链：
/ork:implement PRD-{product-slug}.md

Related Skills

相关技能

  • ork:user-research
    — Build user understanding (personas, journey maps, interviews) before writing the PRD
  • ork:implement
    — Execute the implementation plan from the PRD
  • ork:brainstorm
    — Explore solution alternatives before committing to PRD scope
  • ork:assess
    — Rate PRD quality and completeness
Version: 2.0.0
  • ork:user-research
    — 编写PRD前构建用户认知（用户画像、旅程地图、访谈）
  • ork:implement
    — 根据PRD执行实施计划
  • ork:brainstorm
    — 在确定PRD范围前探索解决方案的替代方案
  • ork:assess
    — 评估PRD的质量和完整性
版本： 2.0.0