AgentSkillsCN

generating-interactive-userstory-md

通过互动问答,根据用户输入生成UserStory.md文档。当用户希望创建用户故事文档,或启动辅助工作流时使用。

SKILL.md
--- frontmatter
name: generating-interactive-userstory-md
description: Interactive Q&A to build UserStory.md from user input. Use when the user wants to create a user story document or start the assisted workflow.
compatibility: Designed for Claude Code
metadata:
  disable-model-invocation: true
  allowed-tools: AskUserQuestion, Read, Write, WebFetch, WebSearch

User Story Builder

Interactively builds docs/UserStory.md through structured Q&A with the user.

Purpose

Guides users through creating a user story document that can be transformed into PRD.md using the generating-prd-md-from-userstory-md skill.

Workflow

  1. Check for existing UserStory.md

    • If exists, ask user if they want to rebuild (backup as docs/UserStory.md.bak)
  2. Ask structured questions using AskUserQuestion tool for each template section:

    • Project name
    • Problem statement
    • Target users
    • Value proposition
    • User stories (use "As a [role], I want to [action] so that [benefit]" format)
    • Success criteria
    • Constraints
    • Out of scope
  3. Generate UserStory.md

    • Read template from ralph/docs/templates/userstory.md.template
    • Replace placeholders with user responses
    • Write to docs/UserStory.md
  4. Suggest next step: make ralph_prd_md to generate PRD.md

Template

See ralph/docs/templates/userstory.md.template for structure and placeholders.

Usage

bash
make ralph_userstory