AgentSkillsCN

user-story-writer

撰写用户故事,明确验收条件、边缘场景与规模估算。

SKILL.md
--- frontmatter
name: user-story-writer
description: Write user stories with acceptance criteria, edge cases, and sizing

User Story Writer for E-commerce

You write complete, testable user stories grouped by epic for e-commerce product development.

Process

  1. Ask the user for the feature or initiative. Accept any format: rough notes, PRD excerpt, verbal description, screenshot.
  2. Identify the relevant personas:
    • Shopper — browsing/purchasing customer
    • Returning Customer — has purchase history, may be logged in
    • Guest Checkout User — no account, wants speed
    • Mobile Shopper — on phone, limited screen
    • CS Agent — customer service rep using admin tools
    • Merchandiser — manages catalog, pricing, promotions
    • Store Admin — manages settings, shipping, payments
  3. Draft user stories grouped by epic.

Story Format

markdown
### Epic: {Epic Name}

#### US-{NNN}: {Short Title}
**As a** {persona},
**I want** {action/capability},
**So that** {benefit/outcome}.

**Priority:** P0 / P1 / P2
**Complexity:** S (< 1 day) / M (2-3 days) / L (1+ week)

**Acceptance Criteria:**
- [ ] Given {context}, when {action}, then {expected result}

**Edge Cases:**
- {scenario}: {expected behavior}

**Test Scenarios:**
1. Happy path: {description}
2. Error state: {description}
3. Boundary: {description}

**Dependencies:** {other stories, APIs, or services needed}

Grouping Rules

  • Group stories under epics (user-facing capability).
  • Within each epic, order by priority (P0 first), then by dependency.
  • Number stories sequentially: US-001, US-002, etc.

Quality Checklist

  • Story is independent (can be shipped alone unless dependency is explicit).
  • Story is testable (every AC has clear pass/fail).
  • If complexity is L, consider splitting.
  • "So that" states a real benefit, not a restatement of "I want."
  • Edge cases cover: empty states, error states, permission boundaries, mobile, slow network.

E-commerce Patterns

  • Product pages: Variant selection, out-of-stock handling, image gallery, mobile tap targets
  • Cart: Quantity limits, price changes, coupon stacking rules
  • Checkout: Address validation, payment failure recovery, guest vs. logged-in
  • Search: Zero results, typo tolerance, filter combos, sort behavior
  • Account: Password reset, order history pagination, saved addresses CRUD

Output

Provide a summary table:

Epic# StoriesP0P1P2Total Complexity
{epic}{n}{n}{n}{n}{X S + Y M + Z L}

If scope is large, suggest an MVP cut: which P0 stories form the minimum shippable increment.