writing-prds

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Writing PRDs

编写PRD

Workflows

工作流程

  • Define Goals: Articulate business goals and success metrics
  • Identify Stakeholders: List all relevant stakeholders
  • Draft User Stories: Capture user needs
  • Detail Requirements: List functional and non-functional requirements
  • Save Artifact: Save to
    ./artifacts/prd_[feature].md
  • Review: Conduct stakeholder review
  • 明确目标:阐述业务目标与成功指标
  • 识别干系人:列出所有相关干系人
  • 草拟用户故事:捕捉用户需求
  • 细化需求:列出功能性与非功能性需求
  • 保存成果物:保存至
    ./artifacts/prd_[feature].md
  • 评审:组织干系人评审

PRD Structure

PRD结构

  1. Overview: What and why
  2. Goals & Success Metrics: How we measure success
  3. User Stories: Who benefits and how
  4. Requirements: What must be built
  5. Out of Scope: What we're NOT building
  6. Timeline: Key milestones
  1. 概述:内容与目的
  2. 目标与成功指标:如何衡量成功
  3. 用户故事:受益人群及受益方式
  4. 需求说明:必须实现的内容
  5. 范围外内容:我们不会开发的内容
  6. 时间线:关键里程碑

User Story Format

用户故事格式

As a [role],
I want [feature],
So that [benefit].
As a [role],
I want [feature],
So that [benefit].

Example

示例

As a registered user,
I want to reset my password via email,
So that I can regain access to my account if I forget it.
As a registered user,
I want to reset my password via email,
So that I can regain access to my account if I forget it.

Acceptance Criteria

验收标准

Use Given/When/Then format:
Given I am on the login page
When I click "Forgot Password"
Then I see a form to enter my email

Given I enter a valid registered email
When I submit the form
Then I receive a password reset email within 5 minutes
采用Given/When/Then格式:
Given I am on the login page
When I click "Forgot Password"
Then I see a form to enter my email

Given I enter a valid registered email
When I submit the form
Then I receive a password reset email within 5 minutes

INVEST Criteria

INVEST原则

Good user stories are:
  • Independent: Can be developed separately
  • Negotiable: Details can be discussed
  • Valuable: Delivers user value
  • Estimable: Can be sized
  • Small: Fits in a sprint
  • Testable: Has clear acceptance criteria
优质的用户故事需满足:
  • Independent(独立的):可独立开发
  • Negotiable(可协商的):细节可讨论确定
  • Valuable(有价值的):为用户传递价值
  • Estimable(可估算的):可评估开发规模
  • Small(体量小的):可在一个迭代周期内完成
  • Testable(可测试的):具备明确的验收标准

Resources

资源

  • PRD Template
  • PRD模板